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

Após a descontinuação da API Login do Google, vamos remover o SDK dos serviços relacionados a jogos v1 em 2026. A partir de fevereiro de 2025, não será mais possível publicar no Google Play títulos que foram integrados ao SDK dos serviços relacionados a jogos do Google Play V1. Recomendamos que você use o SDK do Google Play Games v2.
Embora os títulos atuais com as integrações anteriores da v1 de jogos continuem funcionando por alguns anos, recomendamos que você migre para a v2 a partir de junho de 2025.
Este guia é para usar o SDK dos serviços relacionados a jogos do Google Play v1. O SDK C++ para os serviços relacionados a jogos do Google Play v2 ainda não está disponível.

Este guia para desenvolvedores mostra como compilar e executar um jogo em C++ no Android que usa a API dos serviços relacionados a jogos do Google Play. Antes de começar, faça o download e configure os seguintes requisitos:

Este guia para desenvolvedores usa o Kit de desenvolvimento nativo do Android (NDK). 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. Faça o download do SDK do Android e do NDK do Android e extraia-os 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 NDK do Android.
  2. Faça o download dos jogos de exemplo em C++. Este guia para desenvolvedores se refere à localização 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 SDK na sua 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ê precisa ter a seguinte estrutura de diretórios: 
    NDK_MODULE_PATH/
gpg-cpp-sdk/
  4. Abra o Eclipse. Se você ainda não fez isso, informe ao Eclipse onde o NDK foi instalado clicando em Preferências > Android > NDK.

  5. Importe o projeto da biblioteca do Google Play Services para a área de trabalho do Eclipse.

    1. No Eclipse, clique em Arquivo > Importar > Android > Código Android existente no espaço de trabalho.
    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 seu espaço de trabalho do Eclipse.

    1. No Eclipse, clique em Arquivo > Importar > Android > Código Android existente no espaço de trabalho.
    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 para baixo até a seção Biblioteca e confira se o projeto google-play-services_lib está referenciado corretamente. Se não, remova a referência e adicione-a novamente do seu espaço de trabalho.

O Eclipse compila 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. Faça isso depois de fazer mudanças na pasta jni.

Agora, o projeto vai ser compilado, mas ainda não vai funcionar. Primeiro, configure seu 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 seu aplicativo e cria um ID do cliente OAuth 2.0, se você ainda não tiver um.

  1. Para criar uma entrada para o jogo, siga as etapas descritas em Configuração dos serviços relacionados a jogos do Google Play.
  2. Em AndroidManifest.xml, mude o atributo package da tag <manifest> para o nome do pacote escolhido ao configurar o Google Play Console. Talvez seja necessário corrigir algumas referências em todo o projeto depois de fazer essa mudança, principalmente na classe R gerada.
  3. Abra o res/values/ids.xml e coloque o ID do app lá. O ID do app não é o mesmo que o ID do cliente. Ele é 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ê vai 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 a amostra no seu dispositivo.
  3. Quando a amostra abrir, toque em qualquer lugar da tela. O logotipo do Google Play Games vai aparecer. Se você configurou o app corretamente, será necessário fazer login.

Opcional: criar automaticamente com o Eclipse

As etapas a seguir mostram como configurar o Eclipse para executar automaticamente ndk-build quando você fizer 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 Novo para adicionar um novo Builder, selecione Programa 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 Diretório de trabalho, clique em Procurar espaço de trabalho e selecione a pasta do projeto MinimalistActivity.
  6. Clique na guia Atualizar. 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 MinimalActivity.
  8. Clique em Aplicar e em OK para concluir a criação do Builder.

Agora, sempre que você editar um arquivo na pasta jni, o Eclipse vai executar ndk-build e imprimir a saída no console do Eclipse.