Android Games

Library game Android mencerminkan Android Game SDK yang tersedia sebagai download biner. Anda dapat menggunakan library androidx daripada mendownload dan mengintegrasikan Android Game SDK secara manual ke dalam build Anda.

Untuk mengetahui informasi selengkapnya tentang Android Game SDK, lihat dokumentasi SDK dan catatan rilis SDK.

Tabel ini mencantumkan semua artefak dalam grup androidx.games.

Artefak Rilis Stabil Saat Ini Kandidat Rilis Berikutnya Rilis Beta Rilis Alfa
games-activity 1.0.0 - - 1.1.0-alpha01
games-controller 1.0.0 - - -
games-frame-pacing 1.9.0 - - -
games-text-input 1.0.0 - - -
games-performance-tuner 1.4.3 - 1.5.0-beta01 -
Library ini terakhir diperbarui pada: 29 September 2021

Mendeklarasikan dependensi

Untuk menambahkan dependensi pada game, Anda harus menambahkan repositori Maven Google ke project Anda. Baca repositori Maven Google untuk mengetahui informasi selengkapnya.

Tambahkan dependensi untuk artefak yang diperlukan dalam file build.gradle bagi aplikasi atau modul Anda:

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.9.0"

    // To use the Android Performance Tuner
    implementation "androidx.games:games-performance-tuner:1.5.0-beta01"

    // To use the Games Activity library
    implementation "androidx.games:games-activity:1.1.0-alpha01"

    // To use the Games Controller Library
    implementation "androidx.games:games-controller:1.0.0"

    // To use the Games Text Input Library
    implementation "androidx.games:games-text-input:1.0.0"
}

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.9.0")

    // To use the Android Performance Tuner
    implementation("androidx.games:games-performance-tuner:1.5.0-beta01")

    // To use the Games Activity library
    implementation("androidx.games:games-activity:1.1.0-alpha01")

    // To use the Games Controller Library
    implementation("androidx.games:games-controller:1.0.0")

    // To use the Games Text Input Library
    implementation("androidx.games:games-text-input:1.0.0")
}
}

Untuk informasi dependensi selengkapnya, lihat Menambahkan dependensi build.

Menambahkan properti Gradle

Anda mungkin perlu menambahkan properti ke file gradle.properties yang berada di direktori yang sama dengan file build.gradle aplikasi (atau modul). Jika file gradle.properties tidak ada, buat file ini.

Jika Anda menggunakan Android Studio 4.0, pastikan gradle.properties berisi baris berikut:

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

Jika Anda menggunakan Android Studio 4.1 atau yang lebih baru, pastikan gradle.properties berisi baris berikut:

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

Menambahkan paket dengan CMake

Agar paket SDK Game yang diimpor tersedia, tambahkan berikut ini ke file CMakeLists.txt aplikasi utama:

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

Ini akan memudahkan Anda untuk menyertakan file header dari Android Game SDK dalam kode game:

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

Di file CMakeLists.txt aplikasi utama, cari target_link_libraries untuk library utama yang digunakan bersama. Tambahkan referensi ke library statis Android Game SDK untuk menyertakannya dalam library bersama:

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

Masukan

Masukan Anda membantu meningkatkan kualitas Jetpack. Beri tahu kami jika Anda menemukan masalah baru atau mempunyai masukan untuk meningkatkan kualitas library ini. Harap periksa masalah yang sudah diketahui dalam library ini sebelum membuat laporan baru. Anda dapat memberikan suara untuk masalah yang sudah diketahui dengan mengklik tombol bintang.

Laporkan masalah baru

Lihat dokumentasi Issue Tracker untuk informasi selengkapnya.

Games-Activity Versi 1.1

Versi 1.1.0-alpha01

29 September 2021

androidx.games:games-activity:1.1.0-alpha01 dirilis. Versi 1.1.0-alpha01 berisi commit berikut ini.

Fitur Baru

Perubahan API

  • Callback onContentRectChanged ditambahkan ke GameActivityCallbacks

Perbaikan Bug

  • Pesan yang hilang ditambahkan ke android_native_app_glue.h:
    • APP_CMD_CONTENT_RECT_CHANGED
    • APP_CMD_WINDOW_REDRAW_NEEDED

Games Performance Tuner 1.5.0

Versi 1.5.0-beta01

29 September 2021

androidx.games:games-performance-tuner:1.5.0-beta01 dirilis. Versi 1.5.0-beta01 berisi commit berikut ini.

Fitur Baru

  • Tidak ada perubahan dari rilis alfa. Rilis tersebut memiliki:
    • Perubahan interval antar-upload secara terprogram, bukan hard code di setelan awal.

