264 lines
8.9 KiB
Plaintext
264 lines
8.9 KiB
Plaintext
═══════════════════════════════════════════════════════════════
|
||
云打包问题诊断清单
|
||
═══════════════════════════════════════════════════════════════
|
||
|
||
【现象】
|
||
✓ 编译成功
|
||
✓ 没有报错
|
||
❌ 但是没有生成 APK
|
||
❌ 也没有任何提示或下载链接
|
||
|
||
|
||
【请逐一检查以下项目】
|
||
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
检查 1：是否已登录 DCloud 账号？（最重要！）
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
|
||
操作：
|
||
1. 查看 HBuilderX 窗口的右上角
|
||
2. 看到什么？
|
||
|
||
□ 显示"登录"或"未登录"
|
||
→ 说明：没有登录
|
||
→ 解决：点击"登录"，输入账号密码
|
||
→ 如果没有账号，点击"注册"（免费）
|
||
|
||
□ 显示用户名或头像
|
||
→ 说明：已登录
|
||
→ 继续下一项检查
|
||
|
||
⚠️ 重要：云打包必须登录账号！这是最常见的问题！
|
||
|
||
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
检查 2：控制台是否有输出？
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
|
||
操作：
|
||
1. 在 HBuilderX 底部，找到"控制台"标签页
|
||
2. 点击"打包"后，控制台显示什么？
|
||
|
||
□ 显示"正在连接云端..."、"正在打包..."
|
||
→ 说明：打包请求已提交
|
||
→ 继续等待 5-10 分钟
|
||
|
||
□ 显示"请先登录"
|
||
→ 说明：没有登录
|
||
→ 解决：点击右上角登录
|
||
|
||
□ 显示"网络连接失败"
|
||
→ 说明：网络问题
|
||
→ 解决：检查网络，关闭 VPN
|
||
|
||
□ 完全没有任何输出
|
||
→ 说明：打包请求没有提交
|
||
→ 解决：检查是否已登录，重新尝试
|
||
|
||
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
检查 3：是否选择了正确的打包方式？
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
|
||
操作：
|
||
1. 重新打开云打包界面：发行 → 原生App-云打包
|
||
2. 在"Android 打包"部分，选择了什么？
|
||
|
||
□ 使用自有证书
|
||
→ 说明：错误的选择
|
||
→ 解决：改为"使用 DCloud 公共测试证书"
|
||
|
||
□ 使用 DCloud 公共测试证书
|
||
→ 说明：正确
|
||
→ 继续下一项检查
|
||
|
||
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
检查 4：网络连接是否正常？
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
|
||
操作：
|
||
1. 打开浏览器
|
||
2. 访问：https://www.dcloud.io/
|
||
3. 能否正常打开？
|
||
|
||
□ 可以正常打开
|
||
→ 说明：网络正常
|
||
→ 继续下一项检查
|
||
|
||
□ 无法打开或很慢
|
||
→ 说明：网络问题
|
||
→ 解决：
|
||
- 检查网络连接
|
||
- 关闭 VPN 或代理
|
||
- 更换网络环境
|
||
- 稍后重试
|
||
|
||
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
检查 5：HBuilderX 版本是否最新？
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
|
||
操作：
|
||
1. 在 HBuilderX 菜单栏：帮助 → 关于
|
||
2. 查看版本号
|
||
|
||
□ 版本号低于 3.0
|
||
→ 说明：版本太旧
|
||
→ 解决：更新到最新版
|
||
- 菜单 → 帮助 → 检查更新
|
||
- 或下载：https://www.dcloud.io/hbuilderx.html
|
||
|
||
□ 版本号 3.0 或更高
|
||
→ 说明：版本正常
|
||
→ 继续下一项检查
|
||
|
||
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
检查 6：云打包历史中是否有记录？
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
|
||
操作：
|
||
1. 在 HBuilderX 菜单栏：发行 → 查看云打包历史
|
||
2. 是否有打包记录？
|
||
|
||
□ 有记录，状态为"成功"
|
||
→ 说明：打包已完成
|
||
→ 解决：点击"下载"按钮获取 APK
|
||
|
||
□ 有记录，状态为"失败"
|
||
→ 说明：打包失败
|
||
→ 解决：查看失败原因，根据提示解决
|
||
|
||
□ 有记录，状态为"进行中"
|
||
→ 说明：正在打包
|
||
→ 解决：继续等待
|
||
|
||
□ 没有任何记录
|
||
→ 说明：打包请求没有提交
|
||
→ 解决：检查是否已登录，重新打包
|
||
|
||
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
检查 7：manifest.json 配置是否正确？
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
|
||
操作：
|
||
1. 打开文件：src/manifest.json
|
||
2. 查看第 3 行的 "appid" 字段
|
||
|
||
□ appid 为空或不存在
|
||
→ 说明：配置错误
|
||
→ 解决：重新获取 AppID
|
||
|
||
□ appid 为 "__UNI__71560C7"
|
||
→ 说明：配置正确
|
||
→ 继续下一项检查
|
||
|
||
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
检查 8：是否等待了足够长的时间？
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
|
||
操作：
|
||
1. 点击"打包"后，等待了多久？
|
||
|
||
□ 少于 5 分钟
|
||
→ 说明：时间不够
|
||
→ 解决：继续等待，云打包需要 5-10 分钟
|
||
|
||
□ 超过 10 分钟
|
||
→ 说明：可能卡住了
|
||
→ 解决：
|
||
- 查看控制台输出
|
||
- 查看云打包历史
|
||
- 重新尝试打包
|
||
|
||
|
||
【诊断结果】
|
||
|
||
根据以上检查，最可能的原因是：
|
||
|
||
如果检查 1 未通过：
|
||
→ 问题：没有登录 DCloud 账号
|
||
→ 解决：立即登录，然后重新打包
|
||
|
||
如果检查 2 控制台没有输出：
|
||
→ 问题：打包请求没有提交
|
||
→ 解决：确保已登录，重新打包
|
||
|
||
如果检查 3 选择了"使用自有证书"：
|
||
→ 问题：没有配置证书
|
||
→ 解决：改为"使用 DCloud 公共测试证书"
|
||
|
||
如果检查 4 网络不正常：
|
||
→ 问题：无法连接云端服务
|
||
→ 解决：检查网络，关闭 VPN
|
||
|
||
如果检查 6 云打包历史有成功记录：
|
||
→ 问题：打包已完成，只是没注意到
|
||
→ 解决：直接下载 APK
|
||
|
||
|
||
【立即行动方案】
|
||
|
||
请按照以下步骤操作：
|
||
|
||
第 1 步：检查登录状态
|
||
- 查看 HBuilderX 右上角
|
||
- 如果未登录，立即登录
|
||
|
||
第 2 步：重新打包
|
||
- 菜单：发行 → 原生App-云打包
|
||
- 选择：☑ Android (apk)
|
||
- 选择：◉ 使用 DCloud 公共测试证书
|
||
- 点击：打包
|
||
|
||
第 3 步：观察控制台
|
||
- 查看底部"控制台"标签页
|
||
- 应该看到"正在连接云端..."
|
||
- 然后是"正在打包..."
|
||
|
||
第 4 步：等待完成
|
||
- 不要关闭 HBuilderX
|
||
- 等待 5-10 分钟
|
||
- 看到"打包成功"和下载链接
|
||
|
||
第 5 步：下载 APK
|
||
- 点击下载链接
|
||
- 或从云打包历史中下载
|
||
|
||
|
||
【如果还是不行】
|
||
|
||
请提供以下信息：
|
||
|
||
1. HBuilderX 右上角显示什么？
|
||
□ 显示"登录"
|
||
□ 显示用户名/头像
|
||
|
||
2. 点击"打包"后，控制台显示什么？
|
||
□ 有输出（请复制完整内容）
|
||
□ 完全没有输出
|
||
|
||
3. HBuilderX 版本号？
|
||
菜单 → 帮助 → 关于
|
||
|
||
4. 云打包历史中有记录吗？
|
||
发行 → 查看云打包历史
|
||
□ 有记录（状态是什么？）
|
||
□ 没有记录
|
||
|
||
5. 能否访问 https://www.dcloud.io/ ？
|
||
□ 可以
|
||
□ 不可以
|
||
|
||
|
||
提供这些信息后，我可以更准确地帮您解决！
|
||
|
||
|
||
═══════════════════════════════════════════════════════════════
|
||
最常见的原因：没有登录 DCloud 账号（90%）
|
||
请务必先检查右上角是否已登录！
|
||
═══════════════════════════════════════════════════════════════
|