Vai al contenuto

Google Login su Android

GitHub

In questa guida imparerai a configurare Google Login con Capgo Social Login per Android. Presumo che tu abbia già letto la guida alla configurazione generale.

In questa parte imparerai a configurare Google login su Android.

  1. Crea un client ID per Android.

    1. Clicca sulla barra di ricerca

      Barra di ricerca della Google Console
    2. Cerca credentials e clicca sulla APIs and Services quello (numero 2 nello screenshot)

      Risultati della ricerca che mostrano l'opzione Credentials con APIs and Services evidenziati
    3. Clicca sul create credentials

      Pulsante Create credentials nella Google Console
    4. Seleziona OAuth client ID

      Opzione OAuth client ID nel menu di creazione delle credenziali
    5. Seleziona la Android tipo di applicazione

      Selezione del tipo di applicazione con l'opzione Android evidenziata
    6. Apri Android Studio

    7. Nella parte inferiore del navigatore, trova la Gradle Scripts

      sezione Gradle Scripts nel navigatore del progetto Android Studio
    8. Trova build.gradle per il modulo app

      file build.gradle (Module: app) nella sezione Gradle Scripts
    9. Copia il android.defaultConfig.applicationId. Questo sarà il tuo package name nella console Google

      File build.gradle con la configurazione di applicationId
    10. Ora, apri il terminale. Assicurati di essere nella android cartella della tua app ed esegui ./gradlew signInReport

    Terminale che mostra il comando gradlew signInReport
    1. Scorri fino all'inizio di questo comando. Dovresti vedere quanto segue. Copia il SHA1.
    Output del terminale che mostra l'impronta digitale del certificato SHA1
    1. Ora, torna alla Google Console. Inserisci il tuo applicationId come Package Name e la tua SHA1 nel campo certificato, quindi fai clic su create
    Modulo di creazione del client Android con i campi package name e SHA1 compilati
  2. Crea un client web (necessario per Android)

    1. Vai a Create credentials pagina nella Google Console

    2. Imposta il tipo di applicazione su Web

      Selezione del tipo di applicazione con l'opzione Web evidenziata
    3. Clicca su Create

      Modulo di creazione del client Web con pulsante Create in basso
    4. Copia il client ID, lo userai come webClientId nel tuo JS/TS code

      Dettagli Client ID con il client ID web da copiare
  3. Modifica il tuo MainActivity

    1. Apri la tua app in Android Studio. Puoi eseguire cap open android

    2. Trova MainActivity.java

      1. Apri la app cartella

        Cartella dell'app nel navigatore del progetto di Android Studio
      2. Trova java

        Cartella Java nella struttura del progetto di Android Studio
      3. Trova il tuo MainActivity.java e fai clic su di esso

        File MainActivity.java nella struttura del package
    3. Modifica MainActivity.java. Aggiungi il seguente code

      import ee.forgr.capacitor.social.login.GoogleProvider;
      import ee.forgr.capacitor.social.login.SocialLoginPlugin;
      import ee.forgr.capacitor.social.login.ModifiedMainActivityForSocialLoginPlugin;
      import com.getcapacitor.PluginHandle;
      import com.getcapacitor.Plugin;
      import android.content.Intent;
      import android.util.Log;
      import com.getcapacitor.BridgeActivity;
      // ModifiedMainActivityForSocialLoginPlugin is VERY VERY important !!!!!!
      public class MainActivity extends BridgeActivity implements ModifiedMainActivityForSocialLoginPlugin {
      @Override
      public void onActivityResult(int requestCode, int resultCode, Intent data) {
      super.onActivityResult(requestCode, resultCode, data);
      if (requestCode >= GoogleProvider.REQUEST_AUTHORIZE_GOOGLE_MIN && requestCode < GoogleProvider.REQUEST_AUTHORIZE_GOOGLE_MAX) {
      PluginHandle pluginHandle = getBridge().getPlugin("SocialLogin");
      if (pluginHandle == null) {
      Log.i("Google Activity Result", "SocialLogin login handle is null");
      return;
      }
      Plugin plugin = pluginHandle.getInstance();
      if (!(plugin instanceof SocialLoginPlugin)) {
      Log.i("Google Activity Result", "SocialLogin plugin instance is not SocialLoginPlugin");
      return;
      }
      ((SocialLoginPlugin) plugin).handleGoogleLoginIntent(requestCode, data);
      }
      }
      // This function will never be called, leave it empty
      @Override
      public void IHaveModifiedTheMainActivityForTheUseWithSocialLoginPlugin() {}
      }
    4. Salva il file

  4. Usa Google Login nella tua applicazione

    1. Per prima cosa, importa SocialLogin

      import { SocialLogin } from '@capgo/capacitor-social-login';
    2. Chiama initialize. Questa funzione deve essere chiamata una sola volta.

      // onMounted is Vue specific
      // webClientId is the client ID you got in the web client creation step not the android client ID.
      onMounted(() => {
      SocialLogin.initialize({
      google: {
      webClientId: '673324426943-avl4v9ubdas7a0u7igf7in03pdj1dkmg.apps.googleusercontent.com',
      }
      })
      })
    3. Chiama SocialLogin.login. Crea un pulsante ed esegui il seguente code al click.

      const res = await SocialLogin.login({
      provider: 'google',
      options: {}
      })
      // handle the response
      console.log(JSON.stringify(res))
  5. Configura l'emulatore per i test

    1. Vai in Device manager e clicca sul pulsante più

      Device Manager in Android Studio con il pulsante più evidenziato
    2. Crea un dispositivo virtuale

      Pulsante Create Virtual Device nella Virtual Device Configuration
    3. Seleziona qualsiasi dispositivo con Play Store icona

      Selezione hardware che mostra dispositivi con supporto Play Store

      Come puoi vedere, il pixel 8 supporta il Play Store servizi

    4. Clicca su next

      Next button in device creation wizard
    5. Assicurati che l'immagine OS sia di tipo Google Play. DEVE essere di tipo Google Play

      Selezione immagine di sistema con immagini di tipo Google Play
    6. Clicca Avanti

      Pulsante Avanti nella schermata di selezione immagine di sistema
    7. Conferma il dispositivo. Puoi dare al tuo emulatore il nome che preferisci

      Schermata di verifica configurazione dispositivo con pulsante Fine
    8. Vai in Device Manager e avvia il tuo simulatore

      Device Manager con dispositivo virtuale e pulsante play
    9. Dopo l'avvio del simulatore, vai nelle impostazioni

      Emulatore Android con l'app Impostazioni aperta
    10. Vai in Google Play

    Schermata Impostazioni con l'opzione Google Play
    1. Clicca su Update e attendi circa 60 secondi
    Schermata aggiornamento Google Play con pulsante Aggiorna
  6. Testa la tua applicazione

    Se hai fatto tutto correttamente, dovresti vedere il flusso di login di Google funzionare correttamente:

    Demo del flusso di login Google su Android che mostra il processo di sign-in e l'autenticazione riuscita

