Ti diamo il benvenuto nello sviluppo di giochi per Android con i servizi Google Play Giochi.
L'SDK Play Games fornisce i servizi Google Play Giochi multipiattaforma che ti consentono di integrare facilmente funzionalità di gioco popolari come obiettivi, classifiche e giochi salvati nei tuoi giochi per tablet e dispositivi mobili.
Questo corso ti guiderà nell'installazione di un'applicazione di gioco di esempio per Android e ti aiuterà a iniziare rapidamente a creare il tuo gioco per Android. L'app di esempio Sfida Type-a-Number mostra come integrare obiettivi e classifiche nel tuo gioco.
Prima di iniziare
Per preparare l'app, completa i passaggi nelle sezioni seguenti.
Prerequisiti dell'app
Assicurati che il file di compilazione dell'app utilizzi i seguenti valori:
- Un
minSdkVersion
di19
o superiore - Un
compileSdkVersion
di28
o superiore
Configurare il gioco in Google Play Console
In Google Play Console puoi gestire i servizi per i giochi di Google Play per il tuo gioco e configurare i metadati per autorizzare e autenticare il gioco. Per maggiori informazioni, consulta la sezione Configurare i servizi per i giochi di Google Play.
Configura la tua app
Nel file build.gradle
a livello di progetto, includi
il repository Maven di Google
e il repository centrale Maven
in entrambe le sezioni buildscript
e allprojects
:
buildscript {
repositories {
google()
mavenCentral()
}
}
allprojects {
repositories {
google()
mavenCentral()
}
}
Aggiungi la dipendenza da Google Play Services per l'SDK Play Games al file di build Gradle del modulo, che in genere è app/build.gradle
:
dependencies {
implementation 'com.google.android.gms:play-services-games:23.2.0'
}
Guida all'app di esempio
Questo corso ti guiderà nell'installazione di un'app di gioco di esempio per Android e ti aiuterà a iniziare rapidamente a creare il tuo gioco per Android. L'app di esempio Sfida Type-a-Number mostra come integrare obiettivi e classifiche nel tuo gioco.
Passaggio 1: scarica l'app di esempio
Per questa guida per gli sviluppatori, dovrai scaricare l'applicazione Android di esempio della Sfida Digita un numero.
Per scaricare e configurare l'applicazione di esempio in Android Studio:
- Scarica i sample per Android dalla pagina di download dei sample.
- Importa il progetto
android-basic-samples
. Questo progetto includeTypeANumber
e altri sample di giochi Android. Per farlo in Android Studio:- Fai clic su File > Importa progetto.
- Vai alla directory in cui hai scaricato
android-basic-samples
sulla tua macchina di sviluppo. Seleziona il fileandroid-basic-samples/build.gradle
e fai clic su OK.
- Nel modulo
TypeANumber
, apriAndroidManifest.xml
e modifica il nome del pacchetto dacom.google.example.games.tanc
con un altro nome di pacchetto. Il nuovo nome del pacchetto non deve iniziare concom.google
,com.example
ocom.android
.
Passaggio 2: configura il gioco in Google Play Console
In Google Play Console puoi gestire i servizi per i giochi di Google Play per il tuo gioco e configurare i metadati per l'autorizzazione e l'autenticazione del tuo gioco.
Per configurare il gioco di esempio in Google Play Console:
- Apri Google Play Console con il browser web e accedi. Se non hai mai eseguito la registrazione a Google Play Console, ti verrà chiesto di farlo.
- Segui queste istruzioni per aggiungere il tuo gioco a Google Play Console.
- Quando ti viene chiesto se utilizzi API di Google nella tua app, seleziona Non uso ancora API di Google nel mio gioco.
- Ai fini di questa guida per gli sviluppatori, puoi compilare il modulo con i tuoi dettagli sul gioco. Per praticità, puoi utilizzare le icone segnaposto e gli screenshot forniti nella pagina Download.
- Segui queste istruzioni per generare un ID client OAuth 2.0 per la tua app per Android.
- Quando colleghi la tua app per Android, assicurati di specificare il nome esatto del pacchetto che hai utilizzato in precedenza durante la ridenominazione del pacchetto di esempio.
- Puoi utilizzare la procedura guidata Genera APK firmato in Android Studio per generare un nuovo archivio chiavi e un nuovo certificato firmato, se non ne hai già uno. Per scoprire come eseguire la procedura guidata di generazione dell'APK firmato, consulta Firma dell'app in Android Studio.
- Assicurati di registrare le seguenti informazioni per riferimento futuro:
- ID applicazione: si tratta di una stringa composta solo da cifre (in genere almeno 12 cifre) all'inizio dell'ID client.
- Il certificato di firma: prendi nota del certificato utilizzato durante la configurazione dell'accesso all'API (il certificato di cui hai fornito l'impronta SHA1). Devi utilizzare lo stesso certificato per firmare l'app durante il test o il rilascio.
- Configura i traguardi per la Sfida Digita un numero:
- Seleziona la scheda Obiettivi in Google Play Console.
- Aggiungi i seguenti obiettivi di esempio:
Nome Descrizione Istruzioni speciali Primo Ottenere un punteggio che è un numero primo. Assente Umile Richiedi un punteggio pari a 0. Assente Non fare lo spavaldo, ragazzo Richiedi un punteggio di 9999 in entrambe le modalità. Assente OMG U R TEH UBER LEET! Ricevere un punteggio di 1337. Rendi questo obiettivo nascosto. Noia Gioca 10 volte. Crea un obiettivo incrementale con 10 passaggi da sbloccare. Molto molto annoiato Gioca 100 volte. Crea un obiettivo incrementale con 100 passaggi da sbloccare. - Registra gli ID (stringhe alfanumeriche lunghe) di ogni obiettivo che hai creato.
- Configura gli obiettivi appropriati per il tuo gioco. Per scoprire di più, consulta i concetti alla base degli obiettivi e come implementarli in Android.
- Configura le classifiche per la sfida Digita un numero:
- Seleziona la scheda Classifiche in Google Play Console.
- Aggiungi due classifiche di esempio: una denominata "Punti più alti facili" e un'altra "Punti più alti difficili". Entrambe le classifiche devono utilizzare la formattazione del punteggio intero con 0 cifre decimali e un tipo di ordinamento Più è alto, meglio è.
- Registra gli ID (lunghe stringhe alfanumeriche) per ogni classifica che hai creato.
- Configura le classifiche appropriate per il tuo gioco. Per scoprire di più, consulta i concetti alla base delle classifiche e come implementare le classifiche in Android.
- Aggiungi account di prova per il tuo gioco. Questo passaggio è necessario solo per le app che non sono ancora state pubblicate in Google Play Console. Prima della pubblicazione dell'app, solo gli account di test elencati in Google Play Console possono accedere. Tuttavia, una volta pubblicata un'applicazione, chiunque può accedere.
Passaggio 3: modifica il codice
Per eseguire il gioco, devi configurare l'ID applicazione come risorsa nel tuo progetto Android. Dovrai anche aggiungere i metadati dei giochi in AndroidManifest.xml
.
- Apri
res/values/ids.xml
e sostituisci gli ID segnaposto. Se stai creando un gioco per Android da zero, dovrai prima creare questo file.- Specifica l'ID applicazione nella risorsa
app_id
. - Specifica ogni ID traguardo che hai creato in precedenza nella risorsa
achievement_*
corrispondente. - Specifica ogni ID classifica creato in precedenza nella risorsa
leaderboard_*
corrispondente.
- Specifica l'ID applicazione nella risorsa
- Apri
AndroidManifest.xml
e inserisci il nome del pacchetto nell'attributopackage
dell'elemento <manifest
>. Se stai creando un gioco per Android da scatto, assicurati di aggiungere anche il seguente codice all'interno dell'elemento <application
>:<meta-data android:name="com.google.android.gms.games.APP_ID" android:value="@string/app_id" /> <meta-data android:name="com.google.android.gms.version" android:value="@integer/google_play_services_version"/>
Passaggio 4: testa il gioco
Per assicurarti che i servizi per i giochi di Google Play funzionino correttamente nel tuo gioco, testa l'applicazione prima di pubblicarla su Google Play.
Per eseguire il gioco sul dispositivo di test fisico:
- Verifica di aver configurato l'account di prova che utilizzi per accedere all'app (come descritto nel passaggio 2).
- Esporta un APK e firmalo con lo stesso certificato che hai utilizzato per configurare il progetto in Google Play Console. Per esportare un APK firmato in Android Studio, fai clic su Build > Genera APK firmato.
- Installa l'APK firmato sul tuo dispositivo di test fisico utilizzando lo strumento
adb
. Per scoprire come installare un'applicazione, consulta Eseguire su un dispositivo.