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

部署應用程式

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

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

1. 在選單列中，依序選取「Run」>「Edit Configurations」。
2. 在「Run/Debug Configurations」(執行/偵錯設定) 對話方塊的左側面板中，選取所需「Android App」設定。
3. 在「General」分頁的「Dynamic features to deploy」下方，找到部署應用程式時要納入的各項功能模組，然後勾選旁邊的方塊。
4. 按一下「OK」。

根據預設，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，並判定套件名稱：

功能模組的注意事項

您可以透過功能模組加快建構與工程作業，並廣泛自訂應用程式功能提供方式，縮減應用程式大小。不過，使用功能模組時，請留意相關限制和極端案件：

• 如果以條件式/隨選提供功能在單一裝置上安裝 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 安裝量成長的新工具

服務條款與資料安全性

存取或使用 Play Feature Delivery 程式庫，即表示您同意《Play Core 軟體開發套件服務條款》。存取該程式庫前，請詳閱並瞭解所有適用的條款和政策。

資料安全性

Play Core 程式庫是應用程式與 Google Play 商店之間的執行階段介面。因此，在應用程式中使用 Play Core 時，Play 商店會執行自己的程序，包括依據《Google Play 服務條款》的規範處理資料。以下資訊說明 Play Core 程式庫如何處理資料，以因應來自應用程式的特定要求。

其他語言 API

Play Feature Delivery

我們會請您在 Google Play「資料安全性」專區的表單中，說明應用程式收集、分享使用者資料的方式和安全性做法。雖然最好能夠盡量公開透明，但如何填答仍由您決定。