bundletool

bundletool 是 Android Gradle 外掛程式 Android Studio 及 Google Play 用於建構 Android App Bundle 的基礎工具，bundletool 會將應用程式套件轉換為部署至裝置的各種 APK。

Android SDK 套件 (ASB) 和套件的 APK 都使用 bundletool 建構而成。您也可以把它當做一種指令列工具，用來自行建構應用程式套件和 SDK 套件，並可重新建立下列兩者的 Google Play 伺服器端版本：應用程式 APK 或支援執行階段的 SDK APK。

下載 bundletool

如果您尚未從 GitHub 存放區下載 bundletool，請先完成這項操作。

建構並測試應用程式套件

您可以運用 Android Studio 或 bundletool 指令列工具建構 Android App Bundle，並測試用這個應用程式套件產生的 APK。

建構應用程式套件

使用 Android Studio 和 Android Gradle 外掛程式建構並簽署 Android App Bundle。然而，如果無法使用 IDE，例如您使用的是持續建構伺服器，那麼您也可以透過指令列建構應用程式套件然後使用 jarsigner 簽署。

如要進一步瞭解如何使用 bundletool 建構應用程式套件，請參閱使用 bundletool 建構應用程式套件。

透過應用程式套件產生一組 APK

建構 Android App Bundle 後，測試 Google Play 用以產生 APK 的結果，以及這些 APK 部署到裝置後的表現。

測試應用程式套件的方式有兩種：

• 在本機使用 bundletool 指令列工具。
• 使用測試群組，透過 Google Play 將套件上傳至 Play 管理中心。

本節說明如何使用 bundletool 在本機測試您的應用程式套件。

bundletool 從您的應用程式套件產生 APK 時，會將產生的 APK 納入名為「APK 集的封存檔案」容器，而容器會使用 .apks 副檔名。如果希望從應用程式套件產生的 APK 集可以適用您應用程式支援的所有裝置設定，請使用 bundletool build-apks 指令，如下所示：

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

如要將 APK 部署到裝置，您必須一併加入應用程式的簽署資訊，如下方指令所示。如果未提供簽署資訊，bundletool 會嘗試為您用偵錯金鑰簽署 APK。

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

下表詳細說明了在使用 bundletool build-apks 指令時，您可以設定的各種標記和選項：

表 1. bundletool build-apks 指令的選項

將 APK 部署到連結裝置

產生一組 APK 後，bundletool 即可從該集合部署正確的 APK 組合到連結裝置。

舉例來說，如果您的連結裝置搭載 Android 5.0 (API 級別 21) 以上版本，bundletool 會推送所需的基礎 APK、功能模組 APK 和設定 APK，以便在裝置上執行應用程式。或者，如果您的連結裝置搭載 Android 4.4 (API 級別 20) 以下版本，則 bundletool 會尋找相容的多個 APK，並部署至您的裝置。

如要從 APK 集部署應用程式，請使用 install-apks 指令並使用 --apks=/path/to/apks 標記指定 APK 設定的路徑，如下列指令所示。如果您連接多部裝置，請加入 --device-id=serial-id 標記來指定目標裝置。

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

產生裝置專用的一組 APK

如果您建構 APK 套組時，並不想以應用程式支援的所有裝置設定為對象，可以使用 --connected-device 選項指定僅針對連結裝置，如下列指令所示。如果您連接多部裝置，請加入 --device-id=serial-id 標記來指定目標裝置。

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

產生並使用裝置規格 JSON 檔案

bundletool 可以產生指定 JSON 檔案所指定的裝置設定的 APK 組合。如要先為連結裝置產生 JSON 檔案，請執行下列指令：

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

bundletool 會在工具所在的目錄中建立裝置的 JSON 檔案。您可以將此檔案傳送至 bundletool 以產生一組指定該 JSON 檔案所描述設定的 APK，如下所示：

bundletool build-apks --device-spec=/MyApp/pixel2.json
--bundle=/MyApp/my_app.aab --output=/MyApp/my_app.apks

手動建立裝置規格 JSON

如果您無法存取要建構指定 APK 的裝置，例如好友想要用您目前沒有的裝置試用應用程式，您可以按照下列格式手動建立 JSON 檔案：

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

接著，請按照上一節的說明，將這個 JSON 傳送至 bundle extract-apks 指令。

從現有的 APK 套組擷取裝置專用的 APK

如果您已設定現有 APK，且想要從指定特定裝置設定的 APK 子集擷取，您可以使用 extract-apks 指令並指定裝置規格 JSON，如下所示：

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

測量 APK 套組的 APK 下載大小

如要測量 APK 套組中透過 Wi-Fi 無線提供的預估 APK 下載大小，請使用 get-size total 指令：

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

您可以使用下列標記修改 get-size total 指令的行為：

表 2. get-size total 指令的選項

其他資源

如要進一步瞭解如何使用 bundletool，請觀看應用程式套件：使用 bundletool 和 Play 管理中心測試套件。