Play Feature Delivery 概览

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

Google Play 的应用服务模型使用 Android App Bundle 针对每位用户的设备配置生成并提供经过优化的 APK，因此用户只需下载其运行您的应用所需的代码和资源。

Play Feature Delivery 使用了 app bundle 的多种高级功能，让您可按条件分发或按需下载应用的某些功能。 为此，首先需要将这些功能从基础应用中分离到功能模块中。

功能模块 build 配置

当您使用 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 配置中的内容

由于每个功能模块都依赖于基本模块，因此它还会继承某些配置。因此，您应该在功能模块的 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（或点击工具栏中的 Run 图标 ），将该应用部署到连接的设备。

如果您的应用项目包含一个或多个功能模块，您可以通过修改现有的运行/调试配置以选择需要在部署应用时包含的功能，具体操作步骤如下：

1. 从菜单栏中依次选择 Run > Edit Configurations。
2. 在 Run/Debug Configurations 对话框的左侧面板中，选择所需的 Android App 配置。
3. 在 General 标签页中的 Dynamic features to deploy 下，选中需要在部署应用时包含的每个功能模块旁边的复选框。
4. 点击确定。

默认情况下，Android Studio 不会使用 App Bundle 部署您的应用，而是由 IDE 构建针对部署速度（而非 APK 大小）进行了优化的 APK，并将其安装到设备中。如需将 Android Studio 配置为通过 App Bundle 构建和部署 APK 以及免安装体验，请修改运行/调试配置。

使用功能模块实现自定义分发

功能模块的独特优势在于，能够自定义如何以及何时将应用的不同功能下载到搭载 Android 5.0（API 级别 21）或更高版本的设备上。例如，为了减小应用的初始下载大小，您可以将某些功能配置为按需下载，或者只能由支持特定功能（比如拍照或增强现实）的设备下载。

虽然将应用作为 app bundle 上传时，默认即可获得高度优化的下载文件，但如需使用更高级且可自定义的 Feature Delivery 选项，您就必须使用功能模块对应用的功能进行额外的配置和模块化处理。也就是说，功能模块提供了用于创建模块化功能的基块，而您可以将各项功能配置为按需下载。

假设我们有一款让用户可在网络购物平台上买卖商品的应用。您可以合理地将该应用的以下各项功能模块化处理为单独的功能模块：

• 账号登录与创建
• 浏览在线购物平台
• 上架商品
• 处理付款

下表列出了功能模块支持的不同分发选项，以及如何使用这些选项优化示例购物平台应用的初始下载大小。

为资源构建 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 的情况下，功能模块不得在其清单中指定 Activity。这是因为，当其他应用尝试启动相应 Activity 时，无法保证设备已下载相应的功能模块。此外，应用在尝试访问功能的代码和资源之前，应该先确认该功能已下载。如需了解详情，请参阅管理已安装的模块。
• 由于 Play Feature Delivery 要求使用 App Bundle 发布应用，因此请确保您了解 App Bundle 的已知问题。

功能模块清单参考文档

当使用 Android Studio 创建新功能模块时，该 IDE 会纳入模块作为功能模块正常运行所需的大多数清单属性。此外，有些属性是在编译时由构建系统注入的，因此您不需要自己指定或修改它们。下表列出了对功能模块非常重要的清单属性。

其他资源

如需详细了解如何使用功能模块，请使用以下资源。

博文

• 能够助力您在 Google Play 上开发和发布产品并拓展业务的新功能
• 最新的 Android App Bundle 更新，包括针对其他语言的 API
• Patchwork Plaid  -  模块化故事

视频

• 借助 app bundle 实现自定义分发，并轻松分享测试 build
• 可让您在 Google Play 上优化应用大小和提升安装量的新工具

服务条款和数据安全

访问或使用 Play Feature Delivery 库即表示您同意接受 Play Core 软件开发套件服务条款。请先阅读并了解所有适用的条款及政策，然后再访问该库。

数据安全

Play Core 库是您的应用与 Google Play 商店的运行时接口。 因此，当您在应用中使用 Play Core 时，Play 商店会运行自己的进程，其中包括根据 Google Play 服务条款处理数据。以下信息说明了 Play Core 库如何通过处理数据来处理从您的应用发来的特定请求。

其他语言 API

Play Feature Delivery

虽然我们力求做到尽可能公开透明，但对于 Google Play 的“数据安全”部分针对您的应用的用户数据收集、分享和安全做法提供的表单，您需自行负责决定如何回应。