Google Login su Android

Copia un prompt di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.

Introduzione

In questo guide, imparerai a configurare l'accesso Google con Capgo Social Login per Android. Assumo che tu abbia già letto la guida di configurazione generale.

In questo capitolo, imparerai a configurare il login Google su Android.

L'ottenimento del certificato SHA1 per Android è un processo molto complicato e non vorrei che nessuno dovesse affrontarlo. I seguenti passaggi si basano sulla situazione più semplice di un'applicazione che non è pubblicata su Google Play Store e che viene utilizzata solo dal simulatore locale o dal dispositivo di sviluppo.

Se hai distribuito il tuo'applicazione su Google Play Store, devi DEVI aggiungere un ID del client Android aggiuntivo che contiene il SHA1 dal Google Play console per le rilasci di produzione. Puoi trovare l'hash SHA1 che Google Play utilizza per firmare il tuo bundle di rilascio sotto Test and release > Setup > App Signing.

È importante menzionare che se commetti un errore, l'errore non sarà evidente. Potrebbe essere molto difficile da debuggare. Se hai difficoltà con la configurazione, per favore consulta il Github issues.

Inoltre, puoi consultare la sezione di troubleshooting della Configurazione del login Google per Android per ulteriori informazioni.

Creare un ID client Android.
1. Clicca sulla barra di ricerca
2. Cerca credentials e clicca sulla APIs and Services una (numero 2 nella schermata)
3. Clicca sulla create credentials
4. Seleziona OAuth client ID
5. Seleziona il Android Tipo di applicazione
6. Apri Android Studio
7. Alla fine della finestra di navigazione, trova la Gradle Scripts
8. Trova build.gradle per il modulo app
9. Copia il android.defaultConfig.applicationIdQuesto sarà il tuo package name in il console di Google
10. Ora, apri il terminale. Assicurati di essere nel android del tuo app e esegui ./gradlew signInReport
1. Scorri verso l'alto di questo comando. Dovresti vedere il seguente. Copia il SHA1.
1. Ora, torna indietro nel Console di Google. Inserisci il tuo applicationId come il Package Name e il tuo SHA1 nella casella del certificato e clicca create
Creare un client web (questo è richiesto per Android)
1. Vai alla Create credentials pagina nel Console di Google
2. Imposta il tipo di applicazione su Web
3. Clicca su Create
4. Copia l'ID del client, utilizzerai questo come il webClientId in tuo JS/TS code

Modifica il tuo MainActivity

Per favore apri il tuo app in Android Studio. Puoi eseguire cap open android
Cerca MainActivity.java
1. Apre il app cartella
2. Cerca java
3. Cerca il tuo MainActivity.java e clicca su di esso

Modifica MainActivity.java. Per favore 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() {}
}

Salva il file

Utilizza Google Login nel tuo'applicazione
1. Prima, importa SocialLogin
```
import { SocialLogin } from '@capgo/capacitor-social-login';
```
2. Chiamare initialize. Questo deve essere chiamato solo una 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. Chiamare SocialLogin.login. Create a button and run the following code on click.
```
const res = await SocialLogin.login({
  provider: 'google',
  options: {}
})
// handle the response
console.log(JSON.stringify(res))
```
  If inizializzi Google con mode: 'offline', SocialLogin.login() ritorna serverAuthCode per il flusso di scambio del tuo backend. Non chiamare SocialLogin.refresh({ provider: 'google' }) in app in quel modo. Scambia serverAuthCode nel tuo backend, memorizza il token di rinfresco di Google lì, e rinfresca sul backend.
Configura l'emulatore per il testing
1. Vai in Device manager e clicca sul pulsante plus
2. Creare un dispositivo virtuale
3. Scegli qualsiasi dispositivo con un Play Store icono
  
  Evidentemente, il pixel 8 supporta i Play Store servizi
4. Clicca next
5. context":"Pagina/Area: Capgo Builder / prodotto di costruzione cloud nativa. Ruolo: Etichetta di navigazione breve o elemento UI. Chiave di messaggio `native_build_builder_credit_next` (Crediti del costruttore di costruzione nativa)." Google Play. Assicurati che l'immagine del sistema sia del tipo DEVE ESSERE Google Play
6. Selezione dell'immagine del sistema che mostra immagini di tipo Google Play
7. Conferma il tuo dispositivo. Puoi chiamare il tuo emulatore come preferisci
8. Entrare in Device Manager E avviare il tuo simulatore
9. Dopo che il simulatore si è avviato, entra nelle sue impostazioni
10. Entrare in Google Play
1. Clicca Update E attendi circa 60 secondi
Testa la tua applicazione

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

Risolvere i problemi

Se hai dei problemi, confronta per primo la configurazione della tua app con i valori del Cloud Console di Google. Le fallite di Google Sign-In su Android sono di solito causate da un nome del pacchetto, un SHA-1 o un ID client non corrispondenti.

Manager delle credenziali, SHA-1 e Firebase

Sul sistema operativo Android, questo plugin utilizza il Manager delle credenziali di Google (androidx.credentials e Accedi con Google), non il legacy GoogleSignInClient API. Errore di Logcat come GetCredentialCustomException: [28444] Developer console is not set up correctly da quella pila.

Filtra Logcat con GoogleProvider o CapgoSocialLogin o webClientId per poterli confrontare con il Cloud Console di Google.

Impostazione Cloud di Google richiesta

Avete bisogno di due tipi di ID client OAuth 2.0 nello stesso progetto Cloud di Google:

Tipo di client	Utilizzato per	Dove va
Applicazione web	Server / ID token audience	`webClientId` in `SocialLogin.initialize()`
su Android, uno per chiave di firma	Prova che il tuo APK è autorizzato a chiamare Google	solo nel Cloud Console di Google. Non passare questo ID a `webClientId`

Un errore comune è utilizzare l'ID del client Android come webClientId. Il Credential Manager richiede l'ID del client Web lì. Il client Android ha bisogno solo del nome del pacchetto corretto e della chiave SHA-1 registrata nel console.

Creare un client OAuth Android per ogni certificato che firma le build che si testano:

Da ./gradlew signingReport per la variante di debug.
Da l'APK o AAB che si installa effettivamente.
Da Play App Signing: da Play Console > Integrità dell'app > Chiave di firma dell'app. Questo è richiesto per le build di Play Store anche se la chiave SHA-1 di caricamento è già registrata.

Il applicationId in android/app/build.gradle deve corrispondere esattamente al nome del pacchetto Android OAuth client, compresi eventuali .debug suffisso.

Se lo schermo di consenso OAuth è in modalità Testing, aggiungi ogni account Google che testi sotto Audience > Utenti di test. La pubblicazione dell'applicazione in Produzione non è necessaria per email e profile scopi. I collegamenti di asset digitali (assetlinks.json) non sono necessari per l'accesso con Google tramite Gestore delle credenziali.

Le modifiche a Cloudflare possono richiedere fino a poche ore per propagarsi.

Errore 28444: Il console dello sviluppatore non è configurato correttamente

Ciò accade quasi sempre quando Google rifiuta la combinazione del certificato di firma APK installato, del nome del pacchetto e webClientId. Esegui questo checklist:

Conferma webClientId è il client ID dell'applicazione Web e si conclude con .apps.googleusercontent.com.
Esegui l'app, riproduci il problema e leggi Logcat per GoogleProvider, signingSha1=, e package=.
In Google Cloud Console > Credenziali, apri il tuo client OAuth Android e verifica il pacchetto esatto e SHA-1.
Se stai testando una versione di rilascio, registra il SHA-1 di quella versione, non solo il keystore di debug.
Se l'app è distribuita attraverso Play Store, registra anche il SHA-1 di firma dell'app di Play.
Assicurati che gli client Web e Android siano presenti nello stesso progetto Google Cloud.
Se lo schermo di consenso è in modalità di testing, conferma che l'account Google sia un utente di testing.
Attendi e riprova dopo le modifiche al console.

USER_CANCELLED Dopo aver scelto un account su un build di debug configurato male, può ancora esserci un mismatch SHA-1 o ID del client. Correggi prima la configurazione del console sopra.

Estrai il SHA-1 dal build che installi.

Build di debug o locali:

cd android && ./gradlew signingReport

APK di rilascio firmata:

keytool -printcert -jarfile android/app/release/app-release.apk

Aggiungi quel SHA-1 a un client OAuth Android con lo stesso nome del pacchetto, reinstalla lo stesso APK firmato e prova di nuovo:

adb install android/app/release/app-release.apk

I token sono nidificati sotto result:

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

Per Firebase Auth, crea le credenziali con questo idToken e utilizza l'ID del client Web come webClientId in initialize.

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

Se stai utilizzando Google Login su Android per pianificare l'autenticazione e le flussi di account, connettilo con Utilizzando @capgo/capacitor-login-social per la capacità nativa in Utilizzando @capgo/capacitor-login-social @capgo/capacitor-login-social per il dettaglio di implementazione in @capgo/capacitor-login-social @capgo/capacitor-passkey per il dettaglio di implementazione in @capgo/capacitor-passkey @capgo/capacitor-biometric-nativo per il dettaglio di implementazione in @capgo/capacitor-biometric-nativo, e Autenticazione a due fattori per il dettaglio di implementazione in Autenticazione a due fattori.