Google Login su Android
Copia un prompt di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.
Introduzione
Sezione intitolata “Introduzione”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.
Usare il login di Google su Android
Sezione intitolata “Usare Google login su Android”In questa parte imparerai a configurare Google login su Android.
-
Crea un client ID per Android.
-
Clicca sulla barra di ricerca
-
Cerca
credentialse clicca sullaAPIs and Servicesquello (numero 2 nello screenshot)
-
Clicca sul
create credentials
-
Seleziona
OAuth client ID
-
Seleziona la
Androidtipo di applicazione
-
Apri Android Studio
-
Nella parte inferiore del navigatore, trova la
Gradle Scripts
-
Trova
build.gradleper il moduloapp
-
Copia il
android.defaultConfig.applicationId. Questo sarà il tuopackage namenella console Google
-
Ora, apri il terminale. Assicurati di essere nella
androidcartella della tua app ed esegui./gradlew signInReport
- Scorri fino all'inizio di questo comando. Dovresti vedere quanto segue. Copia il
SHA1.
- Ora, torna alla Google Console. Inserisci il tuo
applicationIdcomePackage Namee la tua SHA1 nel campo certificato, quindi fai clic sucreate
-
-
Crea un client web (necessario per Android)
-
Vai a
Create credentialspagina nella Google Console -
Imposta il tipo di applicazione su
Web
-
Clicca su
Create
-
Copia il client ID, lo userai come
webClientIdnel tuo JS/TS code
-
-
Modifica il tuo
MainActivity-
Apri la tua app in Android Studio. Puoi eseguire
cap open android -
Trova
MainActivity.java-
Apri la
appcartella
-
Trova
java
-
Trova il tuo
MainActivity.javae fai clic su di esso
-
-
Modifica
MainActivity.java. Aggiungi il seguente codeimport 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 {@Overridepublic 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@Overridepublic void IHaveModifiedTheMainActivityForTheUseWithSocialLoginPlugin() {}} -
Salva il file
-
-
Usa Google Login nella tua applicazione
-
Per prima cosa, importa
SocialLoginimport { SocialLogin } from '@capgo/capacitor-social-login'; -
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',}})}) -
Chiama
SocialLogin.login. Crea un pulsante ed esegui il seguente code al click.const res = await SocialLogin.login({provider: 'google',options: {}})// handle the responseconsole.log(JSON.stringify(res))
-
-
Configura l'emulatore per i test
-
Vai in
Device managere clicca sul pulsante più
-
Crea un dispositivo virtuale
-
Seleziona qualsiasi dispositivo con
Play Storeicona
Come puoi vedere, il
pixel 8supporta ilPlay Storeservizi -
Clicca su
next
-
Assicurati che l'immagine OS sia di tipo
Google Play. DEVE essere di tipoGoogle Play
-
Clicca Avanti
-
Conferma il dispositivo. Puoi dare al tuo emulatore il nome che preferisci
-
Vai in
Device Managere avvia il tuo simulatore
-
Dopo l'avvio del simulatore, vai nelle impostazioni
-
Vai in
Google Play
- Clicca su
Updatee attendi circa 60 secondi
-
-
Testa la tua applicazione
Se hai fatto tutto correttamente, dovresti vedere il flusso di login di Google funzionare correttamente:
Risoluzione problemi
Sezione intitolata “Troubleshooting”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.
Credential Manager, SHA-1 e Firebase
Sezione intitolata “Credential Manager, SHA-1 e Firebase”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.
Configurazione Google Cloud richiesta
Sezione intitolata “Configurazione Google Cloud richiesta”Ti servono due tipi di client ID OAuth 2.0 nello stesso progetto Google Cloud:
| Tipo di client | Utilizzato per | Dove si trova |
|---|---|---|
| Applicazione web | Server / audience dell'ID token | webClientId nella SocialLogin.initialize() |
| Android, uno per chiave di firma | Dimostra che l'APK è autorizzato a chiamare Google | Solo 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 signingReportper 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:
- Verifica
webClientIdè il client ID dell'applicazione Web e termina con.apps.googleusercontent.com. - Avvia l'app, riproduci l'errore e leggi Logcat per
GoogleProvider,signingSha1=, epackage=. - In Google Cloud Console > Credenziali, apri il client OAuth Android e verifica il package name e la SHA-1 esatti.
- Se stai testando una release build, registra la SHA-1 di quella build, non solo quella del debug keystore.
- Se l'app viene distribuita tramite Play Store, registra anche la SHA-1 di Play App Signing.
- Assicurati che i client Web e Android siano nello stesso progetto Google Cloud.
- Se la schermata di consenso è in Testing, conferma che l'account Google sia un utente di test.
- 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.
Estrai lo SHA-1 dalla build che installi
Sezione intitolata “Estrai la SHA-1 dalla build che installi”Debug o build locali:
cd android && ./gradlew signingReportAPK di release firmato:
keytool -printcert -jarfile android/app/release/app-release.apkAggiungi quello SHA-1 a un client OAuth Android con il package name corrispondente, reinstalla lo stesso APK firmato e riprova:
adb install android/app/release/app-release.apkLettura del risultato del login
Sezione intitolata “Lettura del risultato del login”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.
Continua con Google Login su Android
Sezione intitolata “Continua con Google Login su Android”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.