Conheça o desenvolvimento de jogos para Android com os serviços relacionados a jogos do Google Play.
O SDK do Play Games oferece serviços relacionados a jogos do Google Play em várias plataformas que permitem integrar facilmente recursos de jogos conhecidos, como conquistas, placares e jogos salvos nos seus jogos para tablet e dispositivos móveis.
Este treinamento orientará você a instalar um aplicativo de jogo de amostra para Android e a criar rapidamente seu próprio jogo para Android. O app de exemplo Type-a-Number Challenge demonstra como integrar conquistas e placares ao seu jogo.
Antes de começar
Para preparar o app, siga as etapas nas seções a seguir.
Pré-requisitos do app
O arquivo de build do app precisa usar estes valores:
- A
minSdkVersion
precisa ser definida como19
ou versões mais recentes. - A
compileSdkVersion
precisa ser definida como28
ou versões mais recentes.
Configurar seu jogo no Google Play Console
No Google Play Console, você pode gerenciar os serviços relacionados a jogos do Google Play e configurar metadados para autorizar e autenticar seu jogo. Para mais informações, consulte Como configurar os serviços relacionados a jogos do Google Play.
Configurar o app
No arquivo build.gradle
no nível do projeto, inclua o
repositório Maven do Google
e o repositório Maven central
nas seções buildscript
e allprojects
:
buildscript {
repositories {
google()
mavenCentral()
}
}
allprojects {
repositories {
google()
mavenCentral()
}
}
Adicione a dependência do Google Play Services para o SDK do Play Games ao
arquivo de build do Gradle do seu módulo, que geralmente é
app/build.gradle
:
dependencies {
implementation 'com.google.android.gms:play-services-games:23.1.0'
}
Guia do app de exemplo
Este treinamento orientará você a instalar um app de jogo de exemplo para Android e a criar rapidamente o seu próprio jogo para Android. O app de exemplo Type-a-Number Challenge demonstra como integrar conquistas e placares ao seu jogo.
Etapa 1: fazer o download do app de exemplo
Para este guia do desenvolvedor, você precisará fazer o download do aplicativo Android de exemplo Type-a-Number Challenge.
Para fazer o download e configurar o aplicativo de exemplo no Android Studio:
- Faça o download dos exemplos para Android na página de download de exemplos.
- Importe o projeto
android-basic-samples
. Esse projeto incluiTypeANumber
e outros exemplos de jogos para Android. Para fazer isso no Android Studio:- Clique em File > Import Project.
- Navegue até o diretório para onde você fez o download de
android-basic-samples
na máquina de desenvolvimento. Selecione o arquivoandroid-basic-samples/build.gradle
e clique em OK.
- No módulo
TypeANumber
, abraAndroidManifest.xml
e mude o nome do pacote decom.google.example.games.tanc
para um nome de pacote diferente. O novo nome do pacote não pode começar comcom.google
,com.example
nemcom.android
.
Etapa 2: configurar o jogo no Google Play Console
O Google Play Console é onde você gerencia os serviços relacionados a jogos do Google Play e configura metadados para autorizar e autenticar seu jogo.
Para configurar o jogo de exemplo no Google Play Console, faça o seguinte:
- Acesse o Google Play Console no navegador e faça login. Caso ainda não tenha se registrado no Google Play Console, você vai receber uma solicitação para fazer isso.
- Siga estas instruções para
adicionar seu jogo ao Google Play Console.
- Quando aparecer a pergunta sobre se você usa APIs do Google no seu app, selecione Ainda não utilizo APIs do Google no meu jogo.
- Neste guia para desenvolvedores, você pode preencher o formulário com os detalhes do seu próprio jogo. Por conveniência, você pode usar os ícones de marcador de posição e as capturas de tela fornecidos na página Downloads.
- Siga estas instruções para
gerar um ID do cliente do OAuth 2.0
para seu app Android.
- Ao vincular seu app Android, especifique o nome exato do pacote que você usou anteriormente ao renomear o pacote de exemplo.
- Você pode usar o assistente "Gerar APK assinado" no Android Studio para gerar um novo keystore e um certificado assinado, se ainda não tiver um. Para saber como executar o assistente "Gerar APK assinado", consulte Assinar seu app no Android Studio.
- Registre as seguintes informações para mais tarde:
- ID do aplicativo: essa é uma string que contém apenas dígitos (normalmente 12 ou mais) no início do seu ID do cliente.
- Certificado de assinatura: anote o certificado usado ao configurar o acesso à API (o certificado cuja impressão digital SHA1 você forneceu). Use o mesmo certificado para assinar o app ao testar ou lançar o app.
- Configure conquistas para o Type-a-Number Challenge:
- Selecione a guia Conquistas no Google Play Console.
- Adicione os seguintes exemplos de conquistas:
Nome Descrição Instruções especiais Premium Recebe uma pontuação que é um número primo. Nenhuma Humble Solicite uma pontuação de 0. Nenhuma Não fique se achando Solicite uma pontuação de 9999 em qualquer modo. Nenhuma VAMOS AO QUE INTERESSA! Receba uma pontuação de 1.337. Faça com que essa conquista seja oculta. Tédio Jogue 10 vezes. Faça com que essa seja uma conquista incremental com 10 etapas a serem desbloqueadas. Muito entediado Jogue 100 vezes. Faça desta uma conquista incremental com 100 passos para desbloquear. - Registre os IDs (strings alfanuméricas longas) de cada conquista criada.
- Configure conquistas adequadas para seu jogo. Para saber mais, consulte os conceitos por trás de conquistas e como implementar conquistas no Android.
- Configure os rankings para o desafio Type-a-Number:
- Selecione a guia Placares no Google Play Console.
- Adicione dois exemplos de placares: um chamado "Pontuações fáceis" e outro chamado "Pontuações difíceis". Os dois placares precisam usar formatação de pontuação de número inteiro com 0 casas decimais e um tipo de ordenação Maior é melhor.
- Registre os IDs (strings alfanuméricas longas) para cada quadro de liderança criado.
- Configure os rankings apropriados para seu jogo. Para saber mais, consulte os conceitos por trás de placares e como implementar placares no Android.
- Adicione contas de teste ao jogo. Essa etapa é necessária apenas para apps que ainda não foram publicados no Google Play Console. Antes da publicação do app, somente as contas de teste listadas no Google Play Console podem fazer login. No entanto, depois que o aplicativo é publicado, todos podem fazer login.
Etapa 3: modificar seu código
Para executar o jogo, você precisa configurar o ID do aplicativo como um recurso no seu
projeto do Android. Também é necessário adicionar os metadados do jogo no AndroidManifest.xml
.
- Abra
res/values/ids.xml
e substitua os IDs dos marcadores. Se você estiver criando um jogo para Android do zero, precisará criar esse arquivo primeiro.- Especifique o ID do aplicativo no recurso
app_id
. - Especifique cada ID de conquista criado anteriormente no recurso
achievement_*
correspondente. - Especifique cada ID de placar criado anteriormente no recurso
leaderboard_*
correspondente.
- Especifique o ID do aplicativo no recurso
- Abra
AndroidManifest.xml
e insira o nome do pacote no atributopackage
do elemento <manifest
>. Se você estiver criando um jogo para Android do zero, adicione também o seguinte código ao elemento <application
>:<meta-data android:name="com.google.android.gms.games.APP_ID" android:value="@string/app_id" /> <meta-data android:name="com.google.android.gms.version" android:value="@integer/google_play_services_version"/>
Etapa 4: testar o jogo
Para garantir que os serviços relacionados a jogos do Google Play estejam funcionando corretamente no jogo, teste o aplicativo antes de publicá-lo no Google Play.
Para executar o jogo no dispositivo de teste físico, faça o seguinte:
- Verifique se você configurou a conta de teste usada para fazer login no app (conforme descrito na Etapa 2).
- Exporte um APK e assine-o com o mesmo certificado usado para configurar o projeto no Google Play Console. Para exportar um APK assinado no Android Studio, clique em Build > Generate Signed APK.
- Instale o APK assinado no dispositivo de teste físico usando a ferramenta
adb
. Para aprender a instalar um app, consulte Executar em um dispositivo.