2024年9月2日发(作者：集赫)

bundletool用法 -回复

标题：深入理解与使用Bundletool：一款强大的Android应用打包工具

Bundletool是一款由Google推出的开源工具，主要用于处理Android

应用的AAB（Android App Bundle）和APK（Android Package）文

件。本文将详细解析Bundletool的用法，帮助开发者更好地理解和使用

这款强大的工具。

一、Bundletool简介

Bundletool是Google为了解决Android应用打包、优化和签名等问题

而推出的一款命令行工具。它支持从AAB文件生成多个针对不同设备配

置的APK，以及对APK进行签名、优化、拆分等操作。通过使用

Bundletool，开发者可以更高效地管理和发布Android应用。

二、安装Bundletool

首先，我们需要下载并安装Bundletool。Bundletool提供了JAR文件

和Python脚本两种形式，开发者可以根据自己的需求选择合适的版本。

1. JAR文件安装：

下载最新版本的Bundletool JAR文件（例如：bundletool-all-

）。

打开命令行终端，进入Bundletool JAR文件所在的目录，然后运行

以下命令来检查Bundletool是否安装成功：

java -jar version

如果输出了Bundletool的版本信息，说明安装成功。

2. Python脚本安装：

首先确保已经安装了Python环境。

下载最新版本的Bundletool Python脚本（例如：

）。

在命令行终端中，进入Bundletool Python脚本所在的目录，然后运

行以下命令来检查Bundletool是否安装成功：

python version

如果输出了Bundletool的版本信息，说明安装成功。

三、使用Bundletool生成APK

在Android Studio中，我们通常会以AAB格式构建应用。然而，为了

在各种设备上安装和运行应用，我们需要将AAB文件转换为APK文

件。以下是使用Bundletool从AAB文件生成APK的步骤：

1. 准备AAB文件

在Android Studio中，选择“Build” -> “Generate Signed

Bundle / APK”，然后按照提示生成AAB文件。

2. 使用Bundletool生成APK

在命令行终端中，进入Bundletool所在的目录，然后运行以下命

令：

java -jar build-apks

bundle=path/to/your/ output=path/to/

mode=universal

上述命令中的参数含义如下：

- `bundle`：指定AAB文件的路径。

- `output`：指定输出APK集文件的路径。

- `mode`：指定生成APK的模式，此处选择`universal`表示生成一个

包含所有设备配置的APK。

3. 解压APK集文件

Bundletool生成的APK集文件是一个ZIP压缩包，我们需要将其解

压才能得到单独的APK文件。在命令行终端中，运行以下命令：

unzip path/to/ -d path/to/output_directory

上述命令中的参数含义如下：

- `path/to/`：指定APK集文件的路径。

- `path/to/output_directory`：指定解压后的APK文件存放的目

录。

四、使用Bundletool签名APK

在生成APK后，我们需要对其进行签名才能在设备上安装和运行。以下

是使用Bundletool对APK进行签名的步骤：

1. 准备签名文件

在Android Studio中，选择“Build” -> “Generate Signed

Bundle / APK”，然后按照提示生成签名文件（keystore文件和别名密

码）。

2. 使用Bundletool签名APK

在命令行终端中，进入Bundletool所在的目录，然后运行以下命

令：

java -jar sign-apk

apks=path/to/unsigned_ ks=path/to/ ks-

pass=pass:keystore_password ks-key-alias=alias_name key-

pass=pass:key_password output=path/to/signed_

上述命令中的参数含义如下：

- `apks`：指定待签名的未签名APK文件的路径。

- `ks`：指定签名文件（keystore文件）的路径。

- `ks-pass`：指定签名文件的密码。

- `ks-key-alias`：指定签名文件中的别名。

- `key-pass`：指定别名的密码。

- `output`：指定签名后APK文件的输出路径。

五、使用Bundletool优化APK

为了减小APK的大小和提高应用的加载速度，我们可以使用Bundletool

对APK进行优化。以下是使用Bundletool优化APK的步骤：

1. 使用Bundletool拆分APK

在某些情况下，我们可能需要根据设备的特性（如屏幕密度、ABI

等）生成多个特定的APK。以下是使用Bundletool拆分APK的命令：

java -jar build-apks

bundle=path/to/your/ output=path/to/

mode=split

上述命令中的参数含义与之前生成APK的命令相同，只是将`mode`

设置为`split`表示按照设备特性拆分APK。

2. 使用Bundletool优化APK

在生成或拆分APK后，我们可以使用Bundletool的优化功能进一步

减小APK的大小。以下是使用Bundletool优化APK的命令：

java -jar optimize-apks

apks=path/to/ output=path/to/

上述命令中的参数含义如下：

- `apks`：指定待优化的APK集文件的路径。

- `output`：指定优化后APK集文件的输出路径。

六、总结

通过以上步骤，我们已经详细了解了如何安装和使用Bundletool进行

Android应用的打包、签名和优化。Bundletool作为一款强大的工具，

不仅可以帮助开发者更高效地管理应用的发布流程，还能提高应用的性

能和用户体验。希望本文能为开发者在使用Bundletool的过程中提供一

些实用的指导和参考。

