3步精通Android分发神器：Bundletool从构建到部署全指南

环境检测清单

在开始使用Bundletool前，需要确保开发环境满足以下要求：

📌 核心依赖检查

• JDK 8+（推荐11 LTS版本）：提供Java运行环境
• Git：用于获取项目源代码
• Gradle 6.0+：项目构建工具

⚠️ 跨平台注意事项

• Windows系统：需配置JDK环境变量并确保路径无中文
• macOS系统：建议使用Homebrew安装依赖包
• Linux系统：通过系统包管理器安装openjdk-11-jdk

高效构建策略

源代码获取

选择以下任一方式获取项目：

方案A：命令行克隆

git clone https://gitcode.com/gh_mirrors/bu/bundletool
cd bundletool

方案B：手动下载 访问代码仓库页面，下载ZIP压缩包并解压到工作目录

项目构建流程

执行构建命令前，建议先更新Gradle包装器：

# Linux/macOS
./gradlew wrapper --gradle-version 7.5

# Windows
gradlew.bat wrapper --gradle-version 7.5

完成后进行项目构建：

# 基础构建（不含测试）
./gradlew build -x test

# 完整构建（含测试和文档）
./gradlew build

构建成功后，可执行文件位于build/libs/bundletool-all.jar

环境配置方案

临时使用配置

适合临时测试场景，无需修改系统环境：

# Linux/macOS
alias bundletool='java -jar /path/to/bundletool/build/libs/bundletool-all.jar'

# Windows (PowerShell)
function bundletool { java -jar C:\path\to\bundletool\build\libs\bundletool-all.jar $args }

永久环境变量配置

Linux/macOS系统：

# 编辑配置文件
nano ~/.bashrc

# 添加以下内容
export BUNDLETOOL_HOME=/path/to/bundletool/build/libs
export PATH=$PATH:$BUNDLETOOL_HOME

# 使配置生效
source ~/.bashrc

Windows系统：

1. 右键"此电脑" → 属性 → 高级系统设置 → 环境变量
2. 新建系统变量BUNDLETOOL_HOME，值为JAR文件所在路径
3. 编辑Path变量，添加%BUNDLETOOL_HOME%
4. 重启命令提示符生效

📌 验证配置

bundletool --version

常见场景应用

场景1：生成通用APK集

将App Bundle转换为适用于所有设备的APK集合：

# 基础命令
bundletool build-apks --bundle=app.aab --output=app.apks

# 高级选项：包含签名信息
bundletool build-apks --bundle=app.aab --output=app.apks \
  --ks=my-release-key.jks --ks-key-alias=my-key-alias

场景2：为特定设备生成APK

针对连接的测试设备生成优化APK：

# 步骤1：获取设备信息
bundletool get-device-spec --output=device-spec.json

# 步骤2：生成设备专用APK
bundletool build-apks --bundle=app.aab --output=app.apks \
  --device-spec=device-spec.json

# 步骤3：安装到设备
bundletool install-apks --apks=app.apks

场景3：分析Bundle内容

检查App Bundle的结构和资源配置：

# 查看模块信息
bundletool dump modules --bundle=app.aab

# 分析尺寸分布
bundletool dump size --bundle=app.aab --format=human-readable

场景4：签名验证与优化

验证签名并优化APK分发大小：

# 验证签名
bundletool verify-bundle --bundle=app.aab

# 生成优化的APK集
bundletool build-apks --bundle=app.aab --output=optimized.apks \
  --mode=universal --optimize-for=speed

通过这些实用场景，Bundletool能够显著提升Android应用的构建效率和分发质量，实现"一次构建，多端适配"的现代化开发流程。无论是小型应用还是大型SDK，Bundletool都能提供一致且高效的打包体验。