Facebook 로그인 마이그레이션에서 계속 @capgo/social-login

설치

개요

이 안내서에서는 @capacitor-community/facebook-login to @capgo/capacitor-social-login. 새로운 플러그인은 Facebook 인증을 현대화하는 통합 API를 제공하며 여러 소셜 제공자, 향상된 TypeScript 지원 및 향상된 기능을 제공합니다.

설치

기존 패키지를 제거하세요:

npm uninstall @capacitor-community/facebook-login

설치 새 패키지:

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

Code 변경 사항

변경 사항 가져오기

import { FacebookLogin } from '@capacitor-community/facebook-login';
import { SocialLogin } from '@capgo/capacitor-social-login';

초기화

키 변경: 새 패키지는 명시적 설정이 필요합니다. code:

// Old package required no explicit initialization in code
// Configuration was done only in native platforms

// New package requires explicit initialization
await SocialLogin.initialize({
  facebook: {
    appId: 'YOUR_FACEBOOK_APP_ID',        // Required for web and Android
    clientToken: 'YOUR_CLIENT_TOKEN'       // Required for Android
  }
});

로그인 방법이 제공자 매개 변수를 받을 수 있습니다.

const FACEBOOK_PERMISSIONS = ['email', 'public_profile'];
const result = await FacebookLogin.login({ permissions: FACEBOOK_PERMISSIONS });

const result = await SocialLogin.login({
  provider: 'facebook',
  options: {
    permissions: ['email', 'public_profile'],
    limitedLogin: false,
    nonce: 'optional_nonce'
  }
});

응답 형식 변경

인증 제공자에 대한 field가 포함됩니다.

// Old response type
interface FacebookLoginResponse {
  accessToken: {
    applicationId: string;
    userId: string;
    token: string;
    expires: string;
  };
  recentlyGrantedPermissions: string[];
  recentlyDeniedPermissions: string[];
}

// New response type
interface FacebookLoginResponse {
  provider: 'facebook';
  result: {
    accessToken: {
      token: string;
      applicationId?: string;
      expires?: string;
      userId?: string;
      permissions?: string[];
      declinedPermissions?: string[];
    } | null;
    idToken: string | null;
    profile: {
      userID: string;
      email: string | null;
      friendIDs: string[];
      birthday: string | null;
      ageRange: { min?: number; max?: number } | null;
      gender: string | null;
      location: { id: string; name: string } | null;
      hometown: { id: string; name: string } | null;
      profileURL: string | null;
      name: string | null;
      imageURL: string | null;
    };
  };
}

응답 형식 변경:

응답 구조가 개선되었습니다. provider 인증 제공자에 대한 field가 포함됩니다.
더 자세한 profile 추가 사용자 정보가 포함된 객체
모든 사회 로그인 제공자에서 일관된 구조

const result = await FacebookLogin.getCurrentAccessToken();
const isLoggedIn = result && result.accessToken;

const status = await SocialLogin.isLoggedIn({
  provider: 'facebook'
});
const isLoggedIn = status.isLoggedIn;

로그아웃

await FacebookLogin.logout();

await SocialLogin.logout({
  provider: 'facebook'
});

플랫폼별 변경 사항

안드로이드 설정

설정은 이제 initialize 메소드를 통해 처리됩니다:

// AndroidManifest.xml changes remain the same
// strings.xml become irrelevant
// Additionally initialize in your code:
await SocialLogin.initialize({
  facebook: {
    appId: 'your-app-id',
    clientToken: 'your-client-token'  // New requirement
  }
});

중요클라이언트 토큰이 이제 Android 인증을 위해 필요합니다.

iOS 설정

iOS 설정에서 AppDelegate.swift 설정은 여전히 동일합니다:

import FBSDKCoreKit

// In application:didFinishLaunchingWithOptions:
FBSDKCoreKit.ApplicationDelegate.shared.application(
    application,
    didFinishLaunchingWithOptions: launchOptions
)

// In application:openURL:options:
ApplicationDelegate.shared.application(
    app,
    open: url,
    sourceApplication: options[UIApplication.OpenURLOptionsKey.sourceApplication] as? String,
    annotation: options[UIApplication.OpenURLOptionsKey.annotation]
)

The Info.plist __CAPGO_KEEP_0__

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>fb[APP_ID]</string>
        </array>
    </dict>
</array>
<key>FacebookAppID</key>
<string>[APP_ID]</string>
<key>FacebookClientToken</key>
<string>[CLIENT_TOKEN]</string>
<key>FacebookDisplayName</key>
<string>[APP_NAME]</string>
<key>LSApplicationQueriesSchemes</key>
<array>
    <string>fbapi</string>
    <string>fbauth</string>
    <string>fb-messenger-share-api</string>
    <string>fbauth2</string>
    <string>fbshareextension</string>
</array>

변경 사항

변경 사항 요약

이전 버전에서 명시적 초기화가 필요합니다. - 사용하기 전에 initialize() 사용 전에
- 향상된 프로필 데이터를 포함하는 새로운 중첩된 결과 형식 안드로이드에서 클라이언트 토큰이 필요합니다.
- 추가 구성이 필요합니다. 다른 메서드 이름과 매개 변수 구조
다른 메서드 이름과 매개 변수 구조 - 제공자 기반 접근 방식
오류 처리 및 오류 유형이 변경되었습니다 - 더 자세한 오류 정보

주요 이점

새로운 플러그인은 다음과 같은 기능을 제공합니다:

통합 API 다중 소셜 제공자(구글, 애플, 페이스북)across
향상된 타입스크립트 지원 타입 정의가 더 좋아졌습니다
개선된 프로필 데이터 사용자 정보가 더 많습니다
활성 유지 보수 및 커뮤니티 지원
모든 제공자에서 일관된 오류 처리 모든 제공자에서 일관된 오류 처리
토큰 관리 토큰 만료 처리

자세한 설정 방법에 대한 설명은 공식 문서를 참조하세요. 공식 문서.

Facebook 로그인 마이그레이션을 사용하고 있다면 Facebook 로그인 마이그레이션을 @capgo/social-login으로 수행합니다. 인증 및 계정 흐름을 계획하고 연결하려면 @capgo/capacitor-social-login Using @capgo/capacitor-social-login Using @capgo/capacitor-social-login Using @capgo/capacitor-social-login Using @capgo/capacitor-passkey Using @capgo/capacitor-passkey Using @capgo/capacitor-native-biometric Using @capgo/capacitor-native-biometric 두 요인 인증 Two-factor authentication