Migrazione Apple Sign-In a @capgo/social-login

Sintesi

Questa guida descrive la transizione dal plugin legacy al pacchetto moderno. @capacitor-community/apple-sign-in Il nuovo plugin fornisce un'interfaccia unificata per i provider di autenticazione sociale multiple con supporto migliorato per TypeScript e manutenzione attiva. @capgo/capacitor-social-login Installazione

Sottosezione intitolata “Installazione”

1. Elimina il vecchio pacchetto:

   npm uninstall @capacitor-community/apple-sign-in

2. Installa il nuovo pacchetto:

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

Code Modifiche

Importa Modifiche

import { SignInWithApple } from '@capacitor-community/apple-sign-in';
import { SocialLogin } from '@capgo/capacitor-social-login';

Inizializzazione

Cambio Chiave: Il nuovo plugin richiede un passaggio di inizializzazione che non era necessario prima.

// No initialization needed in old package
// For iOS: Basic configuration
await SocialLogin.initialize({
  apple: {} // Basic iOS configuration
});

// For Android: Additional configuration required
await SocialLogin.initialize({
  apple: {
    clientId: 'YOUR_SERVICE_ID', // Service ID from Apple Developer Portal
    redirectUrl: 'https://your-backend.com/callback' // Your backend callback URL
  }
});

Nota Importante: Per iOS, fornite una configurazione di base, mentre Android richiede ulteriori dettagli, inclusa un ID di servizio e un indirizzo di callback backend per l'autenticazione OAuth basata su web.

Accedi

: Il processo di accesso si semplifica da parametri multipli a una API più pulita:

const result = await SignInWithApple.authorize({
  clientId: 'com.your.app',
  redirectURI: 'https://your-app.com/callback',
  scopes: 'email name',
  state: '12345',
  nonce: 'nonce'
});

const result = await SocialLogin.login({
  provider: 'apple',
  options: {
    // Optional: Add scopes if needed
    scopes: ['email', 'name'],
    nonce: 'nonce'
  }
});

: Il nuovo plugin utilizza login() con provider: 'apple' Ecco gli ambiti opzionali e le autorizzazioni anziché passare valori di configurazione individuali come clientId Ecco redirectURI.

Cambiamenti nel tipo di risposta

I risultati includono ora un oggetto con dettagli di scadenza e una struttura accessToken Sostituisci con il contenuto profile Funzionalità nuove

// Old response type
interface AppleSignInResponse {
  response: {
    user: string;
    email: string | null;
    givenName: string | null;
    familyName: string | null;
    identityToken: string | null;
    authorizationCode: string | null;
  };
}

// New response type
interface SocialLoginResponse {
  provider: 'apple';
  result: {
    accessToken: {
      token: string;
      expiresIn?: number;
      refreshToken?: string;
    } | null;
    idToken: string | null;
    profile: {
      user: string;
      email: string | null;
      givenName: string | null;
      familyName: string | null;
    };
  };
}

L'aggiornamento del plugin introduce funzionalità che non erano disponibili nel predecessore:

Copia nel portapenne

Cambiamenti nel tipo di risposta

// Not available in old package
const status = await SocialLogin.isLoggedIn({
  provider: 'apple'
});

Funzionalità di logout

// Not available in old package
await SocialLogin.logout({
  provider: 'apple'
});

Questi metodi forniscono isLoggedIn() per verificare lo stato di autenticazione e logout() funzionalità.

Semplificazioni specifiche per piattaforma

Configurazione per iOS

iOS mantiene procedure di configurazione familiari attraverso le funzionalità di Xcode:

1. La configurazione per iOS rimane sostanzialmente la stessa. È ancora necessario:
   • Abilitare la capacità di "Accedi con Apple" in Xcode
   • Configurare l'app nel Portale dello Sviluppatore Apple
   • Non sono richieste ulteriori code modifiche per iOS

Configurazione per Android

Android ora riceve supporto nativo tramite autenticazione OAuth basata su web:

Il nuovo plugin fornisce supporto per Android di serie, ma richiede una configurazione aggiuntiva:

1. Creare un ID Servizi nel Portale dello Sviluppatore Apple
2. Configurare un endpoint di autenticazione web
3. Configurare l'app Android per gestire il flusso di autenticazione OAuth
4. La configurazione del servizio backend è richiesta

Per istruzioni di configurazione dettagliate per Android, si prega di consultare il Guida di configurazione per Android.

Vantaggi chiave

La versione aggiornata del pacchetto fornisce:

1. API unificate su più provider social (Google, Facebook, Apple)
2. Tipi di tipo migliorati con definizioni di tipo più precise
3. Manutenzione della community attiva rispetto alla versione deprecata
4. Sostegno integrato per Android attraverso l'autenticazione basata sul web
5. Gestione dello stato di accesso persistente
6. Manutenzione degli errori migliorata con tipi di errore coerenti

Modifiche significative

1. L'inizializzazione esplicita è ora richiesta - nessuna configurazione predefinita
2. E' cambiata la struttura dell'oggetto di risposta - formato di risultato nidificato
3. L'implementazione per Android richiede un servizio backend per OAuth
4. Il trattamento dei token di refresh è diverso - gestione dei token migliorata
5. Il trattamento degli errori e i tipi di errore sono cambiati - errori più dettagliati

Per ulteriori istruzioni di configurazione dettagliate, si prega di consultare la documentazione ufficiale.

Continua da Apple Sign-In Migration a @capgo/social-login

Se stai utilizzando Apple Sign-In Migration a @capgo/social-login per pianificare l'autenticazione e le flussi di account, connettilo con Utilizzando @capgo/capacitor-login sociale per la capacità nativa in Utilizzando @capgo/capacitor-login sociale @capgo/capacitor-login sociale per il dettaglio di implementazione in @capgo/capacitor-login sociale @capgo/capacitor-passkey per il dettaglio di implementazione in @capgo/capacitor-passkey @capgo/capacitor-autenticazione biometrica nativa per il dettaglio di implementazione in @capgo/capacitor-autenticazione biometrica nativa, e Autenticazione a due fattori per il dettaglio di implementazione in Autenticazione a due fattori.