Apple Sign-In の移行を @capgo/social-login に行ってください。

Overview

インストール @capacitor-community/apple-sign-in インストールセクション @capgo/capacitor-social-login 古いパッケージを削除してください:

ターミナル画面

1. ペースト用準備

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

2. 新しいパッケージをインストール:

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

初期化

キー変更 : iOS の場合、基本的な設定を提供する必要がありますが、Android の場合はサービス ID とバックエンドのコールバック URL を含む追加の詳細が必要です。

// 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 の場合はサービス ID とバックエンドのコールバック URL を含む追加の詳細が必要です。

サインイン

ログインプロセスは複数のパラメータからシンプルな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 and 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'
});

Copy to clipboard

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

これらのメソッドは isLoggedIn() 認証状態を確認し logout() 機能を提供します。

プラットフォーム固有の変更

iOSの設定

iOS iOSは、Xcodeの機能を通じて

1. iOSの設定はほとんど変わりません。まだ
   • 「Sign In with Apple」機能をXcodeで有効にする必要があります。
   • Apple 開発者ポータルでアプリを設定してください
   • iOS については、追加の code 変更は必要ありません

Android 設定

Android Android は、ウェブベースの OAuth 認証を使用したネイティブサポートを受け取ります:

新しいプラグインは、Android のサポートを提供しますが、追加の設定が必要です:

1. Apple Developer Portal でサービス ID を作成してください
2. ウェブ認証エンドポイントを設定してください
3. Android アプリを OAuth フローを処理するように設定してください
4. バックエンドサービス設定が必要です

詳細な Android 設定の手順については、以下のドキュメントを参照してください Android セットアップ ガイド.

主な利点

モダン化されたパッケージには次の機能があります:

1. 複数のソーシャル プロバイダー (Google、Facebook、Apple) での統合 API Google、Facebook、Apple など複数のソーシャル プロバイダーで使用できる API
2. 改善された TypeScript の型付け 型定義が改善された
3. アクティブなコミュニティのメンテナンス 非推奨のバージョンと比較して
4. Android の組み込みサポート ウェブベースの認証を通じて
5. 永続ログイン状態管理
6. エラー処理の改善 エラーの型が一貫している

変更点

1. 明示的な初期化が必要になりました - デフォルトの設定はありません
2. レスポンスオブジェクトの構造が変更されました - ネストされた結果の形式
3. Android実装ではOAuthのバックエンドサービスが必要です OAuth のために
4. iOS実装ではOAuthのバックエンドサービスが必要です - トークン管理の改善
5. エラーハンドリングとエラータイプが変更されました - 詳細なエラー

詳細な設定方法については、公式ドキュメントを参照してください 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を使用して、認証とアカウントフローの計画を行い、接続してください Apple Sign-In のマイグレーションを @capgo/social-login に行います。 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-social-loginのネイティブ機能を使用する場合 @capgo/capacitor-social-login Capgoのネイティブ機能である@capgo/capacitor-social-loginの使用 @capgo/capacitor-ソーシャルログイン @capgo/capacitor-social-login @capgo/capacitor-パスキー @capgo/capacitor-passkey @capgo/capacitor-native-biometric @capgo/capacitor-native-biometric 二要素認証 Two-factor authentication