Apple Sign-In Migration to @capgo/social-login

복사할 수 있는 지시

개요

이 가이드는 레거시 플러그인에서 현대 @capacitor-community/apple-sign-in 플러그인을 전환하는 방법을 설명합니다. @capgo/capacitor-social-login 새로운 플러그인은 여러 가지 사회 인증 제공자에 대한 통합 인터페이스를 제공하고 TypeScript 지원과 유지 보수를 활성화합니다.

설치

구성된 패키지를 제거하십시오:
터미널 창
```
npm uninstall @capacitor-community/apple-sign-in
```

새로운 패키지를 설치하십시오:

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

Code 변경 사항

변경 사항 가져오기

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

초기화

변경: 새로운 플러그인은 이전에 필요하지 않았던 초기화 단계가 필요합니다.

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

중요한 주의: iOS의 경우 기본 구성만 제공하면 되지만 Android는 Service ID와 백엔드 callback URL을 포함한 웹 기반 OAuth 인증을 위해 추가적인 세부 정보가 필요합니다.

: 로그인 프로세스는 여러 매개 변수에서 더 간단한 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'
  }
});

새로운 플러그인은 login() with provider: 'apple' 그리고 선택적 범위 대신 개별 구성 값처럼 clientId 그리고 redirectURI.

응답 유형 변경

기존 패키지의 평평한 응답 형식 대신 accessToken 클립보드 복사 profile 새로운 기능

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

업데이트된 플러그인은 전신에 없는 기능을 제공합니다:

__CAPGO_KEEP_0__

__CAPGO_KEEP_0__

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

로그아웃 기능

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

이 메소드는 인증 상태를 확인하고 isLoggedIn() 기능을 제공합니다. logout() 플랫폼별 변경 사항

플랫폼별 변경 사항 섹션

iOS 설정 섹션

Xcode 기능을 통해 익숙한 설정 절차를 유지합니다. iOS

iOS 설정은 크게 변경되지 않았습니다. 여전히 다음을 필요로합니다:
- Xcode에서 'Apple과 함께 로그인' 기능을 활성화해야합니다.
- Apple Developer Portal에서 앱을 구성해야합니다.
- iOS에 대한 추가적인 code 변경이 필요하지 않습니다.

Android 설정

Android 현재 웹 기반 OAuth 인증을 통해 네이티브 지원을 받습니다:

새로운 플러그인은 Android 지원을 제공하지만 추가적인 설정이 필요합니다:

Apple Developer Portal에서 서비스 ID를 생성해야합니다.
웹 인증 엔드포인트를 구성해야합니다.
Android 앱을 OAuth 흐름을 처리하도록 설정해야합니다.
백엔드 서비스 설정이 필요합니다

자세한 Android 설정 지침에 대한 자세한 설명은 Android 설정 가이드.

주요 이점

최신화된 패키지는 다음과 같은 기능을 제공합니다:

다중 소셜 제공자 (Google, Facebook, Apple)에서 통합 API 타입스크립트의 향상된 타이핑
타입 정의의 향상 활발한 커뮤니티 유지
deprecated 버전과 비교하여 __CAPGO_KEEP_0__
내장된 안드로이드 지원 웹 기반 인증을 통해
지속 로그인 상태 관리
더 나은 오류 처리 일관된 오류 유형과 함께

변경 사항

explicit 초기화가 필요합니다. - 기본 설정이 없습니다.
응답 객체 구조가 변경되었습니다. - 중첩된 결과 형식
안드로이드 구현은 백엔드 서비스가 필요합니다. OAuth를 위한
토큰 갱신 처리는 다릅니다. - 토큰 관리가 개선되었습니다.
오류 처리 및 오류 유형이 변경되었습니다. - 더 자세한 오류 정보

Apple Sign-In Migration에서 @__CAPGO_KEEP_0__/social-login로 계속 진행하기 위해 Apple Sign-In Migration에서 @__CAPGO_KEEP_0__/social-login로 계속 진행하기.

그것을 @__CAPGO_KEEP_0__/social-login과 연결하세요. Apple Sign-In Migration을 @capgo/social-login으로 사용하여 인증 및 계정 흐름을 계획하고 그것을 @__CAPGO_KEEP_0__/social-login과 연결하세요. @capgo/capacitor-social-login capgo/capacitor-social-login을 사용하여 capgo/capacitor-social-login capgo/capacitor-social-login capgo/capacitor-passkey capgo/capacitor-passkey capgo/capacitor-native-biometric capgo/capacitor-native-biometric __CAPGO_KEEP_0__/__CAPGO_KEEP_1__-native-biometric __CAPGO_KEEP_0__/__CAPGO_KEEP_1__-social-login