Introdução aos serviços relacionados a jogos do Google Play para C++ no Android

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:

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

  1. 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 e NDK_ROOT como o local da pasta do Android NDK.
  2. Faça o download dos jogos de exemplo C++. Neste guia do desenvolvedor, o local das amostras na sua máquina é SAMPLES_DIR.
  3. 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ório gpg-cpp-sdk. Você terá a seguinte estrutura de diretórios:
    NDK_MODULE_PATH/
    gpg-cpp-sdk/
  4. Abra o Eclipse. Caso ainda não tenha feito isso, informe ao Eclipse onde você instalou o NDK clicando em Preferences > Android > NDK.
  5. Importe o projeto da biblioteca do Google Play Services para o espaço de trabalho do Eclipse.

    1. No Eclipse, clique em File > Import > Android > Existing Android Code into Workspace.
    2. Selecione SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib, em que SDK_ROOT é o local do SDK do Android.
    3. Clique em Finish.
  6. Importe o projeto de amostra minimalista para o espaço de trabalho do Eclipse.

    1. No Eclipse, clique em File > Import > Android > Existing Android Code into Workspace.
    2. Selecione SAMPLES_DIR/samples-android/minimalist.
    3. Clique em Finish.
  7. 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.

  1. Crie uma entrada para o jogo seguindo as etapas descritas em Como configurar os serviços relacionados a jogos do Google Play.
  2. Em AndroidManifest.xml, mude o atributo package 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 classe R gerada.
  3. 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:

  1. Execute ndk-build para compilar o código nativo.
  2. No Eclipse, clique em Run > Run As > Android Application e execute o exemplo no seu dispositivo.
  3. 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.

  1. Clique com o botão direito do mouse no projeto MinimumistActivity e clique em Properties. Na janela "Properties", selecione o painel Builders.
  2. Clique em New para adicionar um novo builder, selecione Program e clique em OK.
  3. No campo Name, digite "NDK Builder".
  4. Em Location, clique em Browse File System, navegue até o diretório NDK_ROOT e selecione o comando ndk-build.
  5. Em Diretório de Trabalho, clique em Procurar espaço de trabalho e selecione a pasta do projeto MinimumistActivity.
  6. Clique na guia Refresh. Confira se a caixa Atualizar recursos após a conclusão está marcada.
  7. 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.
  8. 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.