云打包失败主要卡在manifest.json配置、账号未实名、云端证书缺失三处；其中name和versionName必填且需递增，package须为合法Java包名，Contact模块需配套实名认证。
云打包能直接生成可安装的 .apk，但前提是 manifest.json 配置正确、账号已实名、云端证书已就位——缺一不可。没走通流程，大概率卡在这三处。
manifest.json 里哪些配置改不得？
很多打包失败其实发生在配置阶段，而不是打包按钮按下之后。
-
"name"和"versionName"必须填，且versionName每次升级必须比上版高（比如从"1.0.0"改成"1.0.1"），否则云打包会静默跳过或校验失败 -
"id"字段建议点击“重新获取 AppID”自动生成，手动改容易和 DCloud 后台项目不匹配 - 包名（
"android":"package"）必须是合法 Java 包名格式：全小写、带至少两级点号（如com.myapp.demo），含大写字母或下划线会报错 - 如果勾选了
Contact模块，又没完成实名认证，云打包直接报错“未开通通讯录权限”，删掉manifest.json里的"Contact"模块 + 对应的<uses-permission android:name="android.permission.READ_CONTACTS"/>才能继续
为什么点“云打包”后一直卡在“准备中”？
这不是网络慢，而是云端服务在做前置校验，常见堵点有：
Android Adb Skill
下载
Android 开发调试技能，通过系统 ADB 工具操作 Android 设备。以下场景必须触发此技能：(1) 直接 ADB 操作——安装 APK、查看设备列表、抓取 logcat 日志、查看已安装应用、清除应用数据、截图、重启设备、拉取/推送文件、查看 CPU/内存/电池信息、adb shell 操作；(2)...
- 账号没登录，或 HBuilderX 登录账号与 DCloud 官网账号不一致（必须完全相同）
- DCloud 后台项目没关联：打开 DCloud 控制台 → “我的应用”，确认 AppID 是否出现在列表里；没出现就说明 manifest.json 里的
id没同步成功 - Android 云端证书没创建或没提交 SHA1/SHA256：控制台里“各平台信息” → “Android” → 看是否已有证书；没有就点“创建证书”，等几分钟后再把生成的
SHA1和SHA256值粘贴进去并提交 - 当天免费打包次数用完（默认每天 5 次），控制台右下角会有提示，需等待次日重置或开通付费服务
打包完成后，APK 文件在哪？
云打包不直接生成本地文件，而是返回一个带时效的下载链接，注意三点：
- 链接有效期通常为 24 小时，过期需重新打包
- 下载后文件名形如
xxx_1.0.1_202606251322.apk，不含空格，但路径含中文可能导致部分手机无法识别安装包 - 若要用 USB 安装到手机：电脑端需开启手机“USB 调试”，数据线连接后，在 HBuilderX 控制台右键点击下载链接 → “在资源管理器中显示”，找到 APK 后拖进手机内部存储根目录，再用文件管理器点击安装
- 更稳妥的方式是用微信/QQ 发送 APK 到手机，避免 USB 权限问题
最容易被忽略的是：每次修改 manifest.json 后，必须重启 HBuilderX 或右键项目 → “刷新”，否则改动不会生效；而云端证书的 SHA256 值一旦提交，后续打包就绑定该证书，换证书要重新提交并等待审核。
