Vai al contenuto

Migrazione Google Auth a @capgo/social-login

GitHub

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.

  1. Rimuovi il vecchio pacchetto:

    Finestra del terminale
    npm uninstall @codetrix-studio/capacitor-google-auth
  2. Installa il nuovo pacchetto:

    Finestra del terminale
    npm install @capgo/capacitor-social-login
    npx cap sync

Modifiche importanti alla configurazione di Google Auth

Sezione intitolata “Modifiche importanti nella configurazione di Google Auth”

Modifica critica: Il plugin aggiornato richiede l'uso di un Web Client ID su tutte le piattaforme.

Ti servirà:

  1. Creare un Web Client ID in Google Cloud Console se non ne hai già uno (Come ottenere le credenziali)
  2. Usa questo Web Client ID nel campo webClientId per tutte le piattaforme
  3. 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)
import { GoogleAuth } from '@codetrix-studio/capacitor-google-auth';
import { SocialLogin } from '@capgo/capacitor-social-login';

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
}
});
  1. 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() {}
}
  1. Nessuna modifica importante necessaria in AppDelegate.swift (Guida alla configurazione di iOS)

  2. 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
}
}
  1. Rimuovi i meta tag di Google Sign-In dal tuo index.html se li stavi usando:
<meta name="google-signin-client_id" content="{your client id here}" />
<meta name="google-signin-scope" content="profile email" />

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

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.