Antes de começar
Este guia do desenvolvedor mostra como compilar e executar um jogo em C++ no Android que usa a API Google Play Games Services. Antes de começar, faça o download e configure os seguintes requisitos:
- Android NDK, revisão 14 ou mais recente
- SDK do Android v10 ou versão mais recente do Eclipse ADT.
- O dispositivo precisa ter o Android 4.0 (API de nível 14) ou versão mais recente.
- A versão mais recente do SDK do Google Play Services.
Este guia para desenvolvedores usa o Android Native Development Kit (NDK). Se você não conhece o NDK, consulte a documentação e as amostras do NDK antes de continuar.
Etapa 1: configurar o ambiente
- Faça o download do SDK do Android e do Android NDK e os extraia para sua máquina. No seu
ambiente, defina
SDK_ROOT
como o local da pasta do SDK do Android eNDK_ROOT
como o local da pasta do Android NDK. - Faça o download dos jogos de exemplo C++. Neste guia do desenvolvedor, o local das amostras na sua máquina é
SAMPLES_DIR
. - Faça o download do SDK dos serviços relacionados a jogos do Google Play para C++. Extraia o SDK na máquina de desenvolvimento. No seu ambiente, defina a variável
NDK_MODULE_PATH
para apontar para o diretório acima do diretóriogpg-cpp-sdk
. Você terá a seguinte estrutura de diretórios:NDK_MODULE_PATH/ gpg-cpp-sdk/
- Abra o Eclipse. Caso ainda não tenha feito isso, informe ao Eclipse onde você instalou o NDK clicando em Preferences > Android > NDK.
Importe o projeto da biblioteca do Google Play Services para o espaço de trabalho do Eclipse.
- No Eclipse, clique em File > Import > Android > Existing Android Code into Workspace.
- Selecione
SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib
, em queSDK_ROOT
é o local do SDK do Android. - Clique em Finish.
Importe o projeto de amostra minimalista para o espaço de trabalho do Eclipse.
- No Eclipse, clique em File > Import > Android > Existing Android Code into Workspace.
- Selecione
SAMPLES_DIR/samples-android/minimalist
. - Clique em Finish.
Clique com o botão direito do mouse no projeto MinimumistActivity e clique em Properties. Em Android, role para baixo até a seção Biblioteca e verifique se o projeto google-play-services_lib está referenciado corretamente. Caso contrário, remova e adicione a referência do seu espaço de trabalho.
O Eclipse vai compilar automaticamente as fontes Java e Android do seu projeto. No entanto, o
código nativo na pasta jni
precisa ser compilado separadamente. Para fazer isso manualmente, navegue até
a pasta jni
e execute ndk-build
. Lembre-se de fazer isso depois de fazer qualquer mudança na
pasta jni
.
O projeto vai ser compilado, mas ele ainda não vai funcionar. Primeiro, é preciso configurar o jogo no Google Play Console.
Etapa 2: configurar o jogo no Google Play Console
Crie uma entrada para seu jogo no Google Play Console. Isso ativa os serviços relacionados a jogos para seu aplicativo e cria um ID do cliente OAuth 2.0, caso você ainda não tenha um.
- Crie uma entrada para o jogo seguindo as etapas descritas em Como configurar os serviços relacionados a jogos do Google Play.
- Em
AndroidManifest.xml
, mude o atributopackage
da tag<manifest>
para o nome do pacote que você escolheu ao configurar o Google Play Console. Talvez seja necessário corrigir algumas referências durante todo o projeto depois de fazer essa mudança, especialmente na classeR
gerada. - Abra
res/values/ids.xml
e coloque o ID do app nele. O ID do app não é o mesmo que o ID do cliente, e sim o número ao lado do nome do jogo na página Detalhes do jogo do Google Play Console.
Etapa 3: Executar a amostra
Para executar a amostra, você precisará de um dispositivo Android físico ou de um emulador com o Google Play Services instalado:
- Execute
ndk-build
para compilar o código nativo. - No Eclipse, clique em Run > Run As > Android Application e execute o exemplo no seu dispositivo.
- Quando o exemplo for aberto, toque em qualquer lugar na tela. Você verá um logotipo do Google Play Games. Se você tiver configurado o app corretamente, vai ser necessário fazer login.
Opcional: criar automaticamente com o Eclipse
As etapas a seguir mostram como configurar o Eclipse para executar automaticamente o ndk-build
quando você fizer alterações em arquivos na pasta jni
.
- Clique com o botão direito do mouse no projeto MinimumistActivity e clique em Properties. Na janela "Properties", selecione o painel Builders.
- Clique em New para adicionar um novo builder, selecione Program e clique em OK.
- No campo Name, digite "NDK Builder".
- Em Location, clique em Browse File System, navegue até o diretório
NDK_ROOT
e selecione o comandondk-build
. - Em Diretório de Trabalho, clique em Procurar espaço de trabalho e selecione a pasta do projeto MinimumistActivity.
- Clique na guia Refresh. Confira se a caixa Atualizar recursos após a conclusão está marcada.
- Selecione o botão de opção Recursos específicos e clique em Especificar recursos. Na
caixa de diálogo resultante, selecione a pasta
jni
em MinimumActivity. - Clique em Apply e em OK para concluir a criação.
Agora, sempre que você editar um arquivo na pasta jni
, o Eclipse executará ndk-build
e imprimirá a saída no console do Eclipse.