Perubahan API

  • Tidak ada perubahan dari rilis alfa. Rilis tersebut memiliki:
    • Fungsi baru: TuningFork_setAggregationStrategyInterval
    • Kolom baru di TuningFork_Settings: aggregation_strategy_intervalms_or_count

Versi 1.5.0-alpha01

18 Agustus 2021

androidx.games:games-performance-tuner:1.5.0-alpha01 dirilis. Versi 1.5.0-alpha01 berisi commit berikut ini.

Fitur Baru

  • Kini Anda dapat menetapkan interval antar upload APT secara terprogram, bukan menggunakan file setelan.

Perubahan API

  • Menambahkan fungsi: TuningFork_setAggregationStrategyInterval
  • Menambahkan kolom ke struktur TuningFork_Settings: aggregation_strategy_intervalms_or_count

Games-Activity Versi 1.0.0

Versi 1.0.0

4 Agustus 2021

androidx.games:games-activity:1.0.0, androidx.games:games-controller:1.0.0, dan androidx.games:games-text-input:1.0.0 dirilis. Versi 1.0.0 berisi commit berikut ini.

Fitur utama 1.0.0

Ini adalah rilis awal untuk Games-Activity, Games-Controller, dan Games-Text-Input versi stabil. Lihat Halaman Beranda AGDK untuk informasi selengkapnya.

Versi 1.0.0-rc01

12 Juli 2021

androidx.games:games-activity:1.0.0-rc01 dirilis. Versi 1.0.0-rc01 berisi commit berikut ini.

Perbaikan Bug

  • Memperbaiki jenis nilai yang ditampilkan GameActivityCallbacks::onSaveInstanceState

Versi 1.0.0-beta01

30 Juni 2021

androidx.games:games-activity:1.0.0-beta01 dirilis. Versi 1.0.0-beta01 berisi commit berikut ini.

Perubahan API

  • Mengganti nama GameActivityInputInfo menjadi GameActivityPointerAxes.
  • Callback onNativeWindowResized kini memberikan lebar dan tinggi jendela.
  • Callback onContentRectChanged telah dihapus.
  • onLowMemory diganti namanya menjadi onTrimMemory.
  • GameActivity_setWindowFormat dihapus.
  • Meningkatkan model kepemilikan untuk pointer GameActivityMotionEvents dan GameActivityMotionEvent.
  • Meningkatkan model kepemilikan status pengguna di callback onSaveInstanceState.

Versi 1.0.0-alpha01

16 Juni 2021

androidx.games:games-activity:1.0.0-alpha01 dirilis.

Fitur Baru

  • Games-Activity adalah library baru yang menggantikan NativeActivity sebagai cara yang direkomendasikan untuk mengintegrasikan game C/C++ dengan Android.

Games-Controller Versi 1.0.0

Versi 1.0.0

4 Agustus 2021

androidx.games:games-activity:1.0.0, androidx.games:games-controller:1.0.0, dan androidx.games:games-text-input:1.0.0 dirilis. Versi 1.0.0 berisi commit berikut ini.

Fitur utama 1.0.0

Ini adalah rilis awal untuk Games-Activity, Games-Controller, dan Games-Text-Input versi stabil. Lihat Halaman Beranda AGDK untuk informasi selengkapnya.

Versi 1.0.0-rc02

21 Juli 2021

androidx.games:games-controller:1.0.0-rc02 dirilis. Versi 1.0.0-rc02 berisi commit berikut ini.

Perbaikan Bug

  • Memperbaiki error pemaketan yang menyebabkan impor Prefab gagal pada permutasi arsitektur/versi yang kosong dan tidak digunakan.

Versi 1.0.0-rc01

12 Juli 2021

androidx.games:games-controller:1.0.0-rc01 dirilis. Versi 1.0.0-rc01 berisi commit berikut ini.

Perbaikan Bug

  • Memperbaiki masalah kompatibilitas dengan GameActivity terbaru

Versi 1.0.0-beta01

30 Juni 2021

androidx.games:games-controller:1.0.0-beta01 dirilis. Versi 1.0.0-beta01 berisi commit berikut ini.

Perubahan API

  • Fungsi yang menampilkan boolean berhasil atau gagal sekarang menampilkan enum Paddleboat_Error_Code.
  • Mengganti nama Paddleboat_onPause menjadi Paddleboat_onStop
  • Mengganti nama Paddleboat_onResume menjadi Paddleboat_onStart
  • Paddleboat_processGameActivityEvent dibagi menjadi dua fungsi: Paddleboat_processGameActivityKeyInputEvent dan Paddleboat_processGameActivityMotionInputEvent
  • Menghapus fitur pengontrol tambahan yang diperlukan untuk build dengan pratinjau Android S SDK
  • Menambahkan fungsi Paddleboat_getBackButtonConsumed
  • Pengontrol dan callback status mouse sekarang memiliki parameter opsional dari pointer ke data yang ditentukan pengguna
  • Mengeluarkan string nama pengontrol dari struktur info perangkat, sekarang diakses melalui fungsi Paddleboat_getControllerName

