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 API de serviços relacionados a jogos. Antes de começar, faça o download e configure os seguintes requisitos:

Este guia do desenvolvedor usa o Kit de desenvolvimento nativo (NDK, na sigla em inglês) do Android. Se você não conhece o NDK, consulte a documentação e os exemplos do NDK antes de continuar.

Etapa 1: configurar o ambiente

  1. Baixe o SDK do Android e do Android NDK e extraia-os para sua máquina. Em seu defina SDK_ROOT como o local da pasta do SDK do Android e NDK_ROOT como local da pasta do Android NDK.
  2. Faça o download dos jogos de exemplo para C++. Isso o guia para desenvolvedores se refere ao local das amostras na sua máquina como SAMPLES_DIR.
  3. Faça o download do SDK para C++ dos serviços relacionados a jogos do Google Play. Extraia o na sua máquina de desenvolvimento. No seu ambiente, defina a variável NDK_MODULE_PATH como aponte para o diretório acima do diretório gpg-cpp-sdk. Você precisa ter o seguinte do diretório atual: 
    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 Preferências > Android > NDK (em inglês).

  5. Importe o projeto da biblioteca do Google Play Services para o espaço de trabalho do Eclipse.

    1. No Eclipse, clique em File > Importar > Android > Código do Android já existente no Workspace.
    2. Selecionar 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 minimalista de exemplo para seu espaço de trabalho do Eclipse.

    1. No Eclipse, clique em File > Importar > Android > Código do Android já existente no Workspace.
    2. Selecione SAMPLES_DIR/samples-android/minimalist.
    3. Clique em Finish.

  7. Clique com o botão direito do mouse no projeto MinimalistActivity e clique em Propriedades. Em Android, role a tela até a seção Biblioteca e verifique se o projeto google-play-services_lib está referenciadas. Caso contrário, remova e adicione novamente a referência do seu espaço de trabalho.

O Eclipse compilará automaticamente as fontes Java e Android do projeto. No entanto, a O código nativo na pasta jni precisa ser compilado separadamente. Para fazer isso manualmente, acesse na pasta jni e execute ndk-build. Lembre-se de fazer isso depois de fazer qualquer pasta jni.

Seu projeto será compilado, mas ainda não funcionará. Primeiro, é preciso configurar o jogo no Google Play Console.

Etapa 2: configurar o jogo no Google Play Console

Crie uma entrada para o jogo no Google Play Console. Isso ativa os serviços relacionados a jogos para sua e cria um ID do cliente OAuth 2.0, caso ainda não tenha um.

  1. Crie uma entrada para seu jogo seguindo as etapas descritas em Como configurar os serviços relacionados a jogos do Google Play.
  2. No 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 em todo o projeto depois de fazer essa mudança, especialmente para a classe R gerada.
  3. Abra res/values/ids.xml e insira o ID do app. O ID do aplicativo não é o mesmo que o ID do cliente; é o número ao lado do nome do jogo na página Detalhes do jogo Google Play Console.

Etapa 3: Executar a amostra

Para executar o exemplo, você precisará de um dispositivo Android físico ou um emulador com Google Play Services instalado:

  1. Execute ndk-build para compilar o código nativo.
  2. No Eclipse, clique em Executar > Executar como > Aplicativo para Android e execute o exemplo no seu dispositivo.
  3. Quando o exemplo abrir, toque em qualquer lugar na tela. Você vai encontrar o logotipo do Google Play Games aparecer. Se você configurou o app corretamente, será necessário fazer login.
.

Opcional: como criar automaticamente com o Eclipse

As etapas a seguir mostram como configurar o Eclipse para executar ndk-build automaticamente quando você faça mudanças nos arquivos da pasta jni.

  1. Clique com o botão direito do mouse no projeto MinimalistActivity e clique em Propriedades. Na janela Propriedades, selecione o painel Builders.
  2. Clique em New para adicionar um novo builder, selecione Program e clique em OK.
  3. No campo Nome, insira "NDK Builder".
  4. Em Local, clique em Procurar sistema de arquivos, navegue até o diretório NDK_ROOT e selecione o comando ndk-build.
  5. Em Working Directory, clique em Browse Workspace e selecione a pasta MinimalistActivity na pasta do projeto.
  6. Clique na guia Atualizar. Verifique 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, selecione a pasta jni em MinimalActivity.
  8. Clique em Apply e em OK para concluir a criação do builder.

Agora sempre que você editar um arquivo na pasta jni, o Eclipse executará ndk-build e imprimirá a para o console do Eclipse.