Risoluzione dei problemi relativi ai servizi per i giochi di Play nei giochi Android

Questa pagina descrive come risolvere i problemi che potresti riscontrare durante lo sviluppo di giochi per Android con i servizi per i giochi di Google Play.

Logging

Per risolvere i problemi relativi al gioco, puoi attivare il logging dettagliato sul dispositivo utilizzando il comando adb shell. Puoi quindi visualizzare i messaggi di log di Google Play Games Services utilizzando logcat.

Abilita il logging

Per abilitare il logging sul dispositivo di test:

1. Collega il dispositivo a una macchina su cui è installato SDK Android.

2. Apri un terminale ed esegui questo comando:

   adb shell setprop log.tag.Games VERBOSE

3. Esegui il gioco sul dispositivo e riproduci il problema di cui stai tentando di eseguire il debug.

4. Visualizza i log:

   adb logcat

Disabilita il logging

Per disabilitare il logging dettagliato per i Play Games Services sul dispositivo e ripristinare il comportamento di logging originale, esegui il seguente comando:

adb shell setprop log.tag.Games INFO

Impossibile eseguire l'autenticazione

Se non riesci ad autenticare i giocatori nel tuo gioco, assicurati innanzitutto di aver seguito le istruzioni per creare gli ID client e configurare i servizi per i giochi. Se continui a riscontrare errori di autenticazione, controlla i seguenti elementi per assicurarti che il gioco sia configurato correttamente.

Controlla i tag dei metadati

Il file AndroidManifest.xml deve contenere un tag dei metadati dei giochi. Per verificare che i tag dei metadati siano configurati correttamente:

1. Apri AndroidManifest.xml e verifica che contenga un tag meta-data come mostrato di seguito:

   <meta-data android:name="com.google.android.gms.games.APP_ID"
       android:value="@string/app_id" />
   

2. Individua la definizione della risorsa @string/app_id. Di solito è definita in un file XML che si trova nella directory res/xml, ad esempio res/xml/strings.xml o res/xml/ids.xml.

3. Verifica che il valore della risorsa @string/app_id corrisponda all'ID numerico dell'applicazione. Il valore di questa risorsa deve contenere solo cifre. Ad esempio:

   <string name="app_id">123456789012</string>
   

Controlla il nome del pacchetto

Il nome del pacchetto del gioco deve corrispondere al nome del pacchetto dell'ID client. Per verificare il nome del pacchetto:

1. Apri AndroidManifest.xml e verifica che il nome del pacchetto del gioco sia corretto. Il nome del pacchetto è il valore dell'attributo package nel tag manifest.

2. Verifica il nome del pacchetto che hai fornito durante la creazione dell'ID client. Per verificare il nome del pacchetto in Google Play Console, vai a Play Console e fai clic sulla voce corrispondente al tuo gioco.

3. Vai alla scheda App collegate ed esamina l'elenco degli ID client. In questo elenco dovrebbe essere presente un'app Android collegata il cui nome del pacchetto corrisponde al nome del pacchetto in AndroidManifest.xml. Se non c'è corrispondenza, crea un nuovo ID client con il nome del pacchetto corretto e riprova a eseguire l'autenticazione.

Controlla la fingerprint del certificato

Il certificato con cui stai autenticando il gioco deve corrispondere alla fingerprint del certificato associata all'ID client. Per verificarlo, controlla innanzitutto la fingerprint SHA1 del certificato come segue:

1. Trova il file del certificato e ottieni la relativa fingerprint SHA1. Per ottenere la fingerprint SHA1, esegui questo comando:

   keytool -exportcert -alias your-key-name -keystore /path/to/your/keystore/file -list -v
   

2. Prendi nota della sequenza di cifre esadecimali etichettata SHA1: nell'output. Questa è la fingerprint del certificato.

Poi, verifica che lo strumento di build utilizzi questo certificato:

1. Genera l'APK del gioco dallo strumento di build e firmalo con il certificato desiderato. Copia l'APK generato in una directory temporanea.

2. Nella directory temporanea, esegui il seguente comando per decomprimere l'APK.

   unzip YourGame.apk
   

3. Genera una chiave privata utilizzando un file di certificato RSA:

   keytool -printcert -file META-INF/CERT.RSA
   

   In alternativa, puoi generare la chiave privata utilizzando un file di certificato DSA:

   keytool -printcert -file META-INF/CERT.DSA
   

4. Prendi nota della sequenza di cifre esadecimali nella riga etichettata SHA1:.

   Questa sequenza di cifre deve corrispondere alla fingerprint del certificato del passaggio precedente. Se non c'è corrispondenza, lo strumento di build o il sistema non è configurato per firmare l'applicazione con il certificato. In questo caso, consulta la documentazione dell'ambiente di build per determinare come configurarlo correttamente e riprova a eseguire l'autenticazione.

Poi, verifica se la fingerprint del certificato corrisponde alla fingerprint configurata nell'ID client. Per farlo:

1. Apri Play Console e vai al tuo gioco.
2. Nella pagina Dettagli del gioco, scorri verso il basso e fai clic sul link al progetto Google Cloud Platform collegato.
3. Seleziona il progetto.
4. Nella barra laterale a sinistra, seleziona API e autenticazione. Assicurati che lo stato dell'API dei servizi per i giochi di Google Play sia ON nell'elenco delle API visualizzato.
5. Nella barra laterale a sinistra, seleziona App registrate.
6. Espandi la sezione ID client OAuth 2.0 e prendi nota della fingerprint del certificato (SHA1).

Se questa fingerprint non corrisponde alla fingerprint del certificato dei passaggi precedenti, devi creare un nuovo ID client con la fingerprint del certificato corretta. Devi creare il nuovo ID client in Play Console, non nel progetto Google Cloud Platform.

Verifica che gli account di test siano abilitati

Prima della pubblicazione di un gioco, l'account che ha creato il gioco in Play Console deve essere abilitato anche come tester. Per verificare che sia configurato correttamente:

1. Apri Play Console e vai al tuo gioco.
2. Apri la scheda Test.
3. Verifica che l'account con cui stai tentando di eseguire l'autenticazione sia presente nell'elenco dei tester.

Se l'account con cui stai tentando di eseguire l'autenticazione non è presente nell'elenco, aggiungilo, attendi qualche minuto e riprova a eseguire l'autenticazione.

    ImageManager im = ...;

    // Anonymous listener -- dangerous:
    im.loadImage(new ImageManager.OnImageLoadedListener() {
        @Override
        public void onImageLoaded(Uri uri, Drawable drawable) {
            // ...code...
        }
    }

    public class MyActivity extends Activity
            implements ImageManager.OnImageLoadedListener {

        private void loadOurImages() {
            ImageManager im = ...;
            im.loadImage(this);
        }

        @Override
        public void onImageLoaded(Uri uri, Drawable drawable) {
            // ...code...
        }
    }