Google Play Core 库概览

本页介绍了 Google Play Core 库以及如何将其导入您的项目。

什么是 Play Core？

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

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

Java、原生代码和 Unity 支持Play Core 库。如需详细了解最新的 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.9.1'

    // 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.8.3.zip	55.4 MB	b7d21a5311e24d0095e10f471786d4caff7f66af89b79dbcff9e3e41cfae0065

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

   // 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")
       ...
   }
   

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 免安装体验插件。