Apple Sign-In Migration zu @capgo/social-login
Kopiere einen Setup-Prompt mit den Installationsschritten und dem vollständigen Markdown-Guide für dieses Plugin.
Übersicht
Abschnitt: „Übersicht“Dieser Leitfaden beschreibt den Wechsel vom veralteten @capacitor-community/apple-sign-in Plugin zum modernen @capgo/capacitor-social-login Paket. Das neue Plugin bietet eine einheitliche Schnittstelle für mehrere Social-Authentifizierungsanbieter mit verbesserter TypeScript-Unterstützung und aktiver Wartung.
Installation
Abschnitt mit dem Titel „Installation“-
Altes Paket entfernen:
Terminalfenster npm uninstall @capacitor-community/apple-sign-in -
Neues Paket installieren:
Terminalfenster npm install @capgo/capacitor-social-loginnpx cap sync
Code Änderungen
Abschnitt mit dem Titel „Code Änderungen“Änderungen importieren
Abschnitt mit dem Titel „Import-Änderungen“import { SignInWithApple } from '@capacitor-community/apple-sign-in';import { SocialLogin } from '@capgo/capacitor-social-login';Initialisierung
Abschnitt mit dem Titel „Initialisierung“Wichtige Änderung: Das neue Plugin erfordert einen Initialisierungsschritt, der zuvor nicht nötig war.
// No initialization needed in old package// For iOS: Basic configurationawait SocialLogin.initialize({ apple: {} // Basic iOS configuration});
// For Android: Additional configuration requiredawait SocialLogin.initialize({ apple: { clientId: 'YOUR_SERVICE_ID', // Service ID from Apple Developer Portal redirectUrl: 'https://your-backend.com/callback' // Your backend callback URL }});Wichtiger Hinweis: Für iOS geben Sie eine Basiskonfiguration an, während Android zusätzliche Angaben wie eine Service ID und eine Backend-Callback-URL für webbasierte OAuth-Authentifizierung benötigt.
Anmelden
Abschnitt „Anmelden“Der Login-Prozess vereinfacht sich von mehreren Parametern zu einem saubereren API:
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' }});Das neue Plugin nutzt login() mit provider: 'apple' und optionale Scopes, anstatt einzelne Konfigurationswerte wie clientId und redirectURI.
Änderungen am Response Type
Abschnitt „Änderungen am Response Type“Die Ergebnisse enthalten nun einen accessToken Objekt mit Ablaufdetails und einer strukturierten profile Abschnitt, der das flachere Antwortformat des ursprünglichen Pakets ersetzt:
// Old response typeinterface AppleSignInResponse { response: { user: string; email: string | null; givenName: string | null; familyName: string | null; identityToken: string | null; authorizationCode: string | null; };}
// New response typeinterface 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; }; };}Neue Capabilities
Abschnitt mit dem Titel „Neue Funktionen“Das aktualisierte Plugin führt Funktionen ein, die im Vorgänger nicht verfügbar waren:
Login-Status prüfen
// Not available in old packageconst status = await SocialLogin.isLoggedIn({ provider: 'apple'});Logout-Funktionalität
// Not available in old packageawait SocialLogin.logout({ provider: 'apple'});Diese Methoden bieten isLoggedIn() um den Authentifizierungsstatus zu überprüfen und logout() Funktionalität.
Plattformspezifische Änderungen
Abschnitt mit dem Titel „Plattformspezifische Änderungen“iOS-Setup
Abschnitt mit dem Titel „iOS Setup“iOS behält die gewohnten Setup-Abläufe über Xcode-Capabilities bei:
- Das iOS Setup bleibt weitgehend gleich. Du musst weiterhin:
- Die „Sign In with Apple“-Capability in Xcode aktivieren
- Deine App im Apple Developer Portal konfigurieren
- Für iOS sind keine zusätzlichen code-Änderungen erforderlich
Android-Setup
Abschnitt „Android Setup“Android erhält jetzt native Unterstützung über webbasierte OAuth-Authentifizierung:
Das neue Plugin bietet Android-Support out of the box, erfordert aber zusätzliche Einrichtung:
- Erstelle eine Services ID im Apple Developer Portal
- Konfiguriere einen Endpoint für die Web-Authentifizierung
- Richte deine Android-App für den OAuth-Flow ein
- Die Konfiguration eines Backend-Service ist erforderlich
Für detaillierte Anweisungen zur Android-Einrichtung siehe die Android-Setup-Anleitung.
Wichtige Vorteile
Abschnitt mit dem Titel „Wichtige Vorteile“Das modernisierte Paket bietet:
- Vereinheitlichte APIs über mehrere Social-Provider (Google, Facebook, Apple) hinweg
- Verbesserte TypeScript-Typisierung mit besseren Typdefinitionen
- Aktive Community-Pflege im Vergleich zur veralteten Version
- Integrierte Android-Unterstützung über webbasierte Authentifizierung
- Persistente Verwaltung des Login-Status
- Bessere Fehlerbehandlung mit konsistenten Fehlertypen
Breaking Changes
Abschnitt mit dem Titel „Breaking Changes“- Explizite Initialisierung ist nun erforderlich - keine Standardkonfiguration
- Struktur des Response-Objekts hat sich geändert - verschachteltes Ergebnisformat
- Android-Implementierung benötigt einen Backend-Dienst für OAuth
- Token-Refresh wird anders gehandhabt - verbessertes Token-Management
- Fehlerbehandlung und Fehlertypen haben sich geändert - detailliertere Fehler
Detaillierte Setup-Anweisungen findest du in der offiziellen Dokumentation.
Weiter geht's von Apple Sign-In Migration zu @capgo/social-login
Abschnitt mit dem Titel „Weiter geht's von Apple Sign-In Migration zu @capgo/social-login“Wenn du es nutzt Apple Sign-In Migration zu @capgo/social-login Um Authentifizierungs- und Account-Flows zu planen, verbinde es mit @capgo/capacitor-social-login verwenden für die native Funktion bei der Verwendung von @capgo/capacitor-social-login, @capgo/capacitor-social-login für die Implementierungsdetails in @capgo/capacitor-social-login, @capgo/capacitor-passkey für die Implementierungsdetails in @capgo/capacitor-passkey, @capgo/capacitor-native-biometric für die Implementierungsdetails in @capgo/capacitor-native-biometric, und Zwei-Faktor-Authentifizierung für die Implementierungsdetails zur Zwei-Faktor-Authentifizierung.