Play Feature Delivery の概要

Google Play のアプリ配信モデルは、Android App Bundle を使用して、個々のユーザーのデバイス設定に合わせて最適化した APK を生成して配信します。これにより、ユーザーはアプリの実行に必要なコードとリソースのみをダウンロードできます。

Play Feature Delivery は App Bundle の高度な機能を使用することで、アプリの部分的な機能を条件付きで配信したり、オンデマンドで提供したりできます。

機能モジュールをカスタム配信に使用する

機能モジュールの特長は、Android 5.0（API レベル 21）以上を搭載したデバイスに対して、アプリのさまざまな機能をどのように、どのタイミングでダウンロードするかをカスタマイズできるところにあります。たとえば、アプリの初回ダウンロード サイズを削減するために、一部の機能を必要に応じてオンデマンドでダウンロードするか、特定の機能（写真の撮影機能、拡張現実のサポート機能など）を持つデバイスにのみダウンロードするように構成できます。

アプリを App Bundle としてアップロードすれば、デフォルトでも高度に最適化されたダウンロードが可能になりますが、さらに高度でカスタマイズされた機能配信オプションを利用するには、「機能モジュール」を使ってアプリの機能をモジュール化する追加的な設定が必要になります。つまり、機能モジュールは、必要に応じたダウンロードを可能にするモジュール式機能を作成するための構成要素を提供します。

オンライン ショップでユーザーが商品を売買するためのアプリについて考えてみましょう。アプリの以下の機能は、それぞれ別の機能モジュールに合理的にモジュール化できます。

• アカウントのログインと作成
• ショップのブラウジング
• 販売する商品の配置
• 支払いの処理

下の表は、機能モジュールがサポートするさまざまな配信方法と、その方法で、サンプルのショップアプリの初回ダウンロード サイズをどのように最適化するかを説明しています。

アプリをモジュール化する

アプリのモジュール化とは、アプリ プロジェクトの論理コンポーネントを個別のモジュールに分割するプロセスのことです。

アプリの各機能を個別のコンポーネントに再編成するには、綿密な検討を行い時間を確保する必要があります。それでもモジュール化によって、プロジェクトには以下の利点がもたらされます。

• 並行して開発: アプリの論理コンポーネントをモジュールに分割することで、各モジュールを組織内の異なるチームまたは個人が所有して担当し、他のチームとの統合時における競合や障害を減らすことができます。さらに、アプリのさまざまな部分で使用されるロジックがある場合は、ライブラリ モジュールを使用して、コードの再利用とカプセル化を促すことができます。
• ビルド時間に関する改善: Gradle を使用する Android Studio などのビルドシステムは、モジュールとして編成されているプロジェクトを対象として最適化されています。たとえば、Gradle のプロジェクトの並列実行による最適化を、マルチコア プロセッサが搭載されたワークステーションで有効にする場合、ビルドシステムは複数のモジュールを並行してビルドし、ビルドの所要時間を大幅に削減できます。プロジェクトのモジュール化が進むほど、ビルドのパフォーマンスが大幅に向上します。
• 機能の配信のカスタマイズ: アプリの機能を機能モジュールとしてモジュール化することは、Play Feature Delivery のカスタム配信方法（オンデマンド配信、条件付き配信、Instant 配信など）を活用するための要件です。オンデマンドの機能を作成するには、さらに労力をかけ、アプリで可能なリファクタリングを進める必要があります。そのため、どのアプリの機能を機能モジュールにモジュール化すればカスタム配信方法のメリットが最大になるかを、慎重に検討してください。

アプリの機能ごとにプロジェクトをモジュール化するには、時間をかけて、適切な方法を検討する必要があります。アプリのモジュール化を始めることを決断したら、まず、モジュール式機能をサポートするのに必要なプロパティを指定して、ベース モジュールを構成する必要があります。その後で、インストール時配信用に機能モジュールを構成することで、アプリの現在の動作を変えずにアプリの機能を段階的にモジュール化できます。

機能モジュールのマニフェスト

Android Studio を使用して新しい機能モジュールを作成する際、機能モジュールとして動作するモジュールに必要なほとんどのマニフェスト属性は IDE に含まれています。また、一部の属性はコンパイル時にビルドシステムによって挿入されるため、ご自分で指定または変更する必要はありません。次の表に、機能モジュールの重要なマニフェスト属性を示します。

Play Feature Delivery をテストする

Play Feature Delivery のテストは Google Play ストアから行うことをおすすめします。これは、Play Feature Delivery のメリットの多くが、APK の最適化された生成、署名、Play ストアへの配信の遅延処理に依存しているためです。したがって、単に App Bundle をアップロードする場合または高度な配信方法を構成する場合のいずれであっても、以下の方法でアプリをテストするようにしてください。

• URL を使用してアプリを共有する。 これは、App Bundle をアップロードして、Google Play ストアのリンクとしてアプリを Trusted Tester と共有するのに最も簡単な方法です。さらに、オンデマンドのダウンロード機能など、カスタム配信方法をテストする場合についても、最も簡単な方法です。
• オープンテスト版、クローズド テスト版、内部テスト版をセットアップする。この方法では構造化されたテスト チャンネルが提供されるため、社外ユーザーに公開する前に、アプリの最終リリース版をテストするのにおすすめの方法です。

リソースの URI の作成

URI を使用して機能モジュールに保存されているリソースにアクセスする場合は、次に示すように、Uri.Builder() を使用して機能モジュールのリソース URI を生成します。

val uri = Uri.Builder()
                .scheme(ContentResolver.SCHEME_ANDROID_RESOURCE)
                .authority(context.getPackageName()) // Look up the resources in the application with its splits loaded
                .appendPath(resources.getResourceTypeName(resId))
                .appendPath(String.format("%s:%s",
                  resources.getResourcePackageName(resId), // Look up the dynamic resource in the split namespace.
                  resources.getResourceEntryName(resId)
                  ))
                .build()

String uri = Uri.Builder()
                .scheme(ContentResolver.SCHEME_ANDROID_RESOURCE)
                .authority(context.getPackageName()) // Look up the resources in the application with its splits loaded
                .appendPath(resources.getResourceTypeName(resId))
                .appendPath(String.format("%s:%s",
                  resources.getResourcePackageName(resId), // Look up the dynamic resource in the split namespace.
                  resources.getResourceEntryName(resId)
                  ))
                .build().toString();

分割 APK が読み込まれた後に正しい名前空間が生成されるように、リソースへのパスの各部分は実行時に作成されます。

URI の生成方法の例として、次の名前のアプリと機能モジュールを考えてみましょう。

• アプリのパッケージ名: com.example.my_app_package
• 機能のリソース パッケージ名: com.example.my_app_package.my_dynamic_feature

上記のコード スニペットの resId が、機能モジュールの「my_video」という名前の未加工のファイル リソースを参照した場合、上記の Uri.Builder() コードの出力は次のようになります。

android.resource://com.example.my_app_package/raw/com.example.my_app_package.my_dynamic_feature:my_video

アプリはこの URI を使用して、機能モジュールのリソースにアクセスできます。

URI のパスを検証するには、APK Analyzer を使用して機能モジュール APK を検査し、パッケージ名を特定します。

図 2. APK Analyzer を使用してコンパイル済みリソース ファイルのパッケージ名を検査する

機能モジュールについての検討事項

機能モジュールを使用すると、ビルド速度とエンジニアリング速度が向上し、アプリの配信を広範囲にカスタマイズすることでアプリのサイズを縮小できます。ただし、機能モジュールを使用する際には、いくつかの制約とエッジケースに留意してください。

• 条件付き配信やオンデマンド配信で、1 台のデバイスに 50 個以上の機能モジュールをインストールすると、パフォーマンスの問題が発生する可能性があります。インストール時モジュール（リムーバブルとして構成されていないもの）は、自動的にベース モジュールに追加されて、各デバイスで 1 つの機能モジュールとしてカウントされます。
• インストール時配信用に削除可能として構成するモジュールの数を 10 個以下に制限します。そうしないと、アプリのダウンロードとインストールに要する時間が増大する可能性があります。
• オンデマンドでの機能のダウンロードとインストールに対応しているのは、Android 5.0（API レベル 21）以上を搭載したデバイスのみです。それより前のバージョンの Android で機能を利用可能にするには、機能モジュールの作成時に融合を有効にしてください。
• ダウンロードされた機能モジュールにアプリがアクセスできるようにするため、SplitCompat を有効にします。
• 機能モジュールのマニフェストで android:exported を true に設定したアクティビティを指定しないでください。これは、別のアプリがそのアクティビティを開始しようとした際に、デバイスが機能モジュールをダウンロード済みであるという保証がないためです。さらに、アプリは機能のコードとリソースにアクセスしようとする前に、その機能がダウンロード済みであることを確認する必要があります。詳細については、インストールしたモジュールの管理をご覧ください。
• Play Feature Delivery は App Bundle を使用してアプリを公開する必要があるため、App Bundle の既知の問題を必ずご確認ください。

参考情報

Play Feature Delivery のサポートの詳細については、以下のリソースをご覧ください。

サンプル

• PlayCore API サンプル: PlayCore API を使用して、機能モジュールをリクエストしてダウンロードする例を示します。
• 動的コードの読み込みのサンプル: インストール済みの機能モジュールからコードに安全にアクセスする 3 種類の方法を示します。

Codelab

• 初めての Android App Bundle: Android App Bundle の基本原則を探り、Android Studio を使用して独自のビルドをすぐに始める方法を示すコードラボです。この Codelab では、bundletool を使用して App Bundle をテストする方法についても紹介します。
• オンデマンド モジュール: オンデマンドで機能モジュールをダウンロードしてインストールするアプリの作成方法を紹介します。

ブログ投稿

• 新しい公開形式は Android の未来に何をもたらすか
• Google Play での開発、リリース、ビジネス拡大に役立つ新機能
• 追加の言語 API を含む Android App Bundle の最新のアップデート
• 新しい公開形式は Android の未来に何をもたらすか
• Plaid をモジュール化してみた
• 「Google でサンタを追いかけよう」が Android App Bundle に移行

動画

• App Bundle を使用したカスタマイズ可能な配信とテストビルドの簡単な共有方法
• アプリのサイズを最適化し、Google Play でのインストールを増やす新しいツール
• アプリを Instant にバンドルする