Inizia a usare i servizi per i giochi di Play per C++ su Android

A seguito del ritiro dell'API Google Sign-In, rimuoveremo l'SDK v1 per i giochi nel 2026. Dopo febbraio 2025, non potrai pubblicare su Google Play titoli che sono stati integrati di recente con l'SDK v1 per i giochi. Ti consigliamo di utilizzare l'SDK v2 per i giochi.
Anche se i titoli esistenti integrati in precedenza con l'SDK v1 per i giochi continueranno a funzionare per un paio di anni, ti consigliamo di eseguire la migrazione all'SDK v2 a partire da giugno 2025.
Questa guida riguarda l'utilizzo dell'SDK Play Games Services v1. L'SDK Play Games Services v2 C++ non è ancora disponibile.

Questa guida per gli sviluppatori ti mostrerà come compilare ed eseguire un gioco C++ su Android che utilizza l'API Google Play Game Services. Prima di iniziare, scarica e configura i seguenti requisiti:

Questa guida per gli sviluppatori utilizza l'Android Native Development Kit (NDK). Se non hai familiarità con l'NDK, consulta la documentazione e gli esempi di NDK prima di continuare.

Passaggio 1: configura l'ambiente

  1. Scarica l'SDK Android e l'NDK Android ed estraili sulla tua macchina. Nel tuo ambiente, imposta SDK_ROOT sul percorso della cartella dell'SDK Android e NDK_ROOT sul percorso della cartella dell'NDK Android.
  2. Scarica i giochi di esempio in C++. Questa guida per gli sviluppatori fa riferimento alla posizione dei giochi di esempio sulla tua macchina come SAMPLES_DIR.
  3. Scarica l'SDK Google Play Games Services C++. Estrai l'SDK sulla macchina di sviluppo. Nel tuo ambiente, imposta la variabile NDK_MODULE_PATH in modo che punti alla directory sopra la directory gpg-cpp-sdk. Dovresti avere la seguente struttura di directory: 
    NDK_MODULE_PATH/
gpg-cpp-sdk/
  4. Apri Eclipse. Se non l'hai ancora fatto, indica a Eclipse dove hai installato l'NDK facendo clic su Preferences (Preferenze) > Android > NDK.

  5. Importa il progetto della libreria Google Play Services nel workspace di Eclipse.

    1. In Eclipse, fai clic su File > Import (Importa) > Android > Existing Android Code into Workspace (Codice Android esistente nel workspace).
    2. Seleziona SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib dove SDK_ROOT è la posizione dell'SDK Android.
    3. Fai clic su Finish (Fine).

  6. Importa il progetto di esempio minimalista nel workspace di Eclipse.

    1. In Eclipse, fai clic su File > Import (Importa) > Android > Existing Android Code into Workspace (Codice Android esistente nel workspace).
    2. Seleziona SAMPLES_DIR/samples-android/minimalist.
    3. Fai clic su Finish (Fine).

  7. Fai clic con il tasto destro del mouse sul progetto MinimalistActivity e fai clic su Properties (Proprietà). Nella sezione Android, scorri verso il basso fino alla sezione Library (Libreria) e assicurati che il riferimento al progetto google-play-services_lib sia corretto. In caso contrario, rimuovi il riferimento e aggiungilo di nuovo dal tuo workspace.

Eclipse compilerà automaticamente i codici sorgente Java e Android del tuo progetto; tuttavia, il codice nativo nella cartella jni deve essere compilato separatamente. Per procedere manualmente, vai alla cartella jni ed esegui ndk-build. Ricordati di farlo dopo aver apportato modifiche all'interno della cartella jni.

Ora il progetto dovrebbe essere compilato, anche se non funzionerà ancora. Devi prima configurare il gioco in Google Play Console.

Passaggio 2: configura il gioco in Google Play Console

Crea una voce per il tuo gioco in Google Play Console. In questo modo vengono attivati i servizi per i giochi per la tua applicazione e viene creato un ID client OAuth 2.0, se non ne hai già uno.

  1. Crea una voce per il tuo gioco seguendo i passaggi descritti in Configurazione dell'API Google Play Games Services.
  2. In AndroidManifest.xml, modifica l'attributo package del tag <manifest> con il nome del pacchetto che hai scelto durante la configurazione di Google Play Console. Dopo aver apportato questa modifica, potresti dover correggere alcuni riferimenti in tutto il progetto (in particolare nella classe R generata).
  3. Apri res/values/ids.xml e inserisci l'ID app. Tieni presente che l'ID app non corrisponde all'ID client. Si tratta del numero accanto al nome del gioco nella pagina Dettagli del gioco di Google Play Console.

Passaggio 3: esegui il gioco di esempio

Per eseguire l'esempio, devi disporre di un dispositivo Android fisico o di un emulatore con Google Play Services installato:

  1. Esegui ndk-build per compilare il codice nativo.
  2. In Eclipse, fai clic su Run (Esegui) > Run As (Esegui come) > Android Application (App per Android) ed esegui l'esempio sul tuo dispositivo.
  3. Quando si apre l'esempio, tocca un punto qualsiasi dello schermo. Dovresti visualizzare il logo di Google Play Giochi. Se hai configurato correttamente l'app, ti verrà chiesto di accedere.

(Facoltativo) Crea automaticamente con Eclipse

I passaggi seguenti mostrano come configurare Eclipse per eseguire automaticamente ndk-build quando apporti modifiche ai file nella cartella jni.

  1. Fai clic con il tasto destro del mouse sul progetto MinimalistActivity e fai clic su Properties (Proprietà). Nella finestra Properties (Proprietà), seleziona il riquadro Builders (Builder).
  2. Fai clic su New (Nuovo) per aggiungere un nuovo builder, quindi seleziona Program (Programma) e fai clic su OK (Ok).
  3. Nel campo Name (Nome), inserisci "NDK Builder".
  4. In Location (Posizione), fai clic su Browse File System (Sfoglia file system), quindi vai alla directory NDK_ROOT e seleziona il comando ndk-build.
  5. In Working Directory (Directory di lavoro), fai clic su Browse Workspace (Sfoglia workspace) e seleziona la cartella del progetto MinimalistActivity.
  6. Fai clic sulla scheda Refresh (Aggiorna). Assicurati che la casella Refresh resources upon completion (Aggiorna risorse al termine) sia selezionata.
  7. Seleziona il pulsante di opzione Specific resources (Risorse specifiche) e poi fai clic su Specify Resources (Specifica risorse). Nella finestra di dialogo che si apre, seleziona la cartella jni in MinimalActivity.
  8. Fai clic su Apply (Applica) e poi su OK (Ok) per completare la creazione del builder.

Ora, ogni volta che modifichi un file all'interno della cartella jni, Eclipse eseguirà ndk-build e stamperà l'output nella console di Eclipse.