Play Feature Delivery 概览

Google Play 的应用分发模型使用 Android App Bundle 为每位用户的设备配置生成并分发经过优化的 APK，因此用户只需下载运行应用所需的代码和资源。

Play Feature Delivery 利用 App Bundle 的高级功能，允许按条件分发或按需下载应用的某些功能。要实现这一点，您首先需要将这些功能从基础应用中分离出来，放入功能模块（feature modules）中。

功能模块构建配置

当您使用 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 文件中省略以下内容：

• 签名配置：App Bundle 使用您在基础模块中指定的签名配置进行签名。
• minifyEnabled 属性：您只能在基础模块的构建配置中为整个应用项目启用代码缩减。因此，您应从功能模块中省略此属性。不过，您可以为每个功能模块指定额外的 ProGuard 规则。
• versionCode 和 versionName：构建 App Bundle 时，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 不会使用 App Bundle 部署您的应用。相反，IDE 会构建并将针对部署速度（而非 APK 大小）进行优化的 APK 安装到您的设备上。要配置 Android Studio 以从 App Bundle 构建和部署 APK 及免安装体验，请修改您的运行/调试配置。

使用功能模块进行自定义分发

功能模块的一个独特优势是能够自定义运行 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 分析器来检查您的功能模块 APK 并确定包名：

功能模块的注意事项

使用功能模块，您可以提高构建速度和工程效率，并广泛自定义应用功能的分发以减小应用大小。但是，在使用功能模块时，需要记住一些限制和极端情况：

• 通过条件分发或按需分发在单台设备上安装 50 个或更多功能模块可能会导致性能问题。未配置为可移除的安装时模块会自动包含在基础模块中，在每台设备上仅计为一个功能模块。
• 限制您为安装时分发配置为可移除的模块数量，使其不超过 10 个。否则，应用的下载和安装时间可能会增加。
• 只有运行 Android 5.0（API 级别 21）及更高版本的设备才支持按需下载和安装功能。要使您的功能在旧版本的 Android 上可用，请在创建功能模块时启用 Fusing（融合）。
• 启用 SplitCompat，以便您的应用可以访问按需分发的下载功能模块。
• 功能模块不应在其清单中指定 android:exported 设置为 true 的 Activity。这是因为无法保证当其他应用尝试启动该 Activity 时，设备已经下载了该功能模块。此外，您的应用在尝试访问其代码和资源之前，应确认功能已下载。要了解更多信息，请阅读管理已安装的模块。
• 由于 Play Feature Delivery 要求您使用 App Bundle 发布应用，请确保您了解 App Bundle 的已知问题。

功能模块清单参考

当使用 Android Studio 创建新的功能模块时，IDE 会包含模块作为功能模块运行所需的大多数清单属性。此外，某些属性由构建系统在编译时注入，因此您无需自行指定或修改它们。下表描述了对功能模块重要的清单属性。

其他资源

要了解关于使用功能模块的更多信息，请尝试以下资源。

博文

• 助力您在 Google Play 上开发、发布和发展业务的新功能
• 最新的 Android App Bundle 更新，包括额外的语言 API
• Patchwork Plaid — 一个模块化的故事

视频

• 使用 App Bundle 进行可自定义分发和测试版本共享
• 优化应用大小并在 Google Play 上增加安装量的新工具

服务条款和数据安全

访问或使用 Play Feature Delivery 库，即表示您同意 Play Core 软件开发套件服务条款。请在访问该库之前阅读并理解所有适用的条款和政策。

数据安全

Play Core 库是您的应用与 Google Play 商店的运行时接口。因此，当您在应用中使用 Play Core 时，Play 商店会运行其自身的进程，其中包含受 Google Play 服务条款管辖的数据处理行为。以下信息描述了 Play Core 库如何处理数据以处理来自您应用的特定请求。

额外语言 API

Play Feature Delivery

虽然我们力求尽可能透明，但您需要自行负责决定如何填写 Google Play 关于您的应用用户数据收集、共享和安全实践的数据安全部分表格。