Migrazione Google Auth a @capgo/social-login
Copia un prompt di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.
Panoramica
Sezione intitolata “Panoramica”Questa guida fornisce i passaggi dettagliati per migrare da @codetrix-studio/capacitor-google-auth a @capgo/capacitor-social-login, garantendo una transizione fluida e un'esperienza di autenticazione migliorata. Il nuovo plugin unifica più provider di autenticazione social sotto un unico API coerente.
Installazione
Sezione intitolata “Installazione”-
Rimuovi il vecchio pacchetto:
Finestra del terminale npm uninstall @codetrix-studio/capacitor-google-auth -
Installa il nuovo pacchetto:
Finestra del terminale npm install @capgo/capacitor-social-loginnpx cap sync
Modifiche importanti alla configurazione di Google Auth
Sezione intitolata “Modifiche importanti nella configurazione di Google Auth”Requisito del Web Client ID
Sezione intitolata “Requisito del Web Client ID”Modifica critica: Il plugin aggiornato richiede l'uso di un Web Client ID su tutte le piattaforme.
Ti servirà:
- Creare un Web Client ID in Google Cloud Console se non ne hai già uno (Come ottenere le credenziali)
- Usa questo Web Client ID nel campo
webClientIdper tutte le piattaforme - Per Android, devi comunque creare un Android Client ID con la tua SHA1, ma solo a scopo di verifica: il token non verrà utilizzato (Guida alla configurazione di Android)
Modifiche di Code
Sezione intitolata “Modifiche di Code”Modifiche agli import
Sezione intitolata “Modifiche agli import”import { GoogleAuth } from '@codetrix-studio/capacitor-google-auth';import { SocialLogin } from '@capgo/capacitor-social-login';Inizializzazione
Sezione intitolata “Inizializzazione”La configurazione passa da una semplice GoogleAuth.initialize() chiamata a una struttura più SocialLogin.initialize() con configurazione Google annidata:
GoogleAuth.initialize({ clientId: 'CLIENT_ID.apps.googleusercontent.com', scopes: ['profile', 'email'], grantOfflineAccess: true,});
await SocialLogin.initialize({ google: { webClientId: 'WEB_CLIENT_ID.apps.googleusercontent.com', // Use Web Client ID for all platforms iOSClientId: 'IOS_CLIENT_ID', // for iOS mode: 'offline' // replaces grantOfflineAccess }});Il metodo di login passa da GoogleAuth.signIn() a SocialLogin.login() con specificazione esplicita del provider:
const user = await GoogleAuth.signIn();const res = await SocialLogin.login({ provider: 'google', options: { scopes: ['email', 'profile'], forceRefreshToken: true // if you need refresh token }});Modifiche specifiche per piattaforma
Sezione intitolata “Modifiche specifiche per piattaforma”Android
Sezione intitolata “Android”- Aggiorna il tuo
MainActivity.java(Guida completa alla configurazione di Android):
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;
public class MainActivity extends BridgeActivity { 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); } }
public void IHaveModifiedTheMainActivityForTheUseWithSocialLoginPlugin() {}}-
Nessuna modifica importante necessaria in AppDelegate.swift (Guida alla configurazione di iOS)
-
Aggiorna la configurazione in
capacitor.config.json, non lo usiamo nel nuovo plugin:
{ "plugins": { "GoogleAuth": { "scopes": ["profile", "email"], "serverClientId": "xxxxxx-xxxxxxxxxxxxxxxxxx.apps.googleusercontent.com", "forceCodeForRefreshToken": true }}- Rimuovi i meta tag di Google Sign-In dal tuo
index.htmlse li stavi usando:
<meta name="google-signin-client_id" content="{your client id here}" /><meta name="google-signin-scope" content="profile email" />Modifiche al Response Type
Sezione intitolata “Modifiche al tipo di risposta”La risposta di autenticazione fornisce ora un oggetto strutturato contenente informazioni sul provider, access token, ID token e dati del profilo utente:
interface GoogleLoginResponse { provider: 'google'; result: { accessToken: { token: string; expires: string; // ... other token fields } | null; idToken: string | null; profile: { email: string | null; familyName: string | null; givenName: string | null; id: string | null; name: string | null; imageUrl: string | null; }; };}La struttura della risposta include:
- provider: identifica il provider di autenticazione (
'google') - result.accessToken: Dettagli dell'access token con scadenza
- result.idToken: ID token per l'autenticazione
- result.profile: Informazioni sul profilo utente, tra cui email, nome e URL dell'immagine
Funzionalità aggiuntive
Sezione intitolata “Funzionalità aggiuntive”Il nuovo pacchetto supporta più provider di autenticazione sociale oltre a Google:
Questo approccio unificato offre:
- API coerente per tutti i provider
- Supporto TypeScript migliorato
- Gestione degli errori migliorata
- Manutenzione attiva e supporto della community
Consulta la documentazione principale per istruzioni dettagliate di configurazione per questi provider aggiuntivi.
Continua dalla migrazione di Google Auth a @capgo/social-login
Sezione intitolata “Continua dalla migrazione di Google Auth a @capgo/social-login”Se stai usando Migrazione Google Auth a @capgo/social-login 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.