跳转到正文

Android 上的 Supabase Google Login

GitHub

本指南将帮助您在 Android 上将 Google 登录集成到 Supabase 身份验证中。假设您已完成以下操作:

完整实现位于 示例应用的 supabaseAuthUtils.ts 文件。本指南介绍其核心概念及使用方法。

本指南中介绍的 authenticateWithGoogleSupabase 函数负责处理整个身份验证流程:

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

有关认证流程(包括 nonce 生成、JWT 校验和 Supabase 登录)的详细说明,请参阅 通用设置指南中的“工作原理”部分.

如需查看完整的 code 参考文档,请参阅 常规设置指南中的完整 Code 参考部分.

Nonce 实现遵循以下模式: React Native Google Sign In 文档:

  • rawNonce 会发送到 Supabase 的 signInWithIdToken()
  • Supabase 会对以下内容进行哈希处理: rawNonce 并将其与以下内容进行比对: nonceDigest 该内容包含在 Google Sign-In 的 ID token 中
  • nonceDigest (SHA-256 哈希,十六进制编码) 会传给 nonce Google Sign-In API 中的参数

该实现包含自动重试逻辑:

  • 如果首次 JWT 验证失败,则登出并重试一次
  • 这可以处理缓存 token 中 nonce 可能不正确的情况
  • 如果重试也失败,则返回错误

如果身份验证失败:

  • Audience 无效: 验证你的 Google Client ID 在 Google Cloud Console 和 Supabase 中是否一致
  • Nonce 不匹配: 检查控制台日志 - 函数会自动重试,但如有需要,你可以先手动退出登录
  • Token 验证失败:请确保使用 mode: 'online' 在 initialize 调用中获取 idToken
  • 请查阅 示例应用 code 仅供参考

如果你正在使用 Android 上的 Supabase Google Login 用来规划身份验证和账户流程,并将它与 使用 @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 中的实现细节, 双因素认证 有关双重身份验证的实现细节。