Migrasi Apple Sign-In ke @capgo/social-login
Salin prompt setup yang berisi langkah install dan panduan markdown lengkap untuk plugin ini.
Ikhtisar
Bagian berjudul “Ringkasan”Panduan ini menjelaskan transisi dari @capacitor-community/apple-sign-in plugin lama ke @capgo/capacitor-social-login package modern. Plugin baru ini menyediakan interface terpadu untuk berbagai provider autentikasi sosial dengan dukungan TypeScript yang lebih baik dan pemeliharaan aktif.
Instalasi
Bagian berjudul “Instalasi”-
Hapus package lama:
Jendela terminal npm uninstall @capacitor-community/apple-sign-in -
Install package baru:
Jendela terminal npm install @capgo/capacitor-social-loginnpx cap sync
Perubahan Code
Bagian berjudul “Perubahan Code”Perubahan Import
Bagian berjudul “Perubahan Import”import { SignInWithApple } from '@capacitor-community/apple-sign-in';import { SocialLogin } from '@capgo/capacitor-social-login';Inisialisasi
Bagian berjudul “Inisialisasi”Perubahan Utama: Plugin baru memerlukan langkah inisialisasi yang sebelumnya tidak diperlukan.
// 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 }});Catatan Penting: Untuk iOS, Anda cukup menyediakan konfigurasi dasar, sedangkan Android memerlukan detail tambahan termasuk Service ID dan URL callback backend untuk autentikasi OAuth berbasis web.
Proses login disederhanakan dari beberapa parameter menjadi API yang lebih bersih:
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' }});Plugin baru menggunakan login() dengan provider: 'apple' dan scopes opsional, bukan meneruskan nilai konfigurasi individual seperti clientId dan redirectURI.
Perubahan Response Type
Bagian berjudul “Perubahan Response Type”Hasil sekarang mencakup accessToken objek dengan detail kedaluwarsa dan profile bagian terstruktur, menggantikan format respons yang lebih datar dari paket aslinya:
// 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; }; };}Kemampuan Baru
Bagian berjudul “Kemampuan Baru”Plugin yang diperbarui menghadirkan fungsionalitas yang tidak tersedia di versi sebelumnya:
Cek Status Login
// Not available in old packageconst status = await SocialLogin.isLoggedIn({ provider: 'apple'});Fungsionalitas Logout
// Not available in old packageawait SocialLogin.logout({ provider: 'apple'});Metode ini menyediakan isLoggedIn() untuk memverifikasi status autentikasi dan logout() fungsionalitas.
Perubahan Khusus Platform
Bagian berjudul “Perubahan Khusus Platform”Setup iOS
Bagian berjudul “iOS Setup”iOS mempertahankan prosedur setup yang familiar melalui capability Xcode:
- Setup iOS sebagian besar tetap sama. Anda tetap perlu:
- Aktifkan capability “Sign In with Apple” di Xcode
- Konfigurasikan aplikasi Anda di Apple Developer Portal
- Tidak perlu perubahan code tambahan untuk iOS
Setup Android
Bagian berjudul “Android Setup”Android kini menerima dukungan native melalui autentikasi OAuth berbasis web:
Plugin baru menyediakan dukungan Android secara bawaan, tetapi memerlukan konfigurasi tambahan:
- Buat Services ID di Apple Developer Portal
- Konfigurasi endpoint autentikasi web
- Atur aplikasi Android Anda untuk menangani alur OAuth
- Konfigurasi layanan backend diperlukan
Untuk instruksi setup Android yang terperinci, silakan lihat Panduan Setup Android.
Keunggulan Utama
Bagian berjudul “Keunggulan Utama”Paket yang dimodernisasi menyediakan:
- API terpadu di berbagai penyedia sosial (Google, Facebook, Apple)
- Typing TypeScript yang lebih baik dengan definisi tipe yang lebih baik
- Pemeliharaan komunitas yang aktif dibandingkan versi yang tidak didukung lagi
- Dukungan Android bawaan melalui autentikasi berbasis web
- Manajemen status login yang persisten
- Penanganan error yang lebih baik dengan tipe error yang konsisten
Perubahan Penting
Bagian berjudul “Breaking Changes”- Inisialisasi eksplisit kini wajib dilakukan - tidak ada konfigurasi default
- Struktur objek Response telah berubah - format result bersarang
- Implementasi Android memerlukan layanan backend untuk OAuth
- Penanganan refresh token kini berbeda - manajemen token yang lebih baik
- Penanganan dan tipe error telah berubah - error yang lebih detail
Untuk instruksi setup yang lebih detail, silakan lihat dokumentasi resmi.
Lanjutkan dari Migrasi Apple Sign-In ke @capgo/social-login
Bagian berjudul “Lanjutkan dari Migrasi Apple Sign-In ke @capgo/social-login”Jika Anda menggunakan Migrasi Apple Sign-In ke @capgo/social-login untuk merencanakan alur autentikasi dan akun, hubungkan dengan Menggunakan @capgo/capacitor-social-login untuk kapabilitas native di Menggunakan @capgo/capacitor-social-login, @capgo/capacitor-social-login untuk detail implementasi di @capgo/capacitor-social-login, @capgo/capacitor-passkey untuk detail implementasi di @capgo/capacitor-passkey, @capgo/capacitor-native-biometric untuk detail implementasi di @capgo/capacitor-native-biometric, dan Autentikasi dua faktor untuk detail implementasi di autentikasi dua faktor.