272 lines
10 KiB
Plaintext
272 lines
10 KiB
Plaintext
═══════════════════════════════════════════════════════════════
|
||
HBuilderX 云打包详细步骤（解决您的问题）
|
||
═══════════════════════════════════════════════════════════════
|
||
|
||
【问题分析】
|
||
|
||
从您的截图中发现：
|
||
1. ✓ 您已经在使用 HBuilderX
|
||
2. ✓ 您已经打开了云打包界面
|
||
3. ❌ 但是选择了"打正式包"而没有配置证书
|
||
4. ❌ AppID 可能不一致
|
||
|
||
【正确的打包步骤】
|
||
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 步骤 1：检查 AppID │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
|
||
1. 在 HBuilderX 中，打开文件：
|
||
src/manifest.json
|
||
|
||
2. 查看 "appid" 字段，应该是：
|
||
"__UNI__71560C7"
|
||
|
||
3. 如果不是，需要重新获取 AppID：
|
||
- 在 manifest.json 文件中
|
||
- 点击"重新获取"按钮
|
||
- 或者访问：https://dev.dcloud.net.cn/
|
||
|
||
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 步骤 2：使用 DCloud 公共测试证书（推荐） │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
|
||
⚠️ 重要：不要选择"打正式包"！
|
||
|
||
正确的操作：
|
||
|
||
1. 在 HBuilderX 菜单栏，点击：
|
||
发行 → 原生App-云打包
|
||
|
||
2. 在弹出的对话框中：
|
||
|
||
【平台选择】
|
||
☑ Android (apk)
|
||
☐ iOS (ipa) - 暂时不勾选
|
||
|
||
【Android 打包】
|
||
◉ 使用 DCloud 公共测试证书 ← 选择这个！
|
||
○ 使用自有证书 ← 不要选这个
|
||
|
||
【打包类型】
|
||
○ 打正式包 ← 不要选这个
|
||
◉ 打测试包 ← 选择这个（或者不管）
|
||
|
||
3. 其他选项保持默认
|
||
|
||
4. 点击"打包"按钮
|
||
|
||
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 步骤 3：登录 DCloud 账号 │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
|
||
如果是首次使用，会提示登录：
|
||
|
||
1. 如果已有账号：
|
||
- 输入账号密码
|
||
- 点击登录
|
||
|
||
2. 如果没有账号：
|
||
- 点击"注册"
|
||
- 填写邮箱和密码
|
||
- 完成注册（免费）
|
||
|
||
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 步骤 4：等待打包完成 │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
|
||
1. 打包开始后，在 HBuilderX 底部的"控制台"可以看到进度
|
||
|
||
2. 打包过程大约需要 5-10 分钟
|
||
|
||
3. 控制台会显示类似信息：
|
||
[HBuilder] 正在打包...
|
||
[HBuilder] 打包成功
|
||
[HBuilder] 下载地址：https://...
|
||
|
||
4. 等待出现"打包成功"的提示
|
||
|
||
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 步骤 5：下载 APK │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
|
||
1. 打包成功后，会弹出下载链接
|
||
|
||
2. 点击链接，或者复制到浏览器打开
|
||
|
||
3. 下载 APK 文件到电脑
|
||
|
||
4. 将 APK 传输到 Android 手机（可以用微信、QQ、数据线等）
|
||
|
||
5. 在手机上安装 APK
|
||
|
||
6. 打开应用测试
|
||
|
||
|
||
═══════════════════════════════════════════════════════════════
|
||
常见错误和解决方法
|
||
═══════════════════════════════════════════════════════════════
|
||
|
||
【错误 1】选择了"打正式包"但没有证书
|
||
|
||
症状：
|
||
- 勾选了"打正式包"
|
||
- 但是没有配置证书
|
||
- 打包失败或无法继续
|
||
|
||
解决：
|
||
✓ 改为选择"使用 DCloud 公共测试证书"
|
||
✓ 不要勾选"打正式包"
|
||
|
||
|
||
【错误 2】AppID 不一致
|
||
|
||
症状：
|
||
- 打包界面显示的 AppID 和 manifest.json 中的不一致
|
||
- 例如：界面显示 __UNI__08E0C13，但文件中是 __UNI__71560C7
|
||
|
||
解决：
|
||
方法 1：重新打开项目
|
||
1. 关闭 HBuilderX
|
||
2. 重新打开 HBuilderX
|
||
3. 重新打开项目文件夹
|
||
4. 再次尝试打包
|
||
|
||
方法 2：重新获取 AppID
|
||
1. 打开 src/manifest.json
|
||
2. 在 HBuilderX 的可视化界面中
|
||
3. 点击"重新获取"
|
||
4. 保存文件
|
||
5. 再次尝试打包
|
||
|
||
|
||
【错误 3】提示"未登录"或"账号异常"
|
||
|
||
解决：
|
||
1. 点击 HBuilderX 右上角的头像
|
||
2. 选择"登录"
|
||
3. 输入 DCloud 账号密码
|
||
4. 如果没有账号，先注册（免费）
|
||
|
||
|
||
【错误 4】打包失败，提示"网络错误"
|
||
|
||
解决：
|
||
1. 检查网络连接
|
||
2. 关闭 VPN 或代理
|
||
3. 稍后重试
|
||
4. 或者更换网络环境
|
||
|
||
|
||
【错误 5】打包成功但找不到 APK
|
||
|
||
解决：
|
||
1. 查看 HBuilderX 控制台的下载链接
|
||
2. 复制链接到浏览器下载
|
||
3. 或者在 HBuilderX 的"历史记录"中查找
|
||
4. 菜单：发行 → 查看云打包历史
|
||
|
||
|
||
═══════════════════════════════════════════════════════════════
|
||
完整的正确操作流程（图文说明）
|
||
═══════════════════════════════════════════════════════════════
|
||
|
||
第 1 步：打开云打包界面
|
||
菜单栏 → 发行 → 原生App-云打包
|
||
|
||
第 2 步：配置打包选项
|
||
┌─────────────────────────────────────┐
|
||
│ 应用名称：国语教育平台 │
|
||
│ 应用版本：1.0.0 │
|
||
│ │
|
||
│ ☑ Android (apk) │
|
||
│ ☐ iOS (ipa) │
|
||
│ │
|
||
│ Android 打包： │
|
||
│ ◉ 使用 DCloud 公共测试证书 ← 选这个 │
|
||
│ ○ 使用自有证书 │
|
||
│ │
|
||
│ [ 打包 ] │
|
||
└─────────────────────────────────────┘
|
||
|
||
第 3 步：等待打包
|
||
控制台显示：
|
||
[HBuilder] 正在打包...
|
||
[HBuilder] 编译中...
|
||
[HBuilder] 打包成功！
|
||
[HBuilder] 下载：https://...
|
||
|
||
第 4 步：下载并测试
|
||
点击下载链接 → 获得 APK → 安装测试
|
||
|
||
|
||
═══════════════════════════════════════════════════════════════
|
||
如果还是不行，请尝试以下方法
|
||
═══════════════════════════════════════════════════════════════
|
||
|
||
【方法 1】重新创建项目（不推荐，但有效）
|
||
|
||
1. 在 HBuilderX 中创建一个新的 uni-app 项目
|
||
2. 将当前项目的 src 目录内容复制到新项目
|
||
3. 在新项目中尝试打包
|
||
|
||
|
||
【方法 2】使用命令行 + HBuilderX 组合
|
||
|
||
1. 先用命令行编译：
|
||
npm run build:app
|
||
|
||
2. 然后在 HBuilderX 中：
|
||
发行 → 原生App-本地打包 → 生成本地打包App资源
|
||
|
||
3. 使用生成的资源进行云打包
|
||
|
||
|
||
【方法 3】检查 HBuilderX 版本
|
||
|
||
1. 确保使用最新版本的 HBuilderX
|
||
2. 菜单：帮助 → 检查更新
|
||
3. 如果有更新，先更新再打包
|
||
|
||
|
||
【方法 4】清理缓存
|
||
|
||
1. 关闭 HBuilderX
|
||
2. 删除项目中的 unpackage 目录
|
||
3. 重新打开 HBuilderX
|
||
4. 重新打包
|
||
|
||
|
||
═══════════════════════════════════════════════════════════════
|
||
关键点总结
|
||
═══════════════════════════════════════════════════════════════
|
||
|
||
✓ 使用"DCloud 公共测试证书"，不要选"打正式包"
|
||
✓ 确保已登录 DCloud 账号
|
||
✓ 确保网络连接正常
|
||
✓ 等待 5-10 分钟让云端完成打包
|
||
✓ 从控制台获取下载链接
|
||
|
||
❌ 不要选择"使用自有证书"（除非您已经有证书）
|
||
❌ 不要选择"打正式包"（测试阶段不需要）
|
||
❌ 不要在打包过程中关闭 HBuilderX
|
||
|
||
|
||
═══════════════════════════════════════════════════════════════
|
||
需要更多帮助？
|
||
═══════════════════════════════════════════════════════════════
|
||
|
||
如果按照以上步骤还是无法打包，请提供：
|
||
1. HBuilderX 控制台的完整错误信息
|
||
2. 打包界面的截图
|
||
3. manifest.json 中的 appid
|
||
|
||
这样我可以更准确地帮您解决问题。
|
||
|
||
|
||
祝您打包成功！🎉
|