‌

---

‌一、环境准备‌

1. ‌安装 HBuilderX‌

   • 下载最新版 HBuilderX 并安装（官方 IDE，支持一键打包）‌16
   • 确保已安装 Node.js（用于依赖管理）‌26

2. ‌配置 Android 开发环境‌

   • 安装 ‌Java JDK 17+‌（建议选择稳定版）‌78
   • 安装 ‌Android Studio‌（用于本地打包）‌26
     • 安装时勾选 Android SDK、Gradle 等组件‌37

---

‌二、申请应用标识与证书‌

1. ‌创建 DCloud 应用‌

   • 登录 DCloud 开发者中心，创建新应用，获取 ‌AppID‌‌15

2. ‌生成证书‌

   • 在 DCloud 后台生成 ‌Android 云端证书‌（自动生成包名、证书密码、别名等）‌56
   • 下载证书文件（.keystore）保存至项目目录‌58

---

‌三、生成本地打包资源‌

1. ‌在 HBuilderX 中操作‌

   • 右键项目 → ‌发行‌ → ‌原生 App 本地打包‌ → ‌生成本地打包资源‌‌13
   • 生成后的资源文件位于 unpackage/resources 目录‌35

2. ‌下载离线 SDK‌

   • 从 DCloud 官网下载 ‌Android 离线 SDK‌（需与 HBuilderX 版本一致）‌36
   • 解压 SDK 至本地目录（如 HBuilder-Integrate-AS）‌38

---

‌四、配置 Android 项目‌

1. ‌替换资源文件‌

   • 将生成的本地打包资源（__UNI__XXXXX 文件夹）复制到 SDK 的 assets/apps 目录‌38

2. ‌修改关键配置‌

   • ‌dcloud_control.xml‌：替换 AppID 为 DCloud 后台申请的 ID‌35
   • ‌AndroidManifest.xml‌：修改应用名称、权限配置‌36
   • ‌build.gradle‌：
     • 填写 applicationId（包名，需与证书一致）‌36
     • 设置 versionCode 和 versionName（与 HBuilderX 项目版本一致）‌35

---

‌五、生成 APK 安装包‌

1. ‌Android Studio 打包操作‌

   • 打开离线 SDK 项目 → ‌Build‌ → ‌Generate Signed Bundle/APK‌‌57
   • 选择之前下载的 .keystore 证书文件，输入密码和别名‌57
   • 选择 ‌APK‌ → ‌Release‌ 模式生成安装包‌57

2. ‌处理常见问题‌

   • ‌Gradle 同步失败‌：检查 Android SDK 路径是否正确，或手动下载 Gradle 版本‌37
   • ‌白屏问题‌：确保 HBuilderX 版本 ≤ 3.99，高版本需配置隐私弹窗‌46

---

‌六、测试与发布‌

1. ‌真机调试‌

   • 手机开启 USB 调试模式 → 运行到 Android 基座 → 查看实时日志‌48

2. ‌应用上架‌

   • 在应用市场注册开发者账号（如华为、小米）
   • 上传 APK 并填写应用描述、截图等信息‌24

---

‌注意事项‌

• ‌证书安全‌：勿泄露 .keystore 文件及密码‌56
• ‌版本一致‌：HBuilderX、离线 SDK、Gradle 版本需匹配‌36
• ‌隐私合规‌：配置原生隐私弹窗，避免应用商店审核失败‌46

通过以上步骤，可完成从零到 APK 的完整打包流程‌13。