Google Play Core 库概览

本页将介绍 Google Play Core 库以及如何将其添加到您的项目中。

什么是 Play Core？

Play Core 库是您的应用与 Google Play 商店的运行时接口。您可以使用 Play Core 执行的操作包括：

• 下载其他语言资源
• 管理功能模块分发
• 管理资源包分发
• 触发应用内更新
• 请求应用内评价

Play Core 库支持 Java、原生代码和 Unity。如需详细了解最新的 Play Core 库版本，请参阅版本说明。

将 Play Core 库添加到您的项目中

开始使用 Play Core 库之前，您需要先将其添加到您的应用项目中。您需要采取的步骤取决于您是使用 Java、Kotlin、原生开发还是使用 Unity 进行开发。

• Java 或 Kotlin
• 原生代码
• Unity

Java 或 Kotlin

如果您使用 Java 或 Kotlin 开发项目，则可以将 Play Core 库作为 Gradle 依赖项导入 Android 项目，如下所示：

// In your app’s build.gradle file:
...
dependencies {
    // This dependency is downloaded from the Google’s Maven repository.
    // So, make sure you also include that repository in your project's build.gradle file.
    implementation 'com.google.android.play:core:1.10.2'

    // For Kotlin users also add the Kotlin extensions library for Play Core:
    implementation 'com.google.android.play:core-ktx:1.8.1'
    ...
}

// In your app’s build.gradle file:
...
dependencies {
    // This dependency is downloaded from the Google’s Maven repository.
    // So, make sure you also include that repository in your project's build.gradle file.
    implementation("com.google.android.play:core:1.10.2")

    // For Kotlin users also import the Kotlin extensions library for Play Core:
    implementation("com.google.android.play:core-ktx:1.8.1")
    ...
}

Play Core KTX 库是可选的，为常规 Play Core 库中的异步方法调用提供了 Kotlin 协程版本，并且提供了其他有用的扩展，使得从 Kotlin 使用 API 更为得心应手。

原生代码

Play Core 原生 SDK 为 Play Asset Delivery 提供 C/C++ API 接口。该 SDK 设计用于使用 CMake 构建 ARM 和 x86 原生库，以及使用 Gradle 生成 Android App Bundle 和 APK。

设置您的开发环境

1. 执行以下其中一项操作：

   • 安装 Android Studio 4.0 或更高版本。使用 SDK 管理器界面安装 Android SDK Platform 版本 10.0（API 级别 29）。
   • 安装 Android SDK 命令行工具，然后使用 sdkmanager 安装 Android SDK Platform 版本 10.0（API 级别 29）。

2. 使用 SDK 管理器安装最新的 CMake 和 Android 原生开发套件 (NDK)，让 Android Studio 做好原生开发准备。如需详细了解如何创建或导入原生项目，请参阅 NDK 入门指南。

3. 下载 zip 文件并将其解压缩到您的项目所在位置。

   下载链接	大小	SHA-256 校验和
   play-core-native-sdk-1.10.2.zip	43.4 MB	ce312a423d2284be1ca114f242b61e3c52c490d1fffc25573e9ab4e75079aeed

