更新记录

2.0.3（2026-07-13） 下载此版本

修复

• 修复 Android 离线打包仅启用微信分享时原生配置注入不完整的问题

2.0.2（2026-07-10） 下载此版本

修复

• 修复历史残留的微信登录回调类继续参与编译，导致仅启用微信分享时打包失败的问题

2.0.1（2026-07-10） 下载此版本

修复

• 修复仅启用微信分享时误生成微信登录回调类，导致离线打包编译失败的问题

平台兼容性

HBuilderX插件通用注意事项

HBuilderX-2.7.12以下版本安装插件市场内的插件后，卸载时需手动卸载，详细教程参考：如何手动卸载插件

AW 离线打包 — Android 打包从未如此简单

告别云端打包排队等待，只需要一次配置即可实现本地自定义基座与本地正式包

AW 离线打包把这些全自动化了：选项目 → 选模式 → 点打包，剩下的交给插件。普通 uni-app 和 uni-app x Android 项目都可以走本地离线打包。

为什么选择它

• 避免云打包长时间排队 — 直接本地生成自定义基座或者正式包，无需排队
• 真正的一键打包 — 模块自动识别、依赖自动注入、权限自动同步，全程零手动配置
• UTS 插件零配置 — 自动检测项目中的 UTS 插件，创建原生模块、注册编译器、处理 hooksClass，你什么都不用管
• 原生插件自动集成 — 本地原生插件自动复制 aar/jar 并注入 gradle 依赖
• 双模式独立配置 — 正式包和自定义基座各自独立管理包名、AppKey、证书，互不干扰
• 按需打包，拒绝臃肿 — 没有 UTS 插件就不引入 Kotlin 运行时，APK 体积最小化
• 权限自动注入 — 从 manifest.json 读取权限声明，自动去重写入 AndroidManifest.xml
• 权限全局检索精简 — 精简 manifest.json 冗余权限，自动检索项目的真正需要的权限（需要使用 Android 权限审计）
• uni-app x Android 支持 — 自动识别 manifest.json 中的 uni-app-x，使用 uni-app x 原生 SDK 模板独立打包

环境要求

使用本插件前，需要准备以下环境。首次配置大约需要 10-15 分钟，主要是下载相关环境。

1. HBuilderX（3.6.0 及以上）

你已经在用了，跳过。

2. Android Studio（用于初始化打包工程）

插件需要一个 Android Studio 工程作为"打包底座"。你不用打开它写代码，它只是提供 Gradle 编译环境。

获取方式：从 Android Studio 官网 下载安装。安装时会自动附带 Android SDK，后面会用到。

3. DCloud Android 离线 SDK（普通 uni-app）

这是 DCloud 官方提供的原生库集合（aar 文件），包含了 uni-app 运行所需的所有底层能力。

获取方式：

1. 前往 DCloud 官方文档 下载离线 SDK
2. 解压后你会看到以下结构：

   Android-SDK@xxx/
   ├── HBuilder-Integrate-AS/    ← 打包工程模板（就是"SDK 工程目录"）
   │   └── simpleDemo/           ← 主模块
   └── SDK/
      └── libs/                 ← 所有 aar 库文件（就是"SDK 库目录"）

3. 将 HBuilder-Integrate-AS 文件夹放到你喜欢的位置（如 D:\local_pack\）

重要：SDK 版本必须和你的 HBuilderX 版本完全一致！比如 HBuilderX 是 5.07，就要下载 5.07 对应的离线 SDK。版本不一致会导致运行时报错。可以在 HBuilderX 菜单 帮助 → 关于 中查看当前版本号。

4. DCloud uni-app x Android SDK（uni-app x 项目）

如果要打包 uni-app x 项目，需要额外下载 DCloud 官方的 uni-app x Android 原生 SDK。

获取方式：

1. 前往 DCloud 官方 uni-app x Android 原生 SDK 下载页，下载与 HBuilderX 版本一致的 SDK
2. 解压后在全局设置中填写 Android-uni-app-x-SDK@xxx 根目录
3. 该目录应包含 SDK/libs、plugins、uniappxnativepackage

普通 uni-app 项目仍使用 HBuilder-Integrate-AS 工程；uni-app x 项目会使用 uniappxnativepackage 模板，两套打包通道互不影响。

5. JDK 17（编译环境）

Gradle 编译 APK 需要 JDK。推荐使用 JDK 17（Android Studio 自带的 JBR 就是 JDK 17，可以直接用）。

最简单的方式：安装 Android Studio 后，它的 jbr 目录就是一个现成的 JDK 17：

• Windows: C:\Program Files\Android\Android Studio\jbr
• macOS: /Applications/Android Studio.app/Contents/jbr/Contents/Home

不要使用 JDK 21 或更高版本，可能与部分 Gradle 版本不兼容。JDK 8 也不行，离线 SDK 要求 JDK 11+。

一张图看懂各路径关系

全局设置中需要填写的路径（JDK 和 Android SDK 可选但推荐填写）：

