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 项目，如下所示：

Groovy

// 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.0'

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

Kotlin

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

    // 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。

设置您的开发环境

执行以下其中一项操作：
- 安装 Android Studio 4.0 或更高版本。使用 SDK 管理器界面安装 Android SDK Platform 版本 10.0（API 级别 29）。
- 安装 Android SDK 命令行工具，然后使用 sdkmanager 安装 Android SDK Platform 版本 10.0（API 级别 29）。
使用 SDK 管理器安装最新的 CMake 和 Android 原生开发套件 (NDK)，让 Android Studio 做好原生开发准备。如需详细了解如何创建或导入原生项目，请参阅 NDK 入门指南。
下载 zip 文件并将其解压缩到您的项目所在位置。

下载链接大小 SHA-256 校验和

79.3 MB cca824c6eacfb1393e95863856086961d0cdef523e2479e414853582a4481495

下载链接	大小	SHA-256 校验和
	79.3 MB	cca824c6eacfb1393e95863856086961d0cdef523e2479e414853582a4481495

更新应用的 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"))
    ...
}

更新应用的 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 Native SDK

您必须先接受以下条款及条件才能下载。

条款及条件

上次修改时间：2020 年 9 月 24 日

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

我已阅读并同意上述条款及条件

下载 Play Core Native SDK

play-core-native-sdk-1.10.0.zip

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

上次修改时间：2020 年 9 月 24 日

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