Accesso Google su Android

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

Introduzione

In questo guide, imparerai a configurare il login con 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'hash SHA1 per Android è un incubo e non vorrei che nessuno dovesse passare per questo. I passaggi seguenti presuppongono lo scenario più semplice di un'applicazione non pubblicata su Google Play Store e utilizzata solo dal simulatore locale o dal dispositivo di sviluppo.

Se hai distribuito il tuo app sul Google Play Store, devi DEVI aggiungere un ID di client Android aggiuntivo che contiene l'hash SHA1 del Google Play console per le rilasci di produzione. Puoi trovare l'hash SHA1 utilizzato da Google Play 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, consulta il Github issues.

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

Crea un ID client Android.
1. Clicca sulla barra di ricerca
2. Cerca credentials e clicca sul APIs and Services uno (numero 2 nella schermata)
3. Clicca sul create credentials
4. Seleziona OAuth client ID
5. Seleziona il Android tipo di applicazione
6. Apre Android Studio
7. Al fondo della finestra di navigazione, trova la Gradle Scripts
8. Cerca build.gradle per il modulo app
9. Copia il android.defaultConfig.applicationIdQuesto sarà il tuo package name nel 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 al Console di Google. Inserisci il tuo applicationId come il Package Name e il tuo SHA1 nel campo del certificato e clicca create
Crea 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 your JS/TS code

__CAPGO_KEEP_0__ 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 nella tua applicazione
1. In primo luogo, importa SocialLogin
```
import { SocialLogin } from '@capgo/capacitor-social-login';
```
2. Chiamare initialize. Questo dovrebbe 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.loginCrea un pulsante e esegui il seguente code al 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 su il 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 più
2. Creare un dispositivo virtuale
3. Scegli qualsiasi dispositivo con un Play Store icon
  
  Come puoi vedere, il pixel 8 supporta il Play Store servizi
4. Clicca next
5. Assicurati che l'immagine del sistema sia del tipo Google Play. DEVE essere del tipo Google Play
6. Clicca successivo
7. Conferma il tuo dispositivo. Puoi chiamare il tuo emulatore come preferisci
8. Entrare in Device Manager E avviare il tuo simulatore
9. Dopo l'avvio del simulatore, 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:

Risoluzione dei problemi

Se hai 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 spesso causate da un nome del pacchetto, un SHA-1 o un ID client non corrispondenti.

Gestore delle credenziali, SHA-1 e Firebase

Su Android, questo plugin utilizza il Gestore 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 Per confrontare le alternative di aggiornamento in tempo reale di Capacitor. webClientId o per migrare verso Appflow.

o per scoprire come Capawesome può aiutarti.

Appflow o

Dopo un fallito accesso. Il plugin registra il tuo nome del pacchetto, l'hash SHA-1 di firma e un mascherato	così puoi confrontarli con il Cloud Console di Google.	Configurazione Google Cloud richiesta
Sezione intitolata “Configurazione Google Cloud richiesta”	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 registrati nel console.

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

Da ./gradlew signingReport per la variante di debug.
Da l'APK o AAB che effettivamente installi.
Da Play Console > App integrity > App signing key certificate. Questo è richiesto per le build di Play Store anche se il tuo upload key SHA-1 è già registrato.

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

Se lo schermo di consenso OAuth è in modalità Testing, aggiungi ogni account Google che testi sotto Utenti > Test. email La pubblicazione dell'applicazione in produzione non è necessaria per profile eassetlinks.jsonscopi. Gli Asset Digital (

) non sono necessari per l'accesso con Google tramite Gestore delle credenziali.

I cambiamenti di Cloudflare possono richiedere fino a poche ore per propagarsi.

Sottosezione intitolata “Errore 28444: Console dello sviluppatore non configurata correttamente” webClientId. Passa a questo checklist:

Conferma webClientId è il codice cliente 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 > Credentials, apri il tuo client OAuth Android e verifica il nome 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 test.
Attendi e riprova dopo le modifiche al console.

USER_CANCELLED Selezionando un account su un build di debug configurato male, potrebbe ancora esserci un disallineamento tra 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 riprova:

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 Utilizza @capgo/capacitor-login-social per la capacità nativa in Utilizza @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-biometrica-nativa per il dettaglio di implementazione in @capgo/capacitor-biometrica-nativa Autenticazione a due fattori per la dettagliata implementazione in Autenticazione a due fattori.