Play 功能分发概览

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

Play 功能分发利用 App Bundle 的高级功能，允许有条件地分发或按需下载您应用的某些功能。为此，首先您需要将这些功能从您的基本应用中分离出来，放入功能模块中。

功能模块构建配置

当您使用 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 创建您的功能模块时，它通过向基本模块的 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 规则在构建时会与来自其他模块（包括基本模块）的规则合并。因此，虽然每个功能模块都可以指定一组新规则，但这些规则适用于应用项目中的所有模块。

部署您的应用

在开发支持功能模块的应用时，您可以像往常一样将应用部署到连接的设备上，方法是从菜单栏中选择运行 > 运行（或点击工具栏中的运行 ）。

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

1. 从菜单栏中选择运行 > 编辑配置。
2. 从运行/调试配置对话框的左侧面板中，选择您想要的 Android 应用配置。
3. 在常规标签页的要部署的动态功能下，选中您要在部署应用时包含的每个功能模块旁边的复选框。
4. 点击确定。

默认情况下，Android Studio 不会使用 App Bundle 来部署您的应用。相反，IDE 会构建并将 APK 安装到您的设备上，这些 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 Analyzer 检查您的功能模块 APK 并确定包名：

功能模块的注意事项

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

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

功能模块清单参考

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

其他资源

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

博客文章

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

视频

• App Bundle 的可定制分发和测试构建的轻松共享
• 优化应用大小并提升 Google Play 安装量的新工具

服务条款和数据安全

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

数据安全

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

附加语言 API

Play 功能分发

尽管我们力求尽可能透明，但您全权负责决定如何回应 Google Play 数据安全部分表格中关于您的应用的用户数据收集、共享和安全实践的问题。