4. 更新应用的 build.gradle 文件，如下所示：

   Groovy

       // App build.gradle
   
       apply plugin: 'com.android.application'
   
       // Define a path to the extracted Play Core SDK files.
       // If using a relative path, wrap it with file() since CMake requires absolute paths.
       def playcoreDir = file('../path/to/playcore-native-sdk')
   
       android {
           defaultConfig {
               ...
               externalNativeBuild {
                   cmake {
                       // Define the PLAYCORE_LOCATION directive.
                       arguments "-DANDROID_STL=c++_static",
                                 "-DPLAYCORE_LOCATION=$playcoreDir"
                   }
               }
               ndk {
                   // Skip deprecated ABIs. Only required when using NDK 16 or earlier.
                   abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64'
               }
           }
           buildTypes {
               release {
                   // Include Play Core Library proguard config files to strip unused code while retaining the Java symbols needed for JNI.
                   proguardFile "$playcoreDir/proguard/common.pgcfg"
                   proguardFile "$playcoreDir/proguard/per-feature-proguard-files"
                   ...
               }
               debug {
                   ...
               }
           }
           externalNativeBuild {
               cmake {
                   path 'src/main/CMakeLists.txt'
               }
           }
       }
   
       dependencies {
           // Use the Play Core AAR included with the SDK.
           implementation files("$playcoreDir/playcore.aar")
           ...
       }
       

   Kotlin

   // App build.gradle
   
   plugins {
       id("com.android.application")
   }
   
   // Define a path to the extracted Play Core SDK files.
   // If using a relative path, wrap it with file() since CMake requires absolute paths.
   val playcoreDir = file("../path/to/playcore-native-sdk")
   
   android {
       defaultConfig {
           ...
           externalNativeBuild {
               cmake {
                   // Define the PLAYCORE_LOCATION directive.
                   arguments += listOf("-DANDROID_STL=c++_static", "-DPLAYCORE_LOCATION=$playcoreDir")
               }
           }
           ndk {
               // Skip deprecated ABIs. Only required when using NDK 16 or earlier.
               abiFilters.clear()
               abiFilters += listOf("armeabi-v7a", "arm64-v8a", "x86", "x86_64")
           }
       }
       buildTypes {
           release {
               // Include Play Core Library proguard config files to strip unused code while retaining the Java symbols needed for JNI.
               proguardFile("$playcoreDir/proguard/common.pgcfg")
               proguardFile("$playcoreDir/proguard/per-feature-proguard-files")
               ...
           }
           debug {
               ...
           }
       }
       externalNativeBuild {
           cmake {
               path = "src/main/CMakeLists.txt"
           }
       }
   }
   
   dependencies {
       // Use the Play Core AAR included with the SDK.
       implementation(files("$playcoreDir/playcore.aar"))
       ...
   }
   

5. 更新应用的 CMakeLists.txt 文件，如下所示：

   cmake_minimum_required(VERSION 3.6)
   
   ...
   
   # Add a static library called “playcore” built with the c++_static STL.
   include(${PLAYCORE_LOCATION}/playcore.cmake)
   add_playcore_static_library()
   
   // In this example “main” is your native code library, i.e. libmain.so.
   add_library(main SHARED
           ...)
   
   target_include_directories(main PRIVATE
           ${PLAYCORE_LOCATION}/include
           ...)
   
   target_link_libraries(main
           android
           playcore
           ...)
   

Unity

部分 Play Core API 提供了 Unity 插件，包括 Play Asset Delivery。从适用于 Unity 的 Google Play 插件版本页面下载最新版本。 这是一个单独的软件包，里面包含 Play Core 插件以及其他 Play 插件，例如 Play 应用内购买结算插件和 Play 免安装体验插件。

Play Core 软件开发套件服务条款

1. 使用 Play Core 软件开发套件，即表示您同意在遵守 Google API 服务条款（以下简称“API 服务条款”）的同时，也遵守这些条款。如果这些条款与 API 服务条款存在冲突，以这些条款为准。请仔细阅读这些条款和 API 服务条款。
2. 就这些条款而言，“API”是指 Google 的 API、其他开发者服务和相关软件（包括任何可再分发代码）。
3. “可再分发代码”是指 Google 提供的调用 API 的对象代码或头文件。
4. 根据这些条款和 API 服务条款的规定，您可以复制和分发可再分发代码，但只能纳入为您的 API 客户端的一部分。Google 及其许可人拥有可再分发代码的所有权利、所有权和利益，包括任何及所有知识产权和其他专有权利。您不得修改、翻译可再分发代码，也不得创作可再分发代码的衍生作品。
5. Google 随时可变更这些条款，如有变更，Google 会向您发出通知，同时您可以选择不继续使用 Play Core 软件开发套件。Google 会在 https://developer.android.com/guide/playcore/license 上发布条款修改通知。变更不具有追溯效力。