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 Android con Google Play Games Services.

Logging

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

Abilita il logging

Per attivare il logging sul dispositivo di test:

  1. Collega il dispositivo a un computer su cui è installato l'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 logging

Per disattivare il logging dettagliato per i Play Games Services sul tuo dispositivo e ripristinare il comportamento di logging originale, esegui questo 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 tuo AndroidManifest.xml deve contenere un tag dei metadati dei giochi. Per verificare che i tag dei metadati siano configurati correttamente:

  1. Apri il tuo 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. In genere è definito 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 della tua 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 tuo gioco deve corrispondere al nome del pacchetto nel tuo 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 a quello nel tuo AndroidManifest.xml. Se non c'è corrispondenza, crea un nuovo ID client con il nome del pacchetto corretto e prova a eseguire nuovamente l'autenticazione.

Controlla il fingerprint del certificato

Il certificato con cui autentichi il gioco deve corrispondere al fingerprint del certificato associato al tuo ID client. Per verificarlo, controlla innanzitutto l'impronta SHA-1 del certificato come segue:

  1. Trova il file del certificato e ottieni la relativa fingerprint SHA-1. Per ottenere l'impronta SHA-1, 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 etichettate come SHA1: nell'output. Questo è il fingerprint del certificato.

A questo punto, verifica che lo strumento di build utilizzi questo certificato:

  1. Genera l'APK del gioco dallo strumento di build e firmalo con il certificato che preferisci. Copia l'APK generato in una directory temporanea.
  2. Nella directory temporanea, esegui questo comando per estrarre 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 sulla riga con l'etichetta SHA1:.

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

Successivamente, controlla se il fingerprint del certificato corrisponde a quello configurato nel tuo ID client. Per:

  1. Apri Play Console e vai al tuo gioco.
  2. Nella pagina Dettagli gioco, vai in fondo e fai clic sul link al progetto cloud collegato.
  3. Seleziona il progetto.
  4. Nella barra laterale a sinistra, seleziona API e autenticazione. Assicurati che lo stato dell'API Google Play Games Services sia ON nell'elenco delle API visualizzato.
  5. Nella barra laterale a sinistra, seleziona Registered apps (App registrate).
  6. Espandi la sezione ID client OAuth 2.0 e prendi nota del fingerprint del certificato (SHA1).

Se questa fingerprint non corrisponde a quella 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.

Verifica che gli account di test siano abilitati

Prima che un gioco venga pubblicato, l'account che lo ha creato in Play Console deve essere attivato anche come tester. Per verificare che la configurazione sia corretta:

  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 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.

Problemi di ProGuard

Se utilizzi Proguard e visualizzi errori nell'APK offuscato, controlla il livello API target nel file AndroidManifest.xml. Assicurati di impostarlo su 17 o un valore superiore.

Altre cause di problemi di configurazione

Verifica la presenza di altre cause comuni di errori:

  • Se il tuo gioco è pubblicato, verifica che siano pubblicate anche le relative impostazioni (è possibile pubblicare l'applicazione senza pubblicare le impostazioni dei giochi). Per farlo, vai su Google Play Console, accedi alla tua app e verifica che la casella accanto al nome del gioco indichi che è pubblicato. Se indica che si trova in un altro stato, ad esempio "Pronto per la pubblicazione" o "Pronto per il test", fai clic sulla casella e seleziona Pubblica gioco.
  • Se non riesci a pubblicare il gioco, verifica che esattamente uno degli ID client abbia l'opzione Questa app è preferita per le nuove installazioni attivata.

Ascoltatori anonimi

Non utilizzare listener anonimi. I listener anonimi sono implementazioni di un'interfaccia listener definite in linea, come illustrato di seguito.

    ImageManager im = ...;

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

I listener anonimi non sono affidabili perché l'SDK Play Giochi li mantiene come riferimenti deboli, il che significa che potrebbero essere recuperati dal garbage collector prima di essere richiamati. Dovresti invece implementare il listener utilizzando un oggetto persistente come Activity.

    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...
        }
    }