针对原生代码或 Java 代码构建

您可以按照以下步骤将 Play Asset Delivery 内置到项目的 Android App Bundle 中。您无需使用 Android Studio 即可执行这些步骤。

  1. 将 Play Core 库导入项目。

  2. 在项目的 build.gradle 文件中将 Android Gradle 插件的版本更新为 4.0.0 或更高版本。

  3. 在项目的顶级目录中，为 Asset Pack 创建一个目录。此目录名称将用作 Asset Pack 名称。Asset Pack 名称必须以字母开头，并且只能包含字母、数字和下划线。

  4. 在 Asset Pack 目录中，创建一个 build.gradle 文件并添加以下代码。请务必指定 Asset Pack 的名称，并且仅指定一种分发类型：

    // In the asset pack’s build.gradle file:
apply plugin: 'com.android.asset-pack'

assetPack {
    packName = "asset-pack-name" // Directory name for the asset pack
    dynamicDelivery {
        deliveryType = "[ install-time | fast-follow | on-demand ]"
    }
}

  5. 在项目的应用 build.gradle 文件中，添加项目中每个 Asset Pack 的名称，如下所示：

    // In the app build.gradle file:
android {
    ...
    assetPacks = [":asset-pack-name", ":asset-pack2-name"]
}

  6. 在项目的 settings.gradle 文件中，添加项目中的所有 Asset Pack，如下所示：

    // In the settings.gradle file:
include ':app'
include ':asset-pack-name'
include ':asset-pack2-name'

  7. 在 Asset Pack 目录中，创建以下子目录：src/main/assets。

  8. 将资产放置在 src/main/assets 目录中。您也可以在此处创建子目录。应用的目录结构现在应如下所示：

    • build.gradle
    • settings.gradle
    • app/
    • asset-pack-name/build.gradle
    • asset-pack-name/src/main/assets/your-asset-directories

  9. 使用 Gradle 构建 Android App Bundle。在生成的 app bundle 中，根级目录现在包含以下内容：

    • asset-pack-name/manifest/AndroidManifest.xml：配置 Asset Pack 的标识符和分发模式
    • asset-pack-name/assets/your-asset-directories：此目录包含作为 Asset Pack 的一部分分发的所有资产

    Gradle 会为每个 Asset Pack 生成清单，并为您输出 assets/ 目录。

  10. （可选）配置 App Bundle 以支持不同的纹理压缩格式。

后续步骤

使用以下某种方法将 Play Asset Delivery 集成到您的游戏或应用代码中：