Supabase Apple iOS设置

前提条件

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

• 苹果登录 iOS 设置 苹果登录 iOS 的设置
• the Supabase Apple 登录 - 通用设置.

实现

完整的实现可以在 示例应用的 supabaseAuthUtils.ts 文件中找到。这个指南解释了关键概念和如何使用它。

使用身份验证助手

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

How It Works

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

1. 初始化:该插件会自动使用您的应用程序的包 ID（无需 clientId 需要）
2. 原生登录:使用 Apple 的原生 Sign in with Apple 按钮和身份验证流程
3. 身份令牌:Apple 返回包含用户信息的身份令牌（JWT）
4. Supabase 身份验证:将身份令牌发送到 Supabase signInWithIdToken()

iOS 平台的辅助函数会自动检测并配置所有内容。

重要说明

包ID配置

• iOS会自动使用您的应用包ID进行Apple Sign-In
• 确保您的包ID与Apple Developer Portal中配置的一致
• 包ID应启用“Sign in with Apple”功能

Supabase Client ID

在 Supabase 中，配置 Apple 提供商时，请使用以下内容：

• 客户端ID: Your iOS App ID (bundle ID) - e.g., app.capgo.plugin.SocialLogin

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

故障排除

如果认证失败:

• 包 ID 不匹配: 确认您的包 ID 在 Xcode 和 Apple Developer Portal 中都匹配
• 能力未启用: 确认在 Xcode 中启用了 "使用 Apple 登录" 能力
• Supabase 配置: 确认您的 App ID 在 Supabase Apple 提供商设置中正确配置
• 令牌验证失败: 检查 Apple 是否向您发送身份令牌
• Review the 示例应用程序 code 以此为参考

继续使用 Supabase Apple Login on iOS Setup

如果您正在使用 Supabase Apple Login on iOS Setup 来规划身份验证和帐户流程，连接它到 使用 @capgo/capacitor-social-login 为 Using @capgo/capacitor-social-login 中的本机功能 @capgo/capacitor-social-login 为 @capgo/capacitor 社交登录实现细节的详细信息 @capgo/capacitor-passkey 为 @capgo/capacitor-passkey 实现细节的详细信息 @capgo/capacitor-native-biometric 为 @capgo/capacitor-native-biometric 实现细节的详细信息, 和 双因素身份验证 为双因素身份验证实现细节的详细信息