Supabase Apple Login on iOS Setup

前提条件

本指南将帮助您在 iOS 上将 Apple Sign-In 与 Supabase 身份验证集成。假设您已经完成：

• Apple Login iOS 设置 Supabase Apple Login - 一般设置
• 集成 __CAPGO_KEEP_0__.

__CAPGO_KEEP_1__

在本指南中，完整的实现可以在 example app的 supabaseAuthUtils.ts 文件中找到。 本指南解释了关键概念和如何使用它。

使用身份验证助手

该 authenticateWithAppleSupabase 函数处理整个身份验证流程：

import { authenticateWithAppleSupabase } from './supabaseAuthUtils';

const result = await authenticateWithAppleSupabase();
if (result.success) {
  console.log('Signed in:', result.user);
  // Navigate to your authenticated area
} else {
  console.error('Error:', result.error);
}

如何工作

在iOS上，Apple Sign-In使用native实现：

1. 初始化: 插件会自动使用您的应用程序的包 ID (无需 clientId 原生登录
2. : 使用 Apple 原生登录按钮和身份验证流程身份令牌
3. : Apple 返回包含用户信息的身份令牌 (JWT)Supabase 身份验证
4. : 将身份令牌发送到 Supabase助手函数会自动检测 iOS 平台并配置所有内容 signInWithIdToken()

重要注意事项

标题为“重要注意事项”的部分

Bundle ID 配置

• iOS 会自动使用您的应用程序的 Bundle ID 进行 Apple Sign-In
• 确保您的 Bundle ID 与 Apple Developer Portal 中配置的值匹配
• Bundle ID 应该启用 "Sign in with Apple" 功能

Supabase Client ID

在 Supabase 中，配置您的 Apple 提供商：

• Client ID: iOS 应用 ID（Bundle ID）- 例如： app.capgo.plugin.SocialLogin

如果您还使用 Android/Web，则需要在 Supabase 的 Client ID 字段中提供 App ID 和 Service ID（以逗号分隔）

故障排除

如果身份验证失败：

• 包 ID 不匹配: 确保在 Xcode 和 Apple Developer Portal 中的包 ID 匹配
• 能力未启用: 确保在 Xcode 中启用了“使用 Apple 登录”能力
• Supabase 配置: 确保在 Supabase Apple 提供商设置中正确配置了 App ID
• 令牌验证失败: 检查 Apple 是否向您发送身份令牌
• 查看 示例应用程序 code for reference

从 Supabase Apple Login on iOS Setup 中继续

如果您正在使用 Supabase Apple Login on iOS Setup 来规划认证和账户流程，连接它到 使用 @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 中的实现细节， 双因素认证 在双因素认证中的实现细节，