Apple Sign-In 이관을 @capgo/social-login으로

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

개요

이 가이드는 레거시 플러그인에서 현대 @capacitor-community/apple-sign-in 패키지로의 전환을 설명합니다. 새로운 플러그인은 여러 소셜 인증 제공자에 대한 통합 인터페이스를 제공하며 TypeScript 지원이 향상되고 유지 관리가 활발합니다. @capgo/capacitor-social-login 설치

설치

__CAPGO_KEEP_0__ Changes를 제거하세요:
터미널 창
```
npm uninstall @capacitor-community/apple-sign-in
```

__CAPGO_KEEP_0__ Changes를 제거하세요:

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

Code Changes

__CAPGO_KEEP_0__ Changes를 가져오세요

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와 백엔드 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'
  }
});

The new plugin uses login() Capacitor provider: 'apple' 및 선택적 범위 대신 개별 구성 값처럼 전달하는 대신 clientId 및 redirectURI.

응답 형식 변경

결과는 이제 object에 만료 세부 정보와 구조화 된 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 설정

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

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

Android 설정

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

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

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

__CAPGO_KEEP_1__의 세부적인 안드로이드 설정 지침에 대한 자세한 설명을 참조하십시오. 안드로이드 설정 가이드.

__CAPGO_KEEP_2__

__CAPGO_KEEP_3__ 패키지는 다음과 같은 혜택을 제공합니다.

__CAPGO_KEEP_4__ __CAPGO_KEEP_4__의 여러 소셜 제공자 (Google, Facebook, Apple)across에 대한 통합 API
__CAPGO_KEEP_5__의 타입스크립트 타이핑이 개선되었습니다. __CAPGO_KEEP_5__의 타입 정의가 더 좋습니다.
__CAPGO_KEEP_6__의 커뮤니티 유지 보수가 활발합니다. __CAPGO_KEEP_6__ 버전과 비교하여
내장 Android 지원 웹 기반 인증을 통해
지속 로그인 상태 관리
일관된 오류 유형으로 오류 처리 오류 처리

변경 사항

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

더 자세한 설정 방법을 알고 싶다면 공식 문서를 참조하세요. @__CAPGO_KEEP_0__/social-login으로 Apple Sign-In Migration을 계속 진행하세요..

Apple Sign-In Migration을 @__CAPGO_KEEP_0__/social-login으로 계속 진행 중이라면 Apple Sign-In Migration을 @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