一、bundletoo 介绍

bundletool是一种底层工具，可供 Android Studio、Android Gradle 插件和 Google Play 用于构建 Android App Bundle 文件并将 app bundle 转换为部署到设备的各种 APK。您也可以将 bundletool作为一种命令行工具，用于自行构建 app bundle 和重新创建应用 APK 的 Google Play 服务器端 build。

二、下载与配置

• bundletool Github 下载地址 ：https://github.com/google/bundletool

命令别名配置

mac 使用alias(别名) : //www.greatytc.com/p/a3b5da56e5ba

因为下载的 bundletool 工具是一个 .jar 格式文件，因此运行需要先配置 Java 环境。使用命令java -jar bundletool-xxx.jar 即可运行，

为了方便，可以编写一个脚本并配置环境变量，方便全局调用

• Windows 系统

  1. 新建一个目录（示例：D:\Android\bundletool\），将下载的 bundletool-xxx..jar 文件复制进去；
  2. 在目录下新建一个文件（示例：bundletool.bat），并在文件中添加内容 java -jar D:\Android\bundletool\bundletool-all-1.7.1.jar %*，最后面的 %*表示接收任意数量的参数；
  3. 将目录（示例：D:\Android\bundletool\）添加到环境变量的 Path 变量中，并保存
  4. 打开命令行窗口（如果已经打开，需要关闭后重新打开新的窗口），就可以使用命令 bundletool调用bundletool工具了

• Mac
  设置 alias 别名

alias bundleTool="java -jar /Users/**/Android/Tools/bundletool-all-1.8.2.jar"

三、bundletool 使用详解

3.1 bundletool 命令详解

• 使用命令官网详解 ：https://developer.android.com/studio/command-line/bundletool

bundletool 包含了常用的命令，每个命令有自己的参数和标记，下面列出 bundletool可用的命令：

说明：可以使用 bundletool help 查看命令帮助，使用 bundletool hlep command 查看对应命令的帮助。

3.2 构建Android App Bundle

可参考官网：使用 bundletool 构建 app bundle

• 使用 bundletool 在命令行生成 App Bundle 是极其复杂的步骤（首先要生成 proto格式的清单和资源（使用 aapt2 编译并链接应用的资源），然后将这些清单和资源打包成 ZIP 文件（文件目录结构与 Android App Bundle 类似），最后使用 bundletool build-bundle --modules=base.zip --output=mybundle.aab 命令生成最终的 Android App Bundle文件（.aab））
• 使用Android Studio开发，可以使用Android Studio IDE 和 Android Gradle 插件生成 App Bundle

3.3 生成 APK 集合

可参考官网：从 app bundle 生成一组 APK

在 bundletool 从 App Bundle 中生成 APK 时，会将这些 APK 放在一个称之为 APK 集合的压缩包容器内，这个压缩包容器文件以 .apks为后缀。从 App Bundle 中为应用支持的所有设备配置生成 APK 集合，使用 bundletool的 build-apk命令

bundletool build-apks --bundle=/MyApp/my_app.aab --output=/MyApp/my_app.apks

默认bundletool 工具在生成 apks 时，使用 Android 默认的调试签名文件（即 .android/debug.keystore）对生成的 APK 进行签名。当然，你可以指定自己的签名文件为生成的 APK 进行签名，执行如下格式命令（执行时确保命令及参数是单行）：

 bundletool build-apks --bundle=/MyApp/my_app.aab --output=/MyApp/my_app.apks
--ks=/MyApp/keystore.jks
--ks-pass=<file:/MyApp/keystore.pwd> 或者<pass:keystore的pwd>
--ks-key-alias=MyKeyAlias
--key-pass=file:/MyApp/key.pwd 或者<pass:keystore alias的pwd>

注意： 输入密码时要以pass:开头

build-apks 命令参考

 bundletool build-apks
        --bundle=<bundle.aab>
        --output=<output.apks>
        [--aapt2=<path/to/aapt2>]
        [--adb=<path/to/adb>]
        [--connected-device]
        [--create-stamp]
        [--device-id=<device-serial-name>]
        [--device-spec=<device-spec.json>]
        [--device-tier=<low>]
        [--key-pass=<key-password>]
        [--ks=<path/to/keystore>]
        [--ks-key-alias=<key-alias>]
        [--ks-pass=<[pass|file]:value>]
        [--local-testing]
        [--max-threads=<num-threads>]
        [--min-v3-signing-api-version=<30>]
        [--mode=<default|universal|system|persistent|instant>]
        [--modules=<base,module1,module2>]
        [--optimize-for=<abi|screen_density|language|texture_compression_format|device_tier>]
        [--output-format=<apk_set|directory>]
        [--overwrite]
        [--stamp-key-alias=<stamp-key-alias>]
        [--stamp-key-pass=<stamp-key-password>]
        [--stamp-ks=<path/to/keystore>]
        [--stamp-ks-pass=<[pass|file]:value>]
        [--stamp-source=<stamp-source>]
        [--verbose]

命令参数标记详解

在命令行中使用 bundletool help build-apks 可以查看相关的帮助信息。

3.4 将 APK 集合部署到连接的设备

参考官网链接：将 APK 部署到连接的设备

生成 APK 集合（.apks 文件）之后，可以使用 bundletool 将 APK 集合部署到链接的设备上，bundletool 会根据连接设备对应配置选择需要安装 APK 文件并安装到设备上（使用 --mode=universal 生成的单个 APK 会将所有代码和资源安装到设备）。使用install-apks命令将 APK 集合部署到链接的设备上：

