guoyu/log/备份/txt/内层_诊断检查清单.txt

264 lines
8.9 KiB
Plaintext
Raw Normal View History

2025-12-03 18:58:36 +08:00
═══════════════════════════════════════════════════════════════
云打包问题诊断清单
═══════════════════════════════════════════════════════════════
【现象】
✓ 编译成功
✓ 没有报错
❌ 但是没有生成 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 或代理
- 更换网络环境
- 稍后重试
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
检查 5HBuilderX 版本是否最新?
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
操作:
1. 在 HBuilderX 菜单栏:帮助 → 关于
2. 查看版本号
□ 版本号低于 3.0
→ 说明:版本太旧
→ 解决:更新到最新版
- 菜单 → 帮助 → 检查更新
- 或下载https://www.dcloud.io/hbuilderx.html
□ 版本号 3.0 或更高
→ 说明:版本正常
→ 继续下一项检查
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
检查 6云打包历史中是否有记录
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
操作:
1. 在 HBuilderX 菜单栏:发行 → 查看云打包历史
2. 是否有打包记录?
□ 有记录,状态为"成功"
→ 说明:打包已完成
→ 解决:点击"下载"按钮获取 APK
□ 有记录,状态为"失败"
→ 说明:打包失败
→ 解决:查看失败原因,根据提示解决
□ 有记录,状态为"进行中"
→ 说明:正在打包
→ 解决:继续等待
□ 没有任何记录
→ 说明:打包请求没有提交
→ 解决:检查是否已登录,重新打包
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
检查 7manifest.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%
请务必先检查右上角是否已登录!
═══════════════════════════════════════════════════════════════