Apple Sign-In 이관을 @capgo/social-login 에서 계속 진행하세요

이 플러그인의 설치 단계와 전체 마크다운 가이드를 포함한 설정 프롬프트를 복사하세요.

개요

이 가이드는 전통적인 플러그인을 현대적인 @capacitor-community/apple-sign-in 패키지로의 전환을 설명합니다. 새로운 플러그인은 여러 소셜 인증 제공자에 대한 통합 인터페이스를 제공하며 TypeScript 지원과 활성 유지 보수를 개선합니다. @capgo/capacitor-social-login 설치

설치

__CAPGO_KEEP_0__를 삭제하세요:

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

__CAPGO_KEEP_0__를 설치하세요:

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

초기화

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

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

Important Note: iOS에서는 기본 구성만 제공하지만 Android에서는 Service ID와 백엔드 콜백 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'
  }
});

The new plugin uses login() Capacitor 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;
    };
  };
}

새로운 기능

업데이트된 플러그인은 전신에 없는 기능을 소개합니다.

로그인 상태 확인

// 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 설정

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

iOS 설정은 크게 변경되지 않았습니다. 여전히 다음을 수행해야 합니다.
- Xcode에서 '애플 로그인' 기능을 활성화하세요.
- 애플 개발자 포털에서 앱을 구성하세요.
- iOS에 대한 추가 code 변경 사항이 필요하지 않습니다.

Android 설정

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

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

애플 개발자 포털에서 서비스 ID를 생성하세요.
웹 인증 엔드포인트를 구성하세요.
Android 앱을 OAuth 흐름을 처리하도록 설정하세요.
__CAPGO_KEEP_0__

세부적인 Android 설정 지침을 참조하기 위해, Android 설정 가이드.

주요 이점

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

다중 소셜 제공자 (Google, Facebook, Apple)across 타입스크립트의 향상된 타이핑
보다 나은 타입 정의 활발한 커뮤니티 유지
deprecated 버전보다 __CAPGO_KEEP_1__
내장된 안드로이드 지원 웹 기반 인증을 통해
지속 로그인 상태 관리
오류 처리를 개선 일관된 오류 유형

파괴적인 변경 사항

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

더 자세한 설정 방법을 알고 싶다면 공식 문서를 참조하세요.

Apple Sign-In Migration을 @__CAPGO_KEEP_0__/social-login으로 사용하여 Apple Sign-In Migration to @capgo/social-login Apple Sign-In Migration을 @__CAPGO_KEEP_0__/social-login으로 사용하여 인증 및 계정 흐름을 계획하고 연결하는 경우 @capgo/capacitor-social-login Using @capgo/capacitor-social-login @capgo/capacitor-social-login Using @capgo/capacitor-social-login @capgo/capacitor-passkey Using @capgo/capacitor-passkey @capgo/capacitor-native-biometric Using @capgo/capacitor-native-biometric Two-factor authentication Two-factor authentication