Android Games

Declarar dependências

Para adicionar uma dependência ao jogo, adicione o repositório Maven do Google ao seu projeto. Leia Repositório Maven do Google para ver mais informações.

Adicione as dependências dos artefatos necessários no arquivo build.gradle para seu app ou módulo:

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.5.0-alpha02"

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

Para ver mais informações sobre dependências, consulte Adicionar dependências de versão.

Adicionar propriedades do Gradle

Talvez seja necessário adicionar propriedades ao arquivo gradle.properties localizado no mesmo diretório que o arquivo build.gradle do seu app ou módulo. Se o arquivo gradle.properties não existir, crie-o.

Se você estiver usando o Android Studio 4.0, verifique se gradle.properties contém as seguintes linhas:

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

Se estiver usando o Android Studio 4.1 ou uma versão mais recente, verifique se gradle.properties contém as seguintes linhas:

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

Adicionar pacotes com o CMake

Para disponibilizar os pacotes importados do SDK do Game, adicione o seguinte ao arquivo CMakeLists.txt do app principal:

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

Isso permitirá que você inclua arquivos principais do SDK do Android Game no código do jogo:

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

No arquivo CMakeLists.txt do app principal, localize target_link_libraries para a biblioteca compartilhada principal. Adicione as referências às bibliotecas estáticas do SDK do Android Game para incluí-las na sua biblioteca compartilhada:

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

Feedback

Seu feedback ajuda a melhorar o Jetpack. Avise se você descobrir novos problemas ou tiver ideias para melhorar esta biblioteca. Consulte os problemas existentes nesta biblioteca antes de criar um novo. Adicione seu voto a um problema existente clicando no botão de estrela.

Criar novo problema

Consulte a documentação do Issue Tracker para saber mais.

Versão 1.0.0

Versão 1.0.0-alpha02

12 de agosto de 2020

A biblioteca Android Gaming foi renomeada como a biblioteca Android Games.

androidx.gaming -> androidx.games

Versão 1.0.0-alpha01

10 de junho de 2020

Lançamento de androidx.games:1.0.0-alpha01.