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/
|
||
|
||
|
||
═══════════════════════════════════════════════════════════════
|
||
祝您打包顺利！🎉
|
||
═══════════════════════════════════════════════════════════════
|