bundletool

bundletool は、Android Studio、Android Gradle プラグイン、Google Play が Android App Bundle をビルドする基盤となるツールです。bundletool は App Bundle を各種 APK に変換してデバイスにデプロイすることができます。

Android SDK Bundle（ASB）とその APK は、bundletool を使用してビルドされます。また、コマンドライン ツールとしても利用できるため、App Bundle と SDK Bundle を自分でビルドして、アプリの APK またはランタイム対応の SDK の APK に対する Google Play のサーバー側のビルドを再作成することが可能です。

bundletool のダウンロード

まだダウンロードしていない場合は、GitHub リポジトリから bundletool をダウンロードしてください。

App Bundle をビルドしてテストする

Android Studio または bundletool コマンドライン ツールを使用して Android App Bundle をビルドし、この App Bundle から APK を生成するテストを行えます。

App Bundle をビルドする

Android App Bundle をビルドして署名するには、Android Studio と Android Gradle プラグインを使用します。ただし、IDE を使用しない場合（継続的なビルドサーバーを使用しているなどの理由で）、コマンドラインから App Bundle をビルドして、jarsigner を使って署名することもできます。

bundletool を使用して App Bundle をビルドする方法についての詳細は、bundletool を使用して App Bundle をビルドするをご覧ください。

App Bundle から APK のセットを生成する

Android App Bundle をビルドした後、Google Play で App Bundle から生成される APK と、デバイスにデプロイされたときの APK の動作をテストする必要があります。

App Bundle をテストするには、次の 2 つの方法があります。

• bundletool コマンドライン ツールをローカルで使用します。
• テストトラックを使用して、Google Play から Play Console にバンドルをアップロードします。

このセクションでは、bundletool を使用して App Bundle をローカルにテストする方法について説明します。

bundletool が App Bundle から APK を生成する際、生成された APK は「APK セット アーカイブ」と呼ばれるコンテナに格納されます。このアーカイブは .apks ファイル拡張子を使用します。アプリがサポートするすべてのデバイス設定に対する APK セットを App Bundle から生成するには、下記のように 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 オプションを使用して、接続されているデバイスの設定のみを対象とする APK をビルドできます。複数のデバイスが接続されている場合、--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 セット内の APK の推定ダウンロード サイズを見積もるには、get-size total コマンドを使用します。

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

以下のフラグを使用して get-size total コマンドの動作を変更できます。

表 2. get-size total コマンドのオプション

参考情報

bundletool の使用方法について詳しくは、App Bundle: bundletool と Play Console でバンドルをテストするをご覧ください。