140 lines
5.6 KiB
Plaintext
140 lines
5.6 KiB
Plaintext
|
═══════════════════════════════════════════════════════════════
|
|||
|
|
快速开始 - 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/
|
|||
|
|
|
|||
|
|
|
|||
|
|
═══════════════════════════════════════════════════════════════
|
|||
|
|
祝您打包顺利！🎉
|
|||
|
|
═══════════════════════════════════════════════════════════════
|