In caso di problemi, confronta prima la configurazione della tua app con i valori in Google Cloud Console. Gli errori di Google Sign-In su Android sono di solito causati da un package name, SHA-1 o client ID non corrispondenti.

Su Android questo plugin usa Google Credential Manager (androidx.credentials e Sign in with Google), non quello legacy GoogleSignInClient API. Errori Logcat come GetCredentialCustomException: [28444] Developer console is not set up correctly provengono da quello stack.

Filtra Logcat con GoogleProvider oppure CapgoSocialLogin dopo un login fallito. Il plugin logga il package name, lo SHA-1 di firma e un valore mascherato webClientId così puoi confrontarli con Google Cloud Console.

Ti servono due tipi di client ID OAuth 2.0 nello stesso progetto Google Cloud:

Tipo di clientUtilizzato perDove si trova
Applicazione webServer / audience dell'ID tokenwebClientId nella SocialLogin.initialize()
Android, uno per chiave di firmaDimostra che l'APK è autorizzato a chiamare GoogleSolo Google Cloud Console. Non passare questo ID a webClientId

Un errore comune è usare l'Android client ID come webClientId. Credential Manager richiede il Web client ID. L'Android client ha bisogno solo del package name corretto e della SHA-1 registrata nella console.

Crea un client OAuth Android per ogni certificato che firma i build che testi:

  • Debug: da ./gradlew signingReport per la variante debug.
  • Release: dall'APK o AAB che installi effettivamente.
  • Play App Signing: da Play Console > App integrity > App signing key certificate. È richiesto per i build su Play Store anche se la SHA-1 della tua upload key è già registrata.

