AAB与APK格式差异及转换工具bundletool实战指南

AABAPKbundletool

于 2026-08-03 06:57:07 修改

·本内容遵循CC 4.0 BY-SA版权协议

1. AAB与APK格式的本质差异

Android App Bundle（AAB）作为Google Play的官方发布格式，采用模块化设计理念。与传统的APK相比，其核心区别在于：

资源分离机制：AAB将代码、资源和原生库按屏幕密度、ABI和语言进行拆分存储，例如：

BASH

base/

├── manifest/

├── dex/

├── res/

└── lib/
动态交付特性：通过Play Core Library实现按需下载模块，实测可使应用体积平均减少20%。我在处理一个游戏项目时，通过配置dynamicFeatures = [":ar_feature"]使AR功能包仅对支持设备可见

注意：AAB本身不可直接安装，必须通过bundletool生成设备特定的APK集合

官方推荐的bundletool需Java 11+环境，建议使用最新版本（当前为1.15.0）。典型转换命令：

BASH

java -jar bundletool.jar build-apks \

--bundle=app.aab \

--output=app.apks \

--mode=universal

关键参数说明：

遇到签名错误时，建议按此流程排查：

对于需要分设备类型发布的场景，可生成APK集合：

BASH

bundletool build-apks \

--connected-device \

--bundle=app.aab \

--output=app.apks

这会生成包含：

通过分析BundleConfig.json可优化模块：

JSON

{

"optimizations": {

"splitsConfig": {

"splitDimension": [

{"value": "ABI", "negate": false}

]

}

实测在包含native库的项目中，针对性拆分可使安装包体积减少35%

根本原因：设备CPU架构与APK不兼容。解决方案：