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:
- Android NDK, revisione 14 o successive.
- SDK per Android versione 10 o successiva e ultima versione di Eclipse ADT.
- Il dispositivo deve eseguire Android 4.0 (livello API 14) o versioni successive.
- La versione più recente dell'SDK Google Play Services.
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
- 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 eNDK_ROOT
sul posizione della tua cartella NDK di Android. - Scarica i giochi di esempio C++. Questo
nella guida per gli sviluppatori si intende la posizione dei campioni sul computer come
SAMPLES_DIR
. - 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 directorygpg-cpp-sdk
. Dovresti avere quanto segue struttura della directory:NDK_MODULE_PATH/ gpg-cpp-sdk/
- Apri Eclissi. Se non l'hai ancora fatto, comunica a Eclipse dove hai installato l'NDK facendo clic su Preferenze > Android > NDK
Importa il progetto della libreria di Google Play Services nell'area di lavoro Eclipse.
- In Eclipse, fai clic su File > Importa > Android > Codice Android esistente in Workspace.
- Seleziona
SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib
doveSDK_ROOT
è la posizione del tuo SDK Android. - Fai clic su Fine.
Importa il progetto di esempio minimalista nell'area di lavoro Eclipse.
- In Eclipse, fai clic su File > Importa > Android > Codice Android esistente in Workspace.
- Seleziona
SAMPLES_DIR/samples-android/minimalist
. - Fai clic su Fine.
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.
- Crea una voce per il tuo gioco seguendo i passaggi descritti nella sezione Configurazione dei servizi per i giochi di Google Play.
- In
AndroidManifest.xml
, modifica l'attributopackage
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 classeR
generata). - 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:
- Esegui
ndk-build
per compilare il codice nativo. - In Eclipse, fai clic su Esegui > Esegui come > Applicazione Android ed esegui l'esempio sul dispositivo.
- 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
.
- Fai clic con il pulsante destro del mouse sul progetto MinimalistActivity e fai clic su Proprietà. Nella finestra Proprietà, seleziona il riquadro Builder.
- Fai clic su New (Nuovo) per aggiungere un nuovo Builder, seleziona Program (Programma) e fai clic su Ok (Ok).
- Nel campo Nome, inserisci "NDK Builder".
- In Posizione, fai clic su Sfoglia file system e passa alla directory
NDK_ROOT
e seleziona il comandondk-build
. - In Directory di lavoro, fai clic su Sfoglia area di lavoro e seleziona MinimalistActivity cartella del progetto.
- Fai clic sulla scheda Aggiorna. Assicurati che la casella Aggiorna risorse al completamento sia selezionata.
- Seleziona il pulsante di opzione Risorse specifiche e fai clic su Specifica risorse. Nella
Seleziona la cartella
jni
in MinimalActivity. - 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.