2024年9月2日发(作者：集赫)

bundletool用法 -回复

标题：深入理解与使用Bundletool：一款强大的Android应用打包工具

Bundletool是一款由Google推出的开源工具，主要用于处理Android

应用的AAB（Android App Bundle）和APK（Android Package）文

件。本文将详细解析Bundletool的用法，帮助开发者更好地理解和使用

这款强大的工具。

一、Bundletool简介

Bundletool是Google为了解决Android应用打包、优化和签名等问题

而推出的一款命令行工具。它支持从AAB文件生成多个针对不同设备配

置的APK，以及对APK进行签名、优化、拆分等操作。通过使用

Bundletool，开发者可以更高效地管理和发布Android应用。

二、安装Bundletool

首先，我们需要下载并安装Bundletool。Bundletool提供了JAR文件

和Python脚本两种形式，开发者可以根据自己的需求选择合适的版本。

1. JAR文件安装：

下载最新版本的Bundletool JAR文件（例如：bundletool-all-

）。

打开命令行终端，进入Bundletool JAR文件所在的目录，然后运行

以下命令来检查Bundletool是否安装成功：

java -jar version

如果输出了Bundletool的版本信息，说明安装成功。

2. Python脚本安装：

首先确保已经安装了Python环境。

下载最新版本的Bundletool Python脚本（例如：

）。

在命令行终端中，进入Bundletool Python脚本所在的目录，然后运

行以下命令来检查Bundletool是否安装成功：

python version

如果输出了Bundletool的版本信息，说明安装成功。

三、使用Bundletool生成APK

在Android Studio中，我们通常会以AAB格式构建应用。然而，为了

在各种设备上安装和运行应用，我们需要将AAB文件转换为APK文

件。以下是使用Bundletool从AAB文件生成APK的步骤：

1. 准备AAB文件

在Android Studio中，选择“Build” -> “Generate Signed

Bundle / APK”，然后按照提示生成AAB文件。

2. 使用Bundletool生成APK

在命令行终端中，进入Bundletool所在的目录，然后运行以下命

令：

java -jar build-apks

bundle=path/to/your/ output=path/to/

mode=universal

上述命令中的参数含义如下：

- `bundle`：指定AAB文件的路径。

- `output`：指定输出APK集文件的路径。

- `mode`：指定生成APK的模式，此处选择`universal`表示生成一个

包含所有设备配置的APK。

3. 解压APK集文件

Bundletool生成的APK集文件是一个ZIP压缩包，我们需要将其解

压才能得到单独的APK文件。在命令行终端中，运行以下命令：

unzip path/to/ -d path/to/output_directory

上述命令中的参数含义如下：

- `path/to/`：指定APK集文件的路径。

- `path/to/output_directory`：指定解压后的APK文件存放的目

录。

四、使用Bundletool签名APK

在生成APK后，我们需要对其进行签名才能在设备上安装和运行。以下

是使用Bundletool对APK进行签名的步骤：

1. 准备签名文件

在Android Studio中，选择“Build” -> “Generate Signed

Bundle / APK”，然后按照提示生成签名文件（keystore文件和别名密

码）。

2. 使用Bundletool签名APK

在命令行终端中，进入Bundletool所在的目录，然后运行以下命

令：

java -jar sign-apk

apks=path/to/unsigned_ ks=path/to/ ks-

pass=pass:keystore_password ks-key-alias=alias_name key-

pass=pass:key_password output=path/to/signed_

上述命令中的参数含义如下：

- `apks`：指定待签名的未签名APK文件的路径。

- `ks`：指定签名文件（keystore文件）的路径。

- `ks-pass`：指定签名文件的密码。

- `ks-key-alias`：指定签名文件中的别名。

- `key-pass`：指定别名的密码。

- `output`：指定签名后APK文件的输出路径。

五、使用Bundletool优化APK

为了减小APK的大小和提高应用的加载速度，我们可以使用Bundletool

对APK进行优化。以下是使用Bundletool优化APK的步骤：

1. 使用Bundletool拆分APK

在某些情况下，我们可能需要根据设备的特性（如屏幕密度、ABI

等）生成多个特定的APK。以下是使用Bundletool拆分APK的命令：

java -jar build-apks

bundle=path/to/your/ output=path/to/

mode=split

上述命令中的参数含义与之前生成APK的命令相同，只是将`mode`

设置为`split`表示按照设备特性拆分APK。

2. 使用Bundletool优化APK

在生成或拆分APK后，我们可以使用Bundletool的优化功能进一步

减小APK的大小。以下是使用Bundletool优化APK的命令：

java -jar optimize-apks

apks=path/to/ output=path/to/

上述命令中的参数含义如下：

- `apks`：指定待优化的APK集文件的路径。

- `output`：指定优化后APK集文件的输出路径。

六、总结

通过以上步骤，我们已经详细了解了如何安装和使用Bundletool进行

Android应用的打包、签名和优化。Bundletool作为一款强大的工具，

不仅可以帮助开发者更高效地管理应用的发布流程，还能提高应用的性

能和用户体验。希望本文能为开发者在使用Bundletool的过程中提供一

些实用的指导和参考。