HBuilderX 配置 Android 离线打包指南

本文档将指导您完成基于 HBuilderX 开发的 uni-app 项目，在最新版(4.87)环境下进行 Android 离线打包的完整配置流程。

离线打包：指将 uni-app 项目（包括代码、资源及所需原生插件）导出，在本地 Android 开发环境（Android Studio）中编译生成最终 APK 文件的过程。

📦 准备工作：下载所需资源

AppKey 是 DCloud 应用生态的标识，用于识别您的应用。离线打包必须配置。

登录开发者中心
- 访问 DCloud 开发者中心，登录您的账户。
创建或选择应用
- 在应用列表中，找到您要打包的 uni-app 应用，点击进入其详情页。
配置 Android 平台信息
- 在应用详情页，找到 “各平台信息” 区域。
- 点击 “新增”，选择 Android 平台。
生成并获取证书指纹 (SHA1/SHA256)
- 生成证书：在命令行中执行以下命令，创建一个 Android 签名证书 (keystore 文件)。
  bash
```
keytool -genkey -alias testalias -keyalg RSA -keysize 2048 -validity 36500 -keystore test.keystore
```
  1
  - testalias: 证书别名，可自定义。
  - test.keystore: 生成的证书文件名，可自定义。
  - 36500: 有效期（天），建议设置较长时间。
  - 按提示输入信息（密码、姓名、组织等）。
- 查看指纹：生成后，在命令行中执行以下命令查看证书的 SHA1 和 SHA256。
  bash
```
keytool -list -v -keystore test.keystore
```
  1
提交信息并获取 AppKey
- 回到开发者中心页面，将从证书中获取的 SHA1 和 SHA256 填入申请表单。
- 填写其他必要信息（包名等），然后点击 “提交”。
获取离线 AppKey
- 提交成功后，在该平台信息条目中，点击 “创建离线 Appkey”。
- 创建完成后，即可在页面中查看您的 离线 AppKey。请妥善记录，后续需要配置到工程中。

此步骤将把 uni-app 资源与离线 SDK 结合，准备 Android Studio 工程。

准备基础工程
- 将下载的 离线 SDK 解压，将 "HBuilder-Integrate-AS"" 导入到Android Studio中。
- 参考官方 Android 离线 SDK 文档，将其 SDK 目录下的相关资源，按照文档指引，复制或合并到您从 SDK 中获取的示例工程（或您自己的原生工程）的对应目录中。
配置工程文件
- AndroidManifest.xml
  - 将您在开发者中心获取的 离线 AppKey 配置到 application 节点的 meta-data 中。
  - 根据需要配置权限、Activity 等。
- build.gradle
  - 检查 dependencies 块，确保已正确引入离线 SDK 提供的所有 .aar 或 .jar 依赖。
  - 配置 minSdkVersion, targetSdkVersion 等。
- dcloud_control.xml
  - 找到此文件，将其中的 appid 修改为您 uni-app 项目的真实 应用标识 (AppID)。
集成原生插件（可选）
- 如果您的项目使用了 uni-app 原生插件，请根据 Android 离线打包使用插件指南，将插件的原生部分代码和资源配置到当前 Android 工程中。

所有配置完成后，即可在 Android Studio 中生成最终的安装包。

在 Android Studio 中，确保您的工程已成功同步（Sync）。
点击菜单栏：Build → Generate Signed Bundle / APK...
- 选择生成 APK（直接安装）或 Android App Bundle (.aab)（用于上架 Google Play）。
在签名配置窗口中：
- Key store path: 选择您之前生成的 .keystore 文件。
- 输入正确的 Key store password, Key alias, Key password。
选择构建变体（release）及 CPU 架构，然后点击 Finish 开始构建。
构建完成后，在输出目录即可找到您的 APK 或 AAB 文件，可用于测试或发布。

提示：整个过程中，请务必保持网络畅通，以便 Android Studio 和 Gradle 下载必要的依赖。如遇问题，请首先核对官方参考文档中的每一步。