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 con le precedenti integrazioni di giochi v1 continueranno a funzionare per un paio di anni, ti consigliamo di eseguire la migrazione alla v2 a partire da giugno 2025.
Questa guida riguarda l'utilizzo dell'SDK v1 dei servizi per i giochi di Play. L'SDK C++ per i servizi per i giochi di Play v2 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:

• Android NDK, revisione 14 o successive.
• SDK Android v10 o versioni successive e ultima versione di Eclipse ADT.
• Sul dispositivo deve essere installato Android 4.0 (livello API 14) o versioni successive.
• L'ultima versione dell'SDK Google Play Services.

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 dell'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 sviluppatori fa riferimento alla posizione degli esempi sulla tua macchina come SAMPLES_DIR.
3. Scarica l'SDK C++ dei servizi per i giochi di Google Play. 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 Preferenze > Android > NDK.

5. Importa il progetto della libreria Google Play Services nel tuo spazio di lavoro Eclipse.

   1. In Eclipse, fai clic su File > Importa > Android > Existing Android Code into 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 Fine.

6. Importa il progetto di esempio minimalista nel tuo spazio di lavoro Eclipse.

   1. In Eclipse, fai clic su File > Importa > Android > Existing Android Code into Workspace.
   2. Seleziona SAMPLES_DIR/samples-android/minimalist.
   3. Fai clic su Fine.

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

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

Ora la compilazione del progetto dovrebbe essere eseguita, 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 di gioco 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 dei servizi per i giochi di Google Play.
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 alla 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 gioco di Google Play Console.

Passaggio 3: esegui il campione

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 Esegui > Esegui come > Applicazione Android ed esegui l'esempio sul tuo dispositivo.
3. Quando si apre il campione, 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.

Importante: assicurati di firmare l'APK con lo stesso certificato di quello di cui hai configurato l'impronta su Google Play Console. In caso contrario, si verificheranno errori.

Importante: se stai testando un gioco non pubblicato, assicurati che l'account con cui intendi accedere (di solito l'account sul dispositivo di test) sia elencato come tester nel progetto. Apri la pagina Test nella scheda secondaria Servizi per i giochi di Google Play Console per controllare o eseguire l'inserimento nella lista consentita. Se non esegui questo passaggio, il server si comporta come se il tuo progetto non esistesse e restituisce errori.

(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 Proprietà. Nella finestra Proprietà, seleziona il riquadro Generatori.
2. Fai clic su Nuovo per aggiungere un nuovo Builder, seleziona Programma e poi fai clic su Ok.
3. Nel campo Nome, inserisci "NDK Builder".
4. In Posizione, fai clic su Sfoglia file system e vai alla directory NDK_ROOT e seleziona il comando ndk-build.
5. In Working Directory (Directory di lavoro), fai clic su Browse Workspace (Sfoglia area di lavoro) e seleziona la cartella del progetto MinimalistActivity.
6. Fai clic sulla scheda Aggiorna. Assicurati che la casella Aggiorna risorse al termine sia selezionata.
7. Seleziona il pulsante di opzione Risorse specifiche e poi fai clic su Specifica risorse. Nella finestra di dialogo risultante, seleziona la cartella jni in MinimalActivity.
8. Fai clic su Applica e poi su Ok per completare la creazione del generatore.

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

Nota :se visualizzi errori durante la modifica di file C o C++ in Eclipse che ti impediscono di creare il progetto, ti consigliamo di disattivare la segnalazione di errori C/C++ in Eclipse. Nelle proprietà del progetto, vai a C/C++ General > Code Analysis > Launching e assicurati che entrambe le caselle siano deselezionate. Poi fai clic su Applica e Ok. Questa è una soluzione alternativa per impedire a Eclipse di controllare il tuo codice nativo, non corregge eventuali errori sottostanti reali.