Migración de inicio de sesión de Apple a @capgo/social-login

Resumen

Esta guía describe la transición desde el plugin legado al paquete moderno. @capacitor-community/apple-sign-in El nuevo plugin proporciona una interfaz unificada para múltiples proveedores de autenticación social con un mejor soporte de TypeScript y mantenimiento activo. @capgo/capacitor-social-login Instalación

Sección titulada “Instalación”

1. Quitar el paquete antiguo:

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

2. Instalar el nuevo paquete:

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

Code Cambios

Importar Cambios

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

Iniciación

Key Change: El nuevo plugin requiere un paso de inicialización que no se necesitaba antes.

// 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: Para iOS, proporciona configuración básica, mientras que Android requiere detalles adicionales, incluido un ID de Servicio y una URL de llamada de backend para la autenticación de OAuth basada en web.

Iniciar sesión

El proceso de inicio de sesión se simplifica desde múltiples parámetros a una API: más limpia.

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'
  }
});

El nuevo plugin utiliza login() con provider: 'apple' y ámbitos opcionales en lugar de pasar valores de configuración individuales como clientId y redirectURI.

Tipo de respuesta modificada

Los resultados ahora incluyen un accessToken objeto con detalles de expiración y un formato estructurado profile sección, reemplazando el formato de respuesta plano del paquete original:

// 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;
    };
  };
}

Nuevas capacidades

El plugin actualizado introduce funcionalidad que no estaba disponible en el predecesor:

Verificar el estado de inicio de sesión

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

Funcionalidad de cierre de sesión

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

Estos métodos proporcionan isLoggedIn() para verificar el estado de autenticación y logout() funcionalidad.

Cambios específicos de plataforma

Configuración de iOS

iOS mantiene procedimientos de configuración familiares a través de capacidades de Xcode:

1. The iOS setup remains largely the same. You still need to:
   • Habilitar la capacidad de 'Iniciar sesión con Apple' en Xcode
   • Configurar su aplicación en el Portal del Desarrollador de Apple
   • No se requieren cambios adicionales code para iOS

Configuración de Android

Android ahora recibe soporte nativo a través de la autenticación de OAuth basada en web:

El nuevo plugin proporciona soporte de Android de forma predeterminada, pero requiere configuración adicional:

1. Crear un ID de Servicio en el Portal del Desarrollador de Apple
2. Configurar un punto de conexión de autenticación web
3. Configurar su aplicación de Android para manejar el flujo de OAuth
4. La configuración del servicio de backend es requerida

Para obtener instrucciones de configuración de Android detalladas, consulte el Guía de Configuración de Android.

Ventajas clave

El paquete modernizado proporciona:

1. APIs unificadas en múltiples proveedores sociales (Google, Facebook, Apple)
2. Mejores definiciones de tipos de TypeScript con mejoras en las definiciones de tipos
3. Mantenimiento de la comunidad activa en comparación con la versión depreciada
4. Compatibilidad integrada con Android a través de la autenticación basada en web
5. Gestión del estado de inicio de sesión persistente
6. Mejor manejo de errores con tipos de errores consistentes

Cambios significativos

1. Se requiere inicialización explícita - no hay configuración predeterminada
2. La estructura del objeto de respuesta ha cambiado - formato de resultado anidado
3. Se requiere un servicio de backend para la implementación de Android para OAuth
4. El manejo de refresco de tokens es diferente - mejor gestión de tokens
5. El manejo de errores y los tipos de errores han cambiado - errores más detallados

Para obtener instrucciones de configuración más detalladas, consulte la documentación oficial.

Siga adelante desde la migración de inicio de sesión de Apple a @capgo/social-login

Si está utilizando Migración de inicio de sesión de Apple a @capgo/social-login para planificar la autenticación y los flujos de cuenta, conéctelo con Usando @capgo/capacitor-login-social para la capacidad nativa en Usando @capgo/capacitor-login-social, @capgo/capacitor-login-social para el detalle de implementación en @capgo/capacitor-login-social, @capgo/capacitor-passkey para el detalle de implementación en @capgo/capacitor-passkey, @capgo/capacitor-biométrico-nativo para el detalle de implementación en @capgo/capacitor-biométrico-nativo, y Autenticación de dos factores para el detalle de implementación en Autenticación de dos factores.