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

Prima di iniziare

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

Questa guida per gli sviluppatori utilizza Android Native Development Kit (NDK). Se non conosci 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 di Android ed estraili sul tuo computer. Nel tuo imposta SDK_ROOT sulla posizione della cartella SDK Android e NDK_ROOT sul posizione della tua cartella NDK di Android.
  2. Scarica i giochi di esempio C++. Questo nella guida per gli sviluppatori si intende la posizione dei campioni sul computer come SAMPLES_DIR.
  3. Scarica l'SDK C++ dei servizi per i giochi di Google Play. Estrai il SDK sul tuo computer di sviluppo. Nel tuo ambiente, imposta la variabile NDK_MODULE_PATH su Punta alla directory sopra la directory gpg-cpp-sdk. Dovresti avere quanto segue struttura della directory: 
    NDK_MODULE_PATH/
gpg-cpp-sdk/
  4. Apri Eclissi. Se non l'hai ancora fatto, comunica a Eclipse dove hai installato l'NDK facendo clic su Preferenze > Android > NDK

  5. Importa il progetto della libreria di Google Play Services nell'area di lavoro 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 posizione del tuo SDK Android.
    3. Fai clic su Fine.

  6. Importa il progetto di esempio minimalista 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 MinimalistActivity e fai clic su Proprietà. In Android, scorri. fino alla sezione Libreria e assicurati che il progetto google-play-services_lib sia correttamente a cui viene fatto riferimento. In caso contrario, rimuovi il riferimento e aggiungilo di nuovo dall'area 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 a la cartella jni ed esegui ndk-build. Ricorda di farlo dopo aver apportato modifiche nella cartella jni.

Il progetto dovrebbe essere compilato, anche se non funzionerà ancora. Devi prima configurare il gioco nella 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 attivi i servizi per i giochi per il tuo e crea un ID client OAuth 2.0, se non ne hai già uno.

  1. Crea una voce per il tuo gioco seguendo i passaggi descritti nella sezione Configurazione dei servizi per i giochi di Google Play.
  2. In AndroidManifest.xml, modifica l'attributo package del tag <manifest> in nome del pacchetto che hai scelto durante la configurazione di Google Play Console. Potresti dover correggere alcuni riferimenti in tutto il progetto dopo aver apportato questa modifica (in particolare alla classe R generata).
  3. Apri res/values/ids.xml e inserisci lì il tuo ID app. Tieni presente che l'ID app non corrisponde a l'ID client; il numero accanto al nome del gioco nella pagina Dettagli del gioco di Google Play Console.

Passaggio 3: esegui l'esempio

Per eseguire il Sample avrai bisogno 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 dispositivo.
  3. Quando l'anteprima si apre, tocca un punto qualsiasi della schermata. Dovresti vedere un logo di Google Play Giochi vengono visualizzate. Se hai configurato correttamente l'app, ti verrà chiesto di eseguire l'accesso.

(Facoltativo) Creare automaticamente con Eclipse

I passaggi seguenti ti mostrano come configurare Eclipse in modo che venga eseguito automaticamente ndk-build quando apportare modifiche ai file nella cartella jni.

  1. Fai clic con il pulsante destro del mouse sul progetto MinimalistActivity e fai clic su Proprietà. Nella finestra Proprietà, seleziona il riquadro Builder.
  2. Fai clic su New (Nuovo) per aggiungere un nuovo Builder, seleziona Program (Programma) e fai clic su Ok (Ok).
  3. Nel campo Nome, inserisci "NDK Builder".
  4. In Posizione, fai clic su Sfoglia file system e passa alla directory NDK_ROOT e seleziona il comando ndk-build.
  5. In Directory di lavoro, fai clic su Sfoglia area di lavoro e seleziona MinimalistActivity cartella del progetto.
  6. Fai clic sulla scheda Aggiorna. Assicurati che la casella Aggiorna risorse al completamento sia selezionata.
  7. Seleziona il pulsante di opzione Risorse specifiche e fai clic su Specifica risorse. Nella Seleziona la cartella jni in MinimalActivity.
  8. Fai clic su Applica e poi su OK per completare la creazione di Builder.

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