本地离线打包是生产环境可靠路径，需HBuilder X导出资源、匹配SDK版本、Android Studio配置签名并生成APK；云打包仅适合快速验证。
直接用 HBuilder X 云打包是最简单的方式，但如果你需要自定义签名、集成原生 SDK 或规避云打包限制（比如次数、隐私合规要求），就必须走本地离线打包流程。云打包适合快速验证，本地打包才是生产环境的可靠路径。
manifest.json 里必须填对的三个关键字段
这是所有打包方式的前提，填错一个就无法生成可用 APK：
-
appid：必须是 DCloud 开发者中心创建应用后分配的唯一 ID（格式如__UNI__A1B2C3D），不能用 HBuilder X 自动生成的调试 ID；云打包和本地打包都依赖它定位项目资源 -
androidPackage：即 Android 应用包名，全小写、无下划线、不以数字开头（例如com.yourcompany.app）；这个值必须和你在 DCloud 平台申请dcloud_key时填写的包名完全一致，否则启动白屏或报Invalid AppID -
version.code：必须是整数，不能带小数点；很多开发者误填成1.0.0导致打包失败，正确写法是100（对应 1.0.0）或101（对应 1.0.1）
云打包 vs 本地离线打包：选哪个？
看你的实际需求，不是越复杂越好：
- 选云打包：只做功能测试、没敏感权限、不改原生代码、不想装 Android Studio；操作路径是 HBuilder X → 发行 → 原生App-云打包 → Android 包；生成的 APK 默认带调试签名，有效期 30 天，不能上架
- 选本地离线打包：需要正式签名、要加蓝牙/NFC 权限、得集成微信 SDK 或企业内部 SDK、或部署在内网环境；流程是 HBuilder X 导出资源 → 下载匹配版本的 Android 离线 SDK → 用 Android Studio 打开并替换
www→ 修改dcloud_control.xml中的appid→ 配置build.gradle签名 → Build → Generate Signed Bundle/APK - 注意版本对齐：HBuilder X 版本、离线 SDK 版本、Vue 编译器版本三者必须兼容；比如 HBuilder X v3.8.0 对应离线 SDK v3.8.0，混用会导致运行时报
Uncaught ReferenceError: define is not defined
签名证书怎么配才不会踩坑
签名不是“有就行”，配置错会导致安装失败、无法更新、甚至被系统拒绝：
- 证书文件（
.keystore或.jks）不要放在项目目录里，推荐存到用户主目录（如C:\Users\Name\keys\release.jks），避免误提交到 Git - 在
manifest.json的app-plus.distribute.android节点下填路径时，用正斜杠且是相对 HBuilder X 工作区根目录的路径，例如："keystore": "../keys/release.jks" - 密码字段不要硬编码，HBuilder X 支持环境变量注入：
"storePassword": "${KEYSTORE_PASSWORD}"，然后在 HBuilder X 设置 → 运行配置 → 环境变量里添加KEYSTORE_PASSWORD=your_real_password - 如果用 DCloud 平台生成的证书，记得下载后立即复制
SHA1值去平台申请dcloud_key，漏这步本地打包能编译成功，但 APP 启动后立刻闪退
真正卡住人的往往不是步骤多，而是 manifest.json 里一个字段拼写错误、Android Studio 里 dcloud_control.xml 没改对、或者证书 SHA1 和平台申请时填的不一致——这些地方没有明确报错，只会表现为白屏或黑屏，排查起来最耗时间。
