HbuilderX 离线打包apk 基于linux

欢迎到专业群（ HBuilderX技术交流群 ） 咨询，群中有相关专业的管理员和群友。

在 linux 环境下做 HBuilderX 的 Android 离线打包，核心思路是：

1. 用 HBuilderX CLI（Linux 版）生成离线打包资源；
2. 把资源拷到 Android 原生工程（需自己准备）；
3. 在 Linux 下用 Android Studio/Gradle 完成原生构建，生成 apk。

下面给出可直接落地的步骤，全部基于官方文档，无额外推测。

1. 安装并登录 HBuilderX CLI（Linux 版）
   官方最低可用 CLI 版本为 4.81，下载后解压即可用。

   tar -zxvf hbuilderx-cli.linux_x64.full.tar.gz  
   cd hbuilderx-cli  
   ./cli user login --username <用户名> --password <密码>  

2. 在 CLI 中打开 uni-app/uni-app-x 项目

   ./cli project open --path /绝对路径/你的项目  

3. 生成离线打包资源
   在 HBuilderX GUI 中对应菜单是「发行 → 本地打包 → 生成本地打包 App 资源」。
   CLI 暂无直接命令，但你可以：

   • 用 GUI 打开同一项目，点一次「生成本地打包 App 资源」；
   • 或把生成的 unpackage/release/__UNI__XXXX 目录拷到 CI 服务器复用。
     生成的目录里包含 www/ 资源及 manifest.json，后续要拷进 Android 原生工程。

4. 准备 Android 原生离线工程
   按官方文档配置：
   Android 平台原生工程配置
   关键步骤：

   • 用 Android Studio 新建/导入离线 SDK 提供的 HBuilder-Integrate-AS 模板；
   • 把第 3 步生成的 www/ 整个目录覆盖到 app/src/main/assets/apps/__UNI__XXXX/www/；
   • 修改 app/src/main/assets/data/dcloud_control.xml 中的 appid 与 manifest.json 一致；
   • 配置签名证书、包名、权限等，与普通 Android 工程无异。

5. 在 Linux 下构建 apk

   cd 你的原生工程根目录  
   ./gradlew assembleRelease   # 或 assembleDebug  

   构建产物位于 app/build/outputs/apk/release/。

补充说明

• 离线打包不支持“普通授权”的插件市场插件，只能使用“源码授权”或自写原生插件。
• CLI 目前仅提供云打包命令，离线打包资源仍需 GUI 或手动触发一次生成，后续可在 CI 中复用。