Perbaikan Bug

  • Memperbaiki masalah dengan pengontrol yang awalnya tidak melaporkan dirinya sendiri sebagai pengontrol, tetapi kemudian melaporkannya melalui pesan onInputDeviceChanged, yang tidak terdeteksi dengan benar sebagai koneksi pengontrol.

Versi 1.0.0-alpha01

16 Juni 2021

androidx.games:games-controller:1.0.0-alpha01 dirilis.

Fitur Baru

  • Games-Controller adalah library baru yang menyediakan C API untuk mendeteksi, membaca input, dan berinteraksi dengan perangkat pengontrol game.

Games-Text-Input Versi 1.0.0

Versi 1.0.0

4 Agustus 2021

androidx.games:games-activity:1.0.0, androidx.games:games-controller:1.0.0, dan androidx.games:games-text-input:1.0.0 dirilis. Versi 1.0.0 berisi commit berikut ini.

Fitur utama 1.0.0

Ini adalah rilis awal untuk Games-Activity, Games-Controller, dan Games-Text-Input versi stabil. Lihat Halaman Beranda AGDK untuk informasi selengkapnya.

Versi 1.0.0-rc01

12 Juli 2021

androidx.games:games-text-input:1.0.0-rc01 dirilis tanpa perubahan. Versi 1.0.0-rc01 berisi commit berikut ini.

Versi 1.0.0-beta01

30 Juni 2021

androidx.games:games-text-input:1.0.0-beta01 dirilis. Versi 1.0.0-beta01 berisi commit berikut ini.

Perubahan API

  • Meningkatkan model kepemilikan objek GameTextInputState.
  • Merapikan jenis agar konsisten dengan NDK.

Versi 1.0.0-alpha01

16 Juni 2021

androidx.games:games-text-input:1.0.0-alpha01 dirilis.

Fitur Baru

  • Games-Text-Input adalah library baru untuk membantu developer game menggunakan input keyboard virtual Android dari C/C ++.

Games Frame Pacing 1.9.0

Versi 1.9.0

12 Juli 2021

androidx.games:games-frame-pacing:1.9.0 dirilis. Versi 1.9.0 berisi commit berikut ini.

Perubahan penting sejak versi 1.7.0

  • Diupdate agar cocok dengan skema pembuatan versi internal.

Games Frame Pacing 1.7.0

Versi 1.7.0

30 Juni 2021

androidx.games:games-frame-pacing:1.7.0 dirilis. Versi 1.7.0 berisi commit berikut ini.

Versi 1.7.0-rc01

2 Juni 2021

androidx.games:games-frame-pacing:1.7.0-rc01 dirilis. Versi 1.7.0-rc01 berisi commit berikut ini.

Versi 1.7.0-beta02

24 Februari 2021

androidx.games:games-frame-pacing:1.7.0-beta02 dirilis.

Versi 1.7.0-beta01

16 Desember 2020

androidx.games:games-frame-pacing:1.7.0-beta01 dirilis.

Games Performance Tuner 1.4.3

Versi 1.4.3

12 Juli 2021

androidx.games:games-performance-tuner:1.4.3 dirilis. Versi 1.4.3 berisi commit berikut ini.

Perubahan penting sejak 1.1.0

  • Diupdate agar cocok dengan skema pembuatan versi internal.

Games Performance Tuner 1.1.0

Versi 1.1.0

30 Juni 2021

androidx.games:games-performance-tuner:1.1.0 dirilis. Versi 1.1.0 berisi commit berikut ini.

Versi 1.1.0-rc01

2 Juni 2021

androidx.games:games-performance-tuner:1.1.0-rc01 dirilis. Versi 1.1.0-rc01 berisi commit berikut ini.

Versi 1.1.0-beta03

21 April 2021

androidx.games:games-performance-tuner:1.1.0-beta03 dirilis.

Versi 1.1.0-beta02

24 Februari 2021

androidx.games:games-performance-tuner:1.1.0-beta02 dirilis.

Versi 1.1.0-beta01

16 Desember 2020

androidx.games:games-performance-tuner:1.1.0-beta01 dirilis.

Versi 1.1.0-alpha01

androidx.games:games-performance-tuner:1.1.0-alpha01 dirilis.

Versi 1.0.0

Versi 1.0.0-alpha02

12 Agustus 2020

Library Android Gaming diganti namanya menjadi library Android Games.

androidx.gaming -> androidx.games

Versi 1.0.0-alpha01

10 Juni 2020

androidx.games:1.0.0-alpha01 dirilis.