═══════════════════════════════════════════════════════════════ 快速开始 - 5 分钟生成 APK ═══════════════════════════════════════════════════════════════ 【最快方法】使用 HBuilderX 云打包 ┌─────────────────────────────────────────────────────────────┐ │ 步骤 1:下载 HBuilderX │ └─────────────────────────────────────────────────────────────┘ 1. 打开浏览器,访问: https://www.dcloud.io/hbuilderx.html 2. 点击"下载 HBuilderX" 3. 选择"App 开发版"(标准版即可) 4. 下载完成后,解压到任意目录 5. 运行 HBuilderX.exe ⏱️ 耗时:5 分钟 ┌─────────────────────────────────────────────────────────────┐ │ 步骤 2:打开项目 │ └─────────────────────────────────────────────────────────────┘ 1. 在 HBuilderX 中,点击菜单栏: 文件 → 打开目录 2. 选择本项目文件夹: d:\Desktop\fronted_uniapp\fronted_uniapp 3. 等待项目加载完成 ⏱️ 耗时:1 分钟 ┌─────────────────────────────────────────────────────────────┐ │ 步骤 3:云端打包 │ └─────────────────────────────────────────────────────────────┘ 1. 在 HBuilderX 菜单栏,点击: 发行 → 原生App-云打包 2. 在弹出的对话框中: ☑ 勾选"Android" ☐ 不勾选"iOS"(除非有 Mac 和开发者账号) 3. 证书选择: 选择"使用 DCloud 公共测试证书" (仅用于测试,正式发布需要自己的证书) 4. 点击"打包"按钮 5. 首次使用需要登录 DCloud 账号 (没有账号的话,点击"注册",免费注册) 6. 等待打包完成(5-10 分钟) 可以在"控制台"看到打包进度 ⏱️ 耗时:10 分钟(包括等待) ┌─────────────────────────────────────────────────────────────┐ │ 步骤 4:下载 APK │ └─────────────────────────────────────────────────────────────┘ 1. 打包完成后,会弹出下载链接 2. 点击链接下载 APK 文件 3. 将 APK 传输到 Android 手机 4. 在手机上安装 APK 5. 打开应用测试 ⏱️ 耗时:2 分钟 ✅ 完成! ═══════════════════════════════════════════════════════════════ 总耗时:约 15-20 分钟 ═══════════════════════════════════════════════════════════════ 【注意事项】 ✓ 首次使用需要注册 DCloud 账号(免费) ✓ 公共测试证书只能用于测试,不能发布到应用商店 ✓ 云打包有每日次数限制(免费版足够日常使用) ✓ 如需正式发布,需要配置自己的签名证书 【常见问题】 Q: 为什么不能直接用 npm run build:app 生成 APK? A: 因为 uni-app 的 CLI 命令只编译代码,不生成安装包。 必须使用 HBuilderX 或离线 SDK 才能生成 APK。 Q: 可以不用 HBuilderX 吗? A: 可以,但需要配置 Android Studio 和离线 SDK, 过程复杂,不推荐新手使用。 Q: 云打包安全吗? A: 安全。DCloud 是 uni-app 的官方团队, 云打包服务已被数百万开发者使用。 Q: 如何生成 iOS 应用? A: 需要 Mac 电脑、Xcode、Apple 开发者账号($99/年) 和 iOS 证书。在云打包时勾选 iOS 即可。 【其他方式】 如果您想了解其他打包方式,请查看: 📖 README_BUILD.md - 完整的构建说明 📖 BUILD_GUIDE.md - 详细的打包指南 📖 打包流程图.txt - 可视化流程图 📖 问题解决方案.txt - 问题说明和解决方案 或运行辅助脚本: npm run build:app-help 【需要帮助?】 🌐 uni-app 官方文档:https://uniapp.dcloud.net.cn/ 🌐 DCloud 论坛:https://ask.dcloud.net.cn/ 🌐 HBuilderX 使用教程:https://hx.dcloud.net.cn/ ═══════════════════════════════════════════════════════════════ 祝您打包顺利!🎉 ═══════════════════════════════════════════════════════════════