Android Games

Android Games 库是 Android 游戏 SDK(能够以二进制文件的形式下载)的镜像。您可以使用 androidx 库,而无需手动下载 Android 游戏 SDK 并将其集成到 build 中。

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

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

工件 当前稳定版 下一候选版本 Beta 版 Alpha 版
games-frame-pacing - - 1.7.0-beta02 -
games-performance-tuner - - 1.1.0-beta03 -
此库的最新更新时间:2021 年 4 月 21 日

声明依赖项

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

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

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-beta02"

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

如需详细了解依赖项,请参阅添加构建依赖项

添加 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 添加软件包

要使导入的游戏 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 游戏 SDK 静态库,以将其添加到您的共享库中:

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

反馈

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

创建新问题

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

Games Frame Pacing 1.7.0

版本 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-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。