SDK 工程目录    →  离线 SDK 中的 HBuilder-Integrate-AS 目录
                  例: D:\local_pack\HBuilder-Integrate-AS

SDK 库目录      →  离线 SDK 里的 aar 库目录
                  例: D:\local_pack\Android-SDK@xxx\SDK\libs

APK 输出目录    →  打包完成后 APK 存放的位置（随意选）
                  例: D:\local_pack\output

JDK 路径（可选） →  JDK 17 的根目录
                  例: C:\Program Files\Android\Android Studio\jbr

Android SDK 路径 →  Android Studio 安装时附带的 SDK 目录（含 platform-tools）
（可选）            例: C:\Users\你的用户名\AppData\Local\Android\Sdk
                   填写后切换 SDK 版本时无需再打开 Android Studio

uni-app x Android SDK 根目录 → Android-uni-app-x-SDK@xxx 目录
（打包 uni-app x 时必填）       例: D:\local_pack\Android-uni-app-x-SDK@xxx

首次配置

1. 全局设置

菜单 工具 → AW离线打包 → AW全局设置，填写 SDK 工程目录、SDK 库目录、APK 输出目录、JDK 路径、Android SDK 路径。需要打包 uni-app x 时，再填写 uni-app x Android SDK 根目录。

提示：JDK 路径和 Android SDK 路径虽然标注为"可选"，但强烈建议填写。填写后即使更新 HBuilderX 版本或更换离线 SDK，也只需修改前两个路径，无需再动 Android Studio。

2. 项目配置

菜单 工具 → AW离线打包 → AW项目管理，新增项目：

• 选择项目目录后自动读取 AppID、应用名称
• 每个项目支持正式(Release)和测试(Debug)两套配置，各自独立：包名、AppKey、签名证书

使用方式

菜单 工具 → AW离线打包 → AW离线打包，或右键项目 → AW离线打包

打包表单中选择：

• 打包项目：选择已配置的项目
• 打包模式：
  • 正式发布包：编译 Release APK
  • 自定义基座：编译 Debug APK，可自动替换到项目 unpackage/debug/android_debug.apk
• 输出选项：
  • 打包前先生成资源：自动编译前端资源
  • 替换项目自定义基座（Debug 模式）
  • 复制到项目 unpackage/release（Release 模式）

模块无需手动选择，插件自动从 manifest.json 识别。原生插件和 UTS 插件也会自动集成。

uni-app x 项目会自动识别 manifest.json 顶层 uni-app-x 配置，并切换到独立的 uni-app x Android SDK 打包通道。

支持的模块

支付（微信/支付宝/PayPal/Stripe/Google）、登录（微信/QQ/微博/一键登录/Google/Facebook）、分享、推送（UniPush/个推/FCM）、地图（高德/百度）、统计（友盟/Google）、SQLite、指纹、蓝牙、iBeacon、通讯录、直播推流、语音识别、人脸识别、X5 内核等。

本地原生插件自动集成，云端插件会输出操作指引。

命令列表

常见问题

Q: 打包时报「SDK location not found」或「缺少 local.properties」？ A: 这是 Gradle 找不到 Android SDK 路径。两种解决方式：

1. （推荐）在全局设置中填写 Android SDK 路径（Android Studio 安装目录下的 SDK，含 platform-tools）
2. 用 Android Studio 打开 SDK 工程目录一次，会自动生成 local.properties

Q: 更新了 HBuilderX 和离线 SDK 后，打包报错？ A: 更新后只需在全局设置中把「SDK 工程目录」和「SDK 库目录」改为新路径即可。如果填写了 Android SDK 路径，local.properties 会自动重新生成，无需其他操作。

Q: 打包时报「SDK 版本不一致」？ A: 离线 SDK 版本必须和 HBuilderX 版本对齐。

Q: uni-app x 项目提示 SDK 未配置？ A: 在全局设置中填写 uni-app x Android SDK 根目录，路径应指向 Android-uni-app-x-SDK@xxx，不是普通 uni-app 的 HBuilder-Integrate-AS。

Q: 编译失败提示 Java 版本问题？ A: 在全局设置中配置 JDK 17 路径（Android Studio 的 jbr 目录即可）。

Q: 自定义基座运行白屏？ A: 检查 SDK libs 目录下是否有 debug-server-release.aar。

Q: APK 体积太大？ A: 在 manifest.json 中配置 abiFilters，只保留需要的 CPU 架构。

Q: 云端原生插件怎么离线打包？ A: 云端插件无法自动集成。前往插件市场下载离线版本，放入 nativeplugins/ 目录，将 isCloud 改为 false 后重新打包。付费/加密插件仅支持云打包。

Q: 使用官方打包出来的app功能正常，使用插件打包的app部分功能异常？ A: 先使用官方打包工具，然后在交流群中说明具体情况，我看到了会回复，也可以自行修改源码，里面都有注释。

请不要随意差评，都是免费的东西。 如果觉得对你有帮助，欢迎在插件市场留下评价或给予支持，感谢你的认可与鼓励！

License

MIT