Il applicationId nella android/app/build.gradle deve corrispondere esattamente al package name del client OAuth Android, incluso qualsiasi .debug suffisso.

Se la schermata di consenso OAuth è in modalità di test, aggiungi ogni account Google con cui esegui i test sotto Audience > Test users. La pubblicazione dell'app in Production non è richiesta per email e profile scope. Digital Asset Links (assetlinks.json) non sono richiesti per il Sign in with Google tramite Credential Manager.

Le modifiche a Google Cloud possono impiegare alcune ore per propagarsi.

Errore 28444: la console per sviluppatori non è configurata correttamente

Sezione intitolata “Errore 28444: la console per sviluppatori non è configurata correttamente”

Questo quasi sempre significa che Google ha rifiutato la combinazione tra certificato di firma dell'APK installato, package name e webClientId. Segui questa checklist:

  1. Verifica webClientId è il client ID dell'applicazione Web e termina con .apps.googleusercontent.com.
  2. Avvia l'app, riproduci l'errore e leggi Logcat per GoogleProvider, signingSha1=, e package=.
  3. In Google Cloud Console > Credenziali, apri il client OAuth Android e verifica il package name e la SHA-1 esatti.
  4. Se stai testando una release build, registra la SHA-1 di quella build, non solo quella del debug keystore.
  5. Se l'app viene distribuita tramite Play Store, registra anche la SHA-1 di Play App Signing.
  6. Assicurati che i client Web e Android siano nello stesso progetto Google Cloud.
  7. Se la schermata di consenso è in Testing, conferma che l'account Google sia un utente di test.
  8. Aspetta e riprova dopo le modifiche alla console.

USER_CANCELLED dopo aver selezionato un account su una build di debug mal configurata può comunque essere un mismatch di SHA-1 o del client ID. Correggi prima la configurazione della console sopra.

Debug o build locali:

Finestra del terminale
cd android && ./gradlew signingReport

APK di release firmato:

Finestra del terminale
keytool -printcert -jarfile android/app/release/app-release.apk

Aggiungi quello SHA-1 a un client OAuth Android con il package name corrispondente, reinstalla lo stesso APK firmato e riprova:

Finestra del terminale
adb install android/app/release/app-release.apk

I token sono annidati sotto result:

const login = await SocialLogin.login({ provider: 'google' });
const idToken = login.result?.idToken;

Per Firebase Auth, crea le credenziali con quello idToken e usa il Web client ID come webClientId nella initialize.

Se non riesci a ottenere il certificato SHA-1 di sviluppo, prova un keystore personalizzato. Questo commento all'issue spiega come aggiungere un keystore al tuo progetto.

Se stai usando Google Login su Android per pianificare i flussi di autenticazione e account, collegandolo a Utilizzo di @capgo/capacitor-social-login per la funzionalità nativa in Utilizzo di @capgo/capacitor-social-login, @capgo/capacitor-social-login per i dettagli di implementazione in @capgo/capacitor-social-login, @capgo/capacitor-passkey per i dettagli di implementazione in @capgo/capacitor-passkey, @capgo/capacitor-native-biometric per i dettagli di implementazione in @capgo/capacitor-native-biometric, e Autenticazione a due fattori per i dettagli sull'implementazione dell'autenticazione a due fattori.