bundletool install-apks --apks=/MyApp/my_app.apks

如果在使用build-apks命令生成 APK 集合时使用了 --local-testing标志，为了确保本地测试能够正确进行，请使用 install-apks 安装的 APK

install-apks 命令使用详解

bundletool install-apks
        --apks=<archive.apks>
        [--adb=<path/to/adb>]
        [--additional-local-testing-files]
        [--allow-downgrade]
        [--allow-test-only]
        [--device-groups=<highRam,googlePixel>]
        [--device-id=<device-serial-name>]
        [--device-tier=<high>]
        [--modules=<base,module1,module2>]
        [--timeout-millis=<60000>]

install-apks 命令参数详解

说明：在命令行中使用 bundletool help install-apks 可以查看相关的帮助信息

3.5 为指定设备生成 APK 集合

参考官网链接：生成设备专用 APK 集

使用 bundletool 工具的 build-apks 生成 APK 集合，默认地是根据应用所支持的所有设备的配置生成 APK 集合。如果您不想针对应用支持的所有设备配置生成一组 APK，则可以使用 --connected-device选项，仅针对已连接设备的配置生成 APK，如下所示。（如果连接了多个设备，请添加 --device-id=serial-id 标记来指定目标设备。）

bundletool build-apks --connected-device  --bundle=/MyApp/my_app.aab --output=/MyApp/my_app.apks

生成并使用设备规范 JSON 文件

参考官网链接：生成并使用设备规范 JSON 文件

bundletool 可以为使用 JSON 文件声明的设备配置生成 APK 集合， 使用 get-device-spec 命令可获取已连接的设备的配置 JSON 文件

bundletool get-device-spec --output=/tmp/device-spec.json

获取到的配置文件内容如下所示：

{
  "supportedAbis": [
    "arm64-v8a",
    "armeabi-v7a",
    "armeabi"
  ],
  "supportedLocales": [
    "zh-TW",
    "zh-CN",
    "zh-HK",
    "en-US",
    "ja-JP",
    "ko-KR"
  ],
  "deviceFeatures": [
    "reqGlEsVersion=0x30002",
    "android.hardware.audio.low_latency"
  ],
  "screenDensity": 480,
  "sdkVersion": 29
}

get-device-spec 命令使用详解

bundletool get-device-spec
        --output=<device-spec.json>
        [--adb=<path/to/adb>]
        [--device-groups=<highRam,googlePixel>]
        [--device-id=<device-serial-name>]
        [--device-tier=<low>]
        [--overwrite]

get-device-spec 命令参数详解

手动创建设备规范 JSON

参考官网链接：手动创建设备规范 JSON

如果无法访问要针对其构建目标 APK 集的设备（例如，朋友想通过您手头没有的设备试用您的应用），则可以使用以下格式手动创建 JSON 文件：

{
  "supportedAbis": ["arm64-v8a", "armeabi-v7a"],
  "supportedLocales": ["en", "fr"],
  "screenDensity": 640,
  "sdkVersion": 27
}

设备配置文件包含的信息主要包含了以下几点：

• supportedAbis：设备支持的 Abi（so 库）架构，字符串数组。
• supportedLocales：设备当前添加支持的地区语言（设备中有可能继续添加支持的地区语言，也就是说此字段并不代表设备支持的所有地区语言），字符串数组。
• deviceFeatures：设备支持的特性，字符串数组。
• glExtensions：设备支持的OpenGL扩展，字符串数组。
• screenDensity：屏幕密度，int类型。
• sdkVersion：设备系统版本（versionCode）， int类型。

注意事项： 手动创建设备配置 JSON 文件的时候，只需要针对需要的信息进行配置即可，并不要求每一项都必须有，没有配置的项目会进行兼容处理 .

然后，您可以将此 JSON 传递给 bundle extract-apks 命令

从现有的 APK 集中提取设备专用 APK

参考官网链接：从现有的 APK 集中提取设备专用 APK

bundletool 可以使用 extract-apks 命令从现有的 APK 集合中提取指定设备配置的 APK 子集

bundletool extract-apks
--apks=/MyApp/my_existing_APK_set.apks
--output-dir=/MyApp/my_pixel2_APK_set.apks
--device-spec=/MyApp/bundletool/pixel2.json

extract-apks 命令输出的是 APK 文件（多个 .apk 文件），而不是 APK 集合文件（.apks 压缩文件），所以 --output-dir 是一个目录

extract-apks 命令使用详解

bundletool extract-apks
    --apks=<archive.apks>
    --device-spec=<device-spec.json>
    [--include-metadata]
    [--instant]
    [--modules=<base,module1,module2>]
    [--output-dir=<output-dir>]

extract-apks 命令参数详解

3.6 估算 APK 集合中 APK 的下载大小

参考官网链接：估算 APK 集中的 APK 的下载大小

APK 集内的 APK 将在压缩后通过网络传送。如需估算这些 APK 的下载大小，可使用 get-size total 命令

bundletool get-size total --apks=/MyApp/my_app.apks

get-size total 命令使用详解

bundletool get-size total
        --apks=<archive.apks>
        --human-readable-sizes
        [--device-spec=<device-spec.json>]
        [--dimensions=<SDK,ABI,SCREEN_DENSITY,LANGUAGE,
            TEXTURE_COMPRESSION_FORMAT,DEVICE_TIER,ALL>]
        [--instant]
        [--modules=<base,module1,module2>]

get-size total参数标记详解

在命令行中使用 bundletool help get-size 可以查看相关的帮助信息