Play Feature Delivery の概要

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

Play Feature Delivery は App Bundle の高度な機能を使用することで、アプリの特定の機能を条件付きで配信する、またはオンデマンドでダウンロード可能にすることができます。そのためには、まず、これらの機能をベースアプリから機能モジュールに分離する必要があります。

機能モジュールのビルド構成

Android Studio を使用して新しい機能モジュールを作成すると、IDE はモジュールの build.gradle ファイルに次の Gradle プラグインを適用します。

// The following applies the dynamic-feature plugin to your feature module.
// The plugin includes the Gradle tasks and properties required to configure and build
// an app bundle that includes your feature module.

plugins {
  id 'com.android.dynamic-feature'
}

標準のアプリ プラグインで使用できるプロパティの多くは、機能モジュールでも使用できます。以降のセクションでは、機能モジュールのビルド構成に含めるべきプロパティと含めるべきでないプロパティについて説明します。

機能モジュールのビルド構成に含めるべきでないプロパティ

各機能モジュールはベース モジュールに依存しているため、特定の構成も継承します。そのため、機能モジュールの build.gradle ファイルでは、以下を省略する必要があります。

• 署名設定: App Bundle はベース モジュールで指定する署名設定を使って署名されます。
• minifyEnabled プロパティ: ベース モジュールのビルド構成からのみ、アプリ プロジェクト全体のコード圧縮を有効にすることができます。したがって、このプロパティを機能モジュールから除外する必要があります。ただし、機能モジュールごとに追加の ProGuard ルールを指定できます。
• versionCode と versionName: App Bundle をビルドする際、Gradle はベース モジュールが提供するアプリ バージョン情報を使用します。これらのプロパティは、機能モジュールの build.gradle ファイルから省略する必要があります。

ベース モジュールとの関係を確立する

Android Studio は、機能モジュールを作成するときに、以下に示すように、ベース モジュールの build.gradle ファイルに android.dynamicFeatures プロパティを追加して、ベース モジュールから機能モジュールを認識できるようにします。

// In the base module's build.gradle file.
android {
    ...
    // Specifies feature modules that have a dependency on
    // this base module.
    dynamicFeatures = [":dynamic_feature", ":dynamic_feature2"]
}

また、下記のように、Android Studio は機能モジュールの依存関係としてベース モジュールも含めます。

// In the feature module's build.gradle file:
...
dependencies {
    ...
    // Declares a dependency on the base module, ':app'.
    implementation project(':app')
}

追加の ProGuard ルールを指定する

アプリ プロジェクトのコード圧縮を有効にできるのはベース モジュールのビルド構成のみですが、次のように proguardFiles プロパティを使用して、各機能モジュールにカスタム ProGuard ルールを指定できます。

android.buildTypes {
     release {
         // You must use the following property to specify additional ProGuard
         // rules for feature modules.
         proguardFiles 'proguard-rules-dynamic-features.pro'
     }
}

これらの ProGuard ルールは、ビルド時に他のモジュール（ベース モジュールを含む）のルールと統合されます。したがって、機能モジュールごとに新しいルールセットを指定することはできますが、それらのルールはアプリ プロジェクト内のすべてのモジュールに適用されます。

アプリをデプロイする

機能モジュールをサポートするアプリの開発中も、通常のように、接続されたデバイスにアプリをデプロイできます。それには、メニューバーから [Run] > [Run] を選択します（またはツールバーで実行アイコン をクリックします）。

アプリ プロジェクトに機能モジュールが含まれる場合、アプリのデプロイ時にどの機能を含めるかを選択できます。それには、次のようにして既存の実行 / デバッグ構成を変更します。

1. メニューバーから [Run] > [Edit Configurations] を選択します。
2. [Run/Debug Configurations] ダイアログの左パネルの [Android App] で該当するアプリの構成を選択します。
3. [General] タブの [Dynamic features to deploy] で、アプリのデプロイ時に含める各機能モジュールのチェックボックスをオンにします。
4. [OK] をクリックします。

デフォルトでは、Android Studio が App Bundle を使用してアプリをデプロイすることはありません。代わりに IDE が APK をビルドしてデバイスにインストールします。この APK は、サイズよりも、デプロイの早さについて最適化されます。IDE ではなく、Android Studio で App Bundle からの APK と Instant 版のビルド、デプロイを行うように構成するには、実行 / デバッグ構成を変更します。

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

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

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

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

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

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

リソースの 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 を検査し、パッケージ名を特定します。

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

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

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

機能モジュールのマニフェスト リファレンス

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

参考情報

機能モジュールの使用の詳細については、以下のリソースをご覧ください。

ブログ投稿

• Google Play での開発、リリース、ビジネス拡大に役立つ新機能
• 追加言語 API をはじめとする最新の Android App Bundle のアップデート
• Plaid をモジュール化してみた

動画

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

利用規約とデータ セーフティ

Play Feature Delivery Library にアクセスするか、これを使用すると、Play Core ソフトウェア開発キット利用規約に同意したことになります。適用されるすべての利用規約とポリシーを読んで理解したうえで、ライブラリにアクセスしてください。

データ セーフティ

Play Core ライブラリは、Google Play ストアにおけるアプリのランタイム インターフェースです。そのため、アプリで Play Core を使用すると、Play ストア独自のプロセスが実行され、Google Play 利用規約に則ってデータが処理されます。ここでは、Play Core ライブラリがデータを処理して、アプリからの特定のリクエストを処理する方法について説明します。

追加言語 API

Play Feature Delivery

Google はできる限り透明性を確保することを目指していますが、デベロッパーには、アプリによるユーザーデータの収集および共有とアプリのセキュリティ対策について Google Play のデータ セーフティ セクションのフォームに入力する責任があります。