Play Feature Delivery 總覽

Google Play 的應用程式提供模型會使用 Android App Bundle，針對每個使用者的裝置設定產生並提供最佳化的 APK，因此使用者只需下載執行應用程式所需的程式碼和資源。

Play Feature Delivery 使用應用程式套件的進階功能，以便視情況提供或隨選下載應用程式的特定功能。為此，您必須先將這些功能從基礎應用程式隔離，並納入功能模組。

功能模組建構設定

使用 Android Studio 建立新的功能模組時，IDE 會將下列 Gradle 外掛程式套用至模組的 build.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 檔案中省略下列項目：

• 簽署設定：應用程式套件是根據您在基礎模組中指定的簽署設定進行簽署。
• minifyEnabled 屬性：您可以透過基礎模組的建構設定，為整個應用程式專案啟用程式碼縮減功能。因此，您應在功能模組中省略這個屬性。不過，您可以為每個功能模組指定其他 ProGuard 規則。
• versionCode 和 versionName：建立應用程式套件時，Gradle 會使用基礎模組提供的應用程式版本資訊。您應從功能模組的 build.gradle 檔案中省略這些屬性。

建立與基礎模組的關係

Android Studio 建立功能模組時，為了讓基本模組偵測到該模組，會將 android.dynamicFeatures 屬性新增至基礎模組的 build.gradle 檔案，如下所示：

// 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 規則會與其他模組 (包括基礎模組) 中的規則合併。因此，雖然每個功能模組可能都會指定一組新規則，但這些規則會套用至應用程式專案中的所有模組。

部署應用程式

在開發支援功能模組的應用程式時，您可以照常為已連結的裝置部署應用程式，方法是從選單列中選取「執行」>「執行」 (或者按一下工具列中的「執行」)。

如果您的應用程式專案包含一或多個功能模組，可以按照下列步驟修改現有的執行/偵錯設定，選擇要在部署應用程式時納入哪些功能：

1. 在選單列中，依序選取「執行」>「編輯設定」。
2. 在「執行/偵錯設定」對話方塊的左側面板中，選取您要使用的「Android 應用程式」設定。
3. 在「一般」 分頁標籤的「動態功能部署」下方，找到您要在部署應用程式時納入的每個功能模組，勾選旁邊的方塊。
4. 按一下「確定」。

根據預設，Android Studio 不會使用應用程式套件部署應用程式。相反地，IDE 會在裝置中建構並安裝適當的 APK，從而將部署速度最佳化 (而非 APK 的大小)。若要將 Android Studio 從應用程式套件設定為改用建構和部署 APK 與免安裝體驗，請修改執行/偵錯設定。

透過功能模組按照使用者的需求提供功能

使用功能模組特有的好處，就是能自訂將應用程式的不同功能下載到搭載 Android 5.0 (API 級別 21) 以上版本的裝置上的方式和時機。例如，若要縮減應用程式的初始下載大小，您可以設定某些功能，讓使用者視需求隨選下載，或僅透過支援特定功能的裝置下載，例如拍照功能或支援擴增實境功能。

根據預設，儘管在您以應用程式套件的形式上傳應用程式時，可獲得高度最佳化的下載內容，但若要使用更進階的客製化功能提供選項，就需要使用「功能模組」，對應用程式的功能進行額外的設定及模組化。也就是說，功能模組提供建立模組化功能的建置組塊，讓您視需要設定至每個下載項目。

假設某個應用程式允許使用者透過線上市集買賣商品。您可以合理地將應用程式的下列各項功能模組化，並納入獨立的功能模組：

• 帳戶登入和建立
• 瀏覽市集
• 上架銷售商品
• 處理付款

下表說明功能模組支援的不同提供選項，以及如何利用這些選項將市集應用程式範例的初始下載大小最佳化。

建立資源的 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 分析工具來檢查功能模組 APK，並判定套件名稱：

圖 2. 使用 APK 分析工具檢查已編譯資源檔案中的套件名稱。

功能模組的注意事項

您可以透過功能模組，加快建構速度和工程設計速率，並大幅度自訂應用程式功能的提供方式，藉此縮減應用程式的大小。不過，使用功能模組時，請留意相關限制和極端案件：

• 透過條件式或隨選提供，在單一裝置上安裝 50 個以上的功能模組後，可能會引發效能問題。安裝時間模組 (並未設為可移除) 會自動納入基礎模組，且在每台裝置上只會計為一個功能模組。
• 將設為可移除的安裝時提供模組數量限制在 10 個以下。否則，可能會延長應用程式的下載和安裝時間。
• 只有搭載 Android 5.0 (API 級別 21) 以上版本的裝置，才能隨選下載和安裝功能。若要讓功能適用於較舊的 Android 版本，請在建立功能模組時，啟用「融合」功能。
• 啟用 SplitCompat 後，應用程式就能存取隨選提供的已下載功能模組。
• 將 android:exported 設為 true 時，功能模組不應在資訊清單中指定活動。原因在於，當其他應用程式嘗試啟動活動時，不保證裝置已下載功能模組。此外，在嘗試存取其程式碼和資源之前，應用程式應確認已下載功能。詳情請參閱管理已安裝的模組。
• 由於 Play Feature Delivery 必須使用應用程式套件發布應用程式，因此務必瞭解應用程式套件的已知問題。

功能模組資訊清單參考資料

使用 Android Studio 建立新的功能模組時，IDE 包含模組需要的大部分資訊清單屬性，以便如功能模組般運作。此外，部分屬性會在編譯期間由建構系統插入，因此您無須自行指定或修改這些屬性。下表說明重要的功能模組資訊清單屬性。

其他資源

若要進一步瞭解如何使用功能模組，請參考下列資源。

網誌文章

• 協助您在 Google Play 上開發、發行及拓展業務的新功能
• 最新的 Android App Bundle 更新內容包含了其他語言的 API
• 解構 Plaid－一段關於模組化的故事

影片

• 使用應用程式套件自訂提供功能，以及輕鬆共用測試版本
• 全新工具，用來最佳化應用程式的大小與加快在 Google Play 上的安裝