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

Attenzione: questa guida è destinata all'uso di Play Giochi Services v1. L'SDK C e le relative indicazioni per la versione 2 dei servizi per i giochi di Play saranno disponibili a breve. Nel frattempo, puoi trovare maggiori informazioni sulla versione 2 nella guida di accesso. Se volete testare la nuova versione dell'SDK, contattate il vostro contatto Google per ulteriori informazioni.

Prima di iniziare

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

• Android NDK, revisione 14 o successive.
• SDK Android 10 o versioni successive e la versione più recente di Eclipse ADT.
• Sul dispositivo deve essere in esecuzione Android 4.0 (livello API 14) o versioni successive.
• La versione più recente dell'SDK di Google Play Services.

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

Passaggio 1: configura l'ambiente

1. Scarica l'SDK Android e l'NDK di Android ed estraili sul tuo computer. Nel tuo ambiente, imposta SDK_ROOT sulla posizione della cartella dell'SDK Android e NDK_ROOT sulla posizione della cartella NDK di Android.
2. Scarica i giochi di esempio C++. Questa guida per gli sviluppatori si riferisce 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 nella tua 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, comunica a Eclipse dove hai installato NDK facendo clic su Preferenze > Android > NDK.

5. Importa il progetto della libreria di Google Play Services nell'area di lavoro di Eclipse.

   1. In Eclipse, fai clic su File > Importa > Android > Codice Android esistente in Workspace.
   2. Seleziona SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib, dove SDK_ROOT è la località del tuo SDK Android.
   3. Fai clic su Fine.

6. Importa il progetto minimalista di esempio nell'area di lavoro Eclipse.

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

7. Fai clic con il tasto destro del mouse sul progetto minimalistaActivity e fai clic su Proprietà. In Android, scorri verso il basso fino alla sezione Raccolta e assicurati che il riferimento al progetto google-play-services_lib sia corretto. In caso contrario, rimuovi il riferimento e aggiungilo di nuovo dall'area di lavoro.

Eclipse completerà automaticamente le origini Java e Android del 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 eseguire questa operazione dopo aver apportato modifiche nella cartella jni.

Il tuo progetto 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, abiliti i servizi per i giochi nella tua applicazione e crei un ID client OAuth 2.0, se non ne hai già uno.

1. Crea una voce per il tuo gioco seguendo la procedura descritta nella pagina 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 che hai scelto durante la configurazione di Google Play Console. Dopo aver apportato questa modifica, potresti dover correggere alcuni riferimenti durante il progetto (in particolare nella classe R generata).
3. Apri res/values/ids.xml e inserisci lì il tuo ID app. Tieni presente che l'ID app non corrisponde all'ID client; è il numero accanto al nome del tuo gioco nella pagina Dettagli del gioco di Google Play Console.

Passaggio 3: esegui l'esempio

Per eseguire l'esempio è necessario un dispositivo Android fisico o un emulatore di Google Play Services installati:

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

Importante: assicurati di firmare il tuo APK con lo stesso certificato di quello la cui impronta è stata configurata su Google Play Console. In caso contrario, verranno generati errori.

Importante: se stai testando un gioco non pubblicato, assicurati che l'account con cui intendi effettuare l'accesso (in genere l'account sul dispositivo di test) sia elencato come tester nel progetto. Apri la pagina Test nella sottoscheda Servizi per i giochi di Google Play Console per controllare o eseguire l'autorizzazione. Se non esegui questo passaggio, il server agisce come se il progetto non esistesse e restituirà errori.

Facoltativo: creare automaticamente con Eclipse

I seguenti passaggi 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 minimalistaActivity e fai clic su Proprietà. Nella finestra Proprietà, seleziona il riquadro Builder.
2. Fai clic su Nuovo per aggiungere un nuovo builder e seleziona Programma, quindi 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 Directory di lavoro, fai clic su Sfoglia area di lavoro e seleziona la cartella di progetto L'attività minimalista.
6. Fai clic sulla scheda Refresh (Aggiorna). Assicurati che la casella Aggiorna risorse al termine sia selezionata.
7. Seleziona il pulsante di opzione Risorse specifiche, quindi fai clic su Specifica risorse. Nella finestra di dialogo dei risultati, seleziona la cartella jni in Attività minima.
8. Fai clic su Applica, quindi su OK per completare la creazione del builder.

Ora, ogni volta che modifichi un file all'interno della cartella jni, Eclipse eseguirà ndk-build e stamparà l'output in Eclipse Console.

Nota: se riscontri errori durante la modifica dei file C o C++ in Eclipse che ti impediscono di creare il progetto, potresti voler disabilitare i report sugli errori C/C++ in Eclipse. Nelle proprietà del progetto, vai a C/C++ General > Analisi del codice > Avvio e assicurati che entrambe le caselle siano deselezionate. Fai clic su Applica e OK. Questa è una soluzione alternativa per impedire a Eclipse di controllare il codice nativo e non correggere gli eventuali errori sottostanti.