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
- 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 eNDK_ROOT
sulla posizione della cartella NDK di Android. - Scarica i giochi di esempio C++. Questa guida per gli sviluppatori si riferisce alla posizione degli esempi sulla tua macchina come
SAMPLES_DIR
. - 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 directorygpg-cpp-sdk
. Dovresti avere la seguente struttura di directory:NDK_MODULE_PATH/ gpg-cpp-sdk/
- Apri Eclipse. Se non l'hai ancora fatto, comunica a Eclipse dove hai installato NDK facendo clic su Preferenze > Android > NDK.
Importa il progetto della libreria di Google Play Services nell'area di lavoro di 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 località del tuo SDK Android. - Fai clic su Fine.
Importa il progetto minimalista di esempio 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 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.
- Crea una voce per il tuo gioco seguendo la procedura descritta nella pagina Configurare i servizi per i giochi di Google Play.
- In
AndroidManifest.xml
, modifica l'attributopackage
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 classeR
generata). - 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:
- Esegui
ndk-build
per compilare il codice nativo. - In Eclipse, fai clic su Run > Run As > Android Application (Esegui come > App per Android) ed esegui l'esempio sul tuo dispositivo.
- 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.
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
.
- Fai clic con il tasto destro del mouse sul progetto minimalistaActivity e fai clic su Proprietà. Nella finestra Proprietà, seleziona il riquadro Builder.
- Fai clic su Nuovo per aggiungere un nuovo builder e seleziona Programma, quindi fai clic su OK.
- Nel campo Nome, inserisci "NDK Builder".
- In Posizione, fai clic su Sfoglia file system e vai alla directory
NDK_ROOT
e seleziona il comandondk-build
. - In Directory di lavoro, fai clic su Sfoglia area di lavoro e seleziona la cartella di progetto L'attività minimalista.
- Fai clic sulla scheda Refresh (Aggiorna). Assicurati che la casella Aggiorna risorse al termine sia selezionata.
- 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. - 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.