Android Games

Android Games

用户指南

Android Games 库是 Android Game SDK（能够以二进制文件的形式下载）的镜像。您可以使用 AndroidX 库，而无需手动下载 Android Game SDK 并将其集成到 build 中。

如需详细了解 Android Game SDK，请参阅 SDK 文档和 SDK 版本说明。

下表列出了 androidx.games 组中的所有工件。

工件	当前稳定版	下一候选版本	Beta 版	Alpha 版
games-frame-pacing	-	1.7.0-rc01	-	-
games-performance-tuner	-	1.1.0-rc01	-	-

此库的上次更新时间：2021 年 6 月 2 日

声明依赖项

如需添加 Game 的依赖项，您必须将 Google Maven 代码库添加到项目中。如需了解详情，请参阅 Google 的 Maven 代码库。

在应用或模块的 build.gradle 文件中添加所需工件的依赖项：

Groovy

android {
    ...
    // To use the Android Frame Pacing or Android Performance Tuner libraries, enable
    // native dependencies to be imported. Libraries will be made available to your CMake build
    // as packages named "games-frame-pacing" and "games-performance-tuner".
    buildFeatures {
        prefab true
    }
}

dependencies {
    // To use the Android Frame Pacing library
    implementation "androidx.games:games-frame-pacing:1.7.0-rc01"

    // To use the Android Performance Tuner
    implementation "androidx.games:games-performance-tuner:1.1.0-rc01"
}

Kotlin

android {
    ...
    // To use the Android Frame Pacing or Android Performance Tuner libraries, enable
    // native dependencies to be imported. Libraries will be made available to your CMake build
    // as packages named "games-frame-pacing" and "games-performance-tuner".
    buildFeatures {
        prefab = true
    }
}

dependencies {
    // To use the Android Frame Pacing library
    implementation("androidx.games:games-frame-pacing:1.7.0-rc01")

    // To use the Android Performance Tuner
    implementation("androidx.games:games-performance-tuner:1.1.0-rc01")
}

如需详细了解依赖项，请参阅添加 build 依赖项。

添加 Gradle 属性

您可能需要向与应用（或模块）的 build.gradle 文件位于同一目录的 gradle.properties 文件添加属性。如果 gradle.properties 文件不存在，请创建此文件。

如果您使用的是 Android Studio 4.0，请确保 gradle.properties 包含以下几行代码：

# Enables experimental Prefab
android.enablePrefab=true
# Tell Android Studio we are using AndroidX
android.useAndroidX=true

如果您使用的是 Android Studio 4.1 或更高版本，请确保 gradle.properties 包含以下几行代码：

# Tell Android Studio we are using AndroidX
android.useAndroidX=true

使用 CMake 添加软件包

要使导入的 Game SDK 软件包可用，请将以下代码添加到主应用的 CMakeLists.txt 文件中：

# Add the packages from the Android Game SDK
find_package(games-frame-pacing REQUIRED CONFIG)
find_package(games-performance-tuner REQUIRED CONFIG)

这样，您就可以在游戏代码中加入 Android 游戏 SDK 中的头文件：

#include "swappy/swappyGL.h"
#include "tuningfork/tuningfork.h"

在主应用的 CMakeLists.txt 文件中，找到主共享库的 target_link_libraries。将 Android Game SDK 静态库的引用代码添加到您的共享库中：

target_link_libraries(...
  games-frame-pacing::swappy_static
  games-performance-tuner::tuningfork_static
  ...)

反馈

您的反馈将帮助我们改进 Jetpack。如果您发现了新问题，或对库的改进有某些建议，请告诉我们。创建新问题前，请先查看此库中的现有问题。您可以点击星标按钮，为现有问题投票。

创建新问题

如需了解详情，请参阅问题跟踪器文档。

Games Frame Pacing 1.7.0

版本 1.7.0-rc01

2021 年 6 月 2 日

发布了 androidx.games:games-frame-pacing:1.7.0-rc01。版本 1.7.0-rc01 中包含这些提交内容。

版本 1.7.0-beta02

2021 年 2 月 24 日

发布了 androidx.games:games-frame-pacing:1.7.0-beta02。

版本 1.7.0-beta01

2020 年 12 月 16 日

发布了 androidx.games:games-frame-pacing:1.7.0-beta01。

Games Performance Tuner 1.1.0

版本 1.1.0-rc01

2021 年 6 月 2 日

发布了 androidx.games:games-performance-tuner:1.1.0-rc01。版本 1.1.0-rc01 中包含这些提交内容。

版本 1.1.0-beta03

2021 年 4 月 21 日

发布了 androidx.games:games-performance-tuner:1.1.0-beta03。

版本 1.1.0-beta02

2021 年 2 月 24 日

发布了 androidx.games:games-performance-tuner:1.1.0-beta02。

版本 1.1.0-beta01

2020 年 12 月 16 日

发布了 androidx.games:games-performance-tuner:1.1.0-beta01。

版本 1.1.0-alpha01

发布了 androidx.games:games-performance-tuner:1.1.0-alpha01。

版本 1.0.0

版本 1.0.0-alpha02

2020 年 8 月 12 日

Android Gaming 库重命名为 Android Games 库。

androidx.gaming -> androidx.games

版本 1.0.0-alpha01

2020 年 6 月 10 日

发布了 androidx.games:1.0.0-alpha01。