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 Feature Delivery 库，您同意 Play Core 软件开发工具包服务条款。在访问该库之前，请阅读并了解所有适用的条款和政策。

数据安全

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

其他语言 API

Play 功能交付

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