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 di Google Play Services per i giochi v1 nel 2026. Dopo febbraio 2025, non potrai pubblicare su Google Play titoli appena integrati con l'SDK v1 per i giochi. Ti consigliamo di utilizzare invece l'SDK giochi v2.
Sebbene i titoli esistenti con le integrazioni precedenti della versione 1 dei giochi continuino a funzionare per un paio di anni, ti invitiamo a eseguire la migrazione alla versione 2 a partire da giugno 2025.
Questa guida è dedicata all'utilizzo dell'SDK Play Services v1. L'SDK C++ per la versione 2 dei servizi per i giochi di Google Play non è ancora disponibile.

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

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

Passaggio 1: configura l'ambiente

  1. Scarica l'SDK Android e l'Android NDK ed estraili sulla tua macchina. Nel tuo ambiente, imposta SDK_ROOT sulla posizione della cartella dell'SDK Android e NDK_ROOT sulla posizione della cartella dell'NDK Android.
  2. Scarica i giochi di esempio in C++. In questa guida per gli sviluppatori, la posizione dei sample sulla tua macchina è indicata come SAMPLES_DIR.
  3. Scarica l'SDK C++ dei servizi per i giochi di Google Play. Estrai l'SDK sulla tua macchina di sviluppo. Nel tuo ambiente, imposta la variabile NDK_MODULE_PATH in modo che rimandi 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 già fatto, indica a Eclipse dove hai installato il NDK facendo clic su Preferenze > Android > NDK.

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

    1. In Eclipse, fai clic su File > Importa > Android > Codice Android esistente nello spazio di lavoro.
    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 nello spazio di lavoro Eclipse.

    1. In Eclipse, fai clic su File > Importa > Android > Codice Android esistente nello spazio di lavoro.
    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 poi su Proprietà. In Android, scorri verso il basso fino alla sezione Library e assicurati che il progetto google-play-services_lib sia correttamente richiamato. In caso contrario, rimuovi il riferimento e aggiungilo di nuovo dallo spazio di lavoro.

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

Il progetto ora dovrebbe essere compilato, anche se non funzionerà ancora. Devi prima configurare il tuo 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 Configurare i servizi per i giochi di Google Play.
  2. In AndroidManifest.xml, modifica l'attributo package del tag <manifest> con il nome del pacchetto 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 cliente, ma è il numero accanto al nome del gioco nella pagina Dettagli gioco di Google Play Console.

Passaggio 3: esegui il sample

Per eseguire il sample, 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 il Sample sul tuo dispositivo.
  3. Quando il Sample si apre, tocca un punto qualsiasi dello schermo. Dovresti vedere il logo di Google Play Giochi. Se hai configurato correttamente l'app, ti verrà chiesto di accedere.

(Facoltativo) Esegui la compilazione automaticamente con Eclipse

I passaggi che seguono mostrano come configurare Eclipse in modo che esegua automaticamente ndk-build quando apporti modifiche ai file nella cartella jni.

  1. Fai clic con il tasto destro del mouse sul progetto MinimalistActivity e poi su Proprietà. Nella finestra Proprietà, seleziona il riquadro Generatori.
  2. Fai clic su Nuovo per aggiungere un nuovo generatore, seleziona Programma e poi fai clic su Ok.
  3. Nel campo Nome, inserisci "NDK Builder".
  4. In Posizione, fai clic su Sfoglia file system, vai alla directory NDK_ROOT e seleziona il comando ndk-build.
  5. In Directory di lavoro, fai clic su 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 visualizzata, 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 Eclipse.