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 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 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 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 guarda i Github issue.

Inoltre, puoi guardare 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 sul APIs and Services uno (numero 2 nell'immagine di screenshot)
3. Clicca sul create credentials
4. Scegli OAuth client ID
5. Scegli 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 in la 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 alla 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 al 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 inizializza. 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.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 su il tuo backend, memorizza il token di refresh di Google lì, e rinnova su il backend.
Configura l'emulatore per il testing
1. Vai dentro Device manager e clicca sul pulsante più
2. Creare un dispositivo virtuale
3. Seleziona qualsiasi dispositivo con un Play Store icono
  
  Evidentemente, il pixel 8 supporta i 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:

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 spesso 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 Per confrontare le alternative di aggiornamento in tempo reale di Capacitor. webClientId o per migrare verso Appflow.

o per scoprire le funzionalità di Capawesome.

Appflow o

Dopo un tentativo di accesso fallito. Il plugin registra il nome del tuo pacchetto, l'hash SHA-1 di firma e un indirizzo email mascherato	così che puoi confrontarli con quelli del 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	Google Cloud Console solo. Non passa questo ID a `webClientId`

Un errore comune è utilizzare l'ID del client Android come webClientId. Il Manager delle credenziali richiede l'ID del client Web lì. Il client Android ha bisogno solo del nome del pacchetto corretto e della SHA-1 registrati nella console.

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

Debug: da ./gradlew signingReport per la variante di debug.
Release: dal APK o AAB che effettivamente installi.
Play App Signing: da Play Console > Integrità dell'app > Certificato di firma dell'app. Questo è richiesto per le build di Play Store anche se il SHA-1 della chiave di caricamento è già registrato.

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

suffisso. email 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 profile eassetlinks.jsonscopi. Gli Asset Digital (

) non sono necessari per l'accesso con Google tramite il 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 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 l'esatto nome del pacchetto 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 Play App Signing.
Assicurati che i 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 Selezionando un account su un build di debug configurato in modo errato, può 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.

Estrazione del SHA-1 dal build che installi

cd android && ./gradlew signingReport

Copia nel portapenne

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

Copia nel portapenne

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

Il token è inserito 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 riesci a ottenere il certificato SHA-1 di sviluppo, prova con 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-biometria-nativa per il dettaglio di implementazione in @capgo/capacitor-biometria-nativa Autenticazione a due fattori per i dettagli di implementazione in Autenticazione a due fattori.