一、环境准备
-  安装 HBuilderX - 下载最新版 HBuilderX 并安装(官方 IDE,支持一键打包)16
- 确保已安装 Node.js(用于依赖管理)26
 
-  配置 Android 开发环境 - 安装 Java JDK 17+(建议选择稳定版)78
- 安装 Android Studio(用于本地打包)26 - 安装时勾选 Android SDK、Gradle 等组件37
 
 
二、申请应用标识与证书
-  创建 DCloud 应用 - 登录 DCloud 开发者中心,创建新应用,获取 AppID15
 
-  生成证书 - 在 DCloud 后台生成 Android 云端证书(自动生成包名、证书密码、别名等)56
- 下载证书文件(.keystore)保存至项目目录58
 
三、生成本地打包资源
-  在 HBuilderX 中操作 - 右键项目 → 发行 → 原生 App 本地打包 → 生成本地打包资源13
- 生成后的资源文件位于 unpackage/resources目录35
 
-  下载离线 SDK - 从 DCloud 官网下载 Android 离线 SDK(需与 HBuilderX 版本一致)36
- 解压 SDK 至本地目录(如 HBuilder-Integrate-AS)38
 
四、配置 Android 项目
-  替换资源文件 - 将生成的本地打包资源(__UNI__XXXXX文件夹)复制到 SDK 的assets/apps目录38
 
- 将生成的本地打包资源(
-  修改关键配置 - dcloud_control.xml:替换 AppID 为 DCloud 后台申请的 ID35
- AndroidManifest.xml:修改应用名称、权限配置36
- build.gradle:- 填写 applicationId(包名,需与证书一致)36
- 设置 versionCode和versionName(与 HBuilderX 项目版本一致)35
 
- 填写 
 
- 
五、生成 APK 安装包
-  Android Studio 打包操作 - 打开离线 SDK 项目 → Build → Generate Signed Bundle/APK57
- 选择之前下载的 .keystore证书文件,输入密码和别名57
- 选择 APK → Release 模式生成安装包57
 
-  处理常见问题 - Gradle 同步失败:检查 Android SDK 路径是否正确,或手动下载 Gradle 版本37
- 白屏问题:确保 HBuilderX 版本 ≤ 3.99,高版本需配置隐私弹窗46
 
六、测试与发布
-  真机调试 - 手机开启 USB 调试模式 → 运行到 Android 基座 → 查看实时日志48
 
-  应用上架 - 在应用市场注册开发者账号(如华为、小米)
- 上传 APK 并填写应用描述、截图等信息24
 
注意事项
- 证书安全:勿泄露 .keystore文件及密码56
- 版本一致:HBuilderX、离线 SDK、Gradle 版本需匹配36
- 隐私合规:配置原生隐私弹窗,避免应用商店审核失败46
通过以上步骤,可完成从零到 APK 的完整打包流程13。
