Play 功能交付概述

Google Play 的应用服务模型使用 Android 应用包 为每个用户的设备配置生成和提供优化的 APK，因此用户只需下载运行您的应用所需的代码和资源。

Play 功能交付利用应用包的高级功能，允许有条件地交付或按需下载应用的某些功能。为此，您首先需要将这些功能从基本应用中分离到功能模块中。

功能模块构建配置

当您使用 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 针对部署速度进行了优化，而不是 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 后生成正确的命名空间。

例如，假设您有一个应用和具有以下名称的功能模块

• 应用包名：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 功能交付要求您使用应用捆绑包发布应用，因此请确保您了解应用捆绑包的已知问题。

功能模块清单参考

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

其他资源

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

博文

• 帮助您在 Google Play 上开发、发布和发展业务的新功能
• 最新的 Android 应用包更新，包括其他语言 API
• Patchwork Plaid - 模块化故事

视频

• 使用应用包进行可自定义交付以及轻松共享测试版本
• 优化应用大小和提升 Google Play 上安装量的新工具

服务条款和数据安全

通过访问或使用 Play 功能交付库，即表示您同意Play Core 软件开发工具包服务条款。在访问库之前，请阅读并了解所有适用的条款和政策。

数据安全

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

其他语言 API

Play Feature Delivery

虽然我们力求尽可能透明，但您全权负责决定如何响应 Google Play 的数据安全部分表单，该表单涉及您应用的用户数据收集、共享和安全实践。