SuperAPI AI 工具集

setup-apple-signin

编程与开发

查看项目

更新于 11-05 19:15

技能介绍

setup-apple-signin 是一项专注于 Flutter + Firebase 应用接入 Sign In with Apple 的配置技能,目标是在 iOS、Android 与 Web 上通过 Firebase Auth 完成 Apple 登录。资料强调三套系统必须一致:Apple Developer Portal、Firebase Console 和 app 代码。

用途:帮助开发者完成从平台注册、Firebase 配置到 Dart 代码调用的完整接入流程,并提供错误排查指引。

主要能力:

  1. 仅 iOS 的快速接入:pubspec.yaml 只需 firebase_auth,无需额外包;调用 FirebaseAuth.instance.signInWithProvider(AppleAuthProvider()..addScope('email')..addScope('name')),在 iOS/macOS 上会弹出 Apple 原生登录面板;在 Firebase Console → Authentication → Sign-in method → Apple 启用并保存即可。
  2. 扩展到 Android/Web/桌面:由于 Apple 在 iOS/macOS 之外没有原生 SDK,signInWithProvider 会回退为经由 https://<project>.firebaseapp.com//auth/handler 的 Web 重定向,因此需要真实 OAuth 注册:在 Xcode 添加 Sign In with Apple capability(写入 Runner.entitlements,自动签名归档时会自动注册 App ID 能力);在 Apple Developer Portal 创建启用 Sign In with Apple 的 Key(Primary App ID 为 bundle ID,记录 Key ID,.p8 仅可下载一次);创建 Services ID(须与 bundle ID 不同),配置 Primary App ID、Domain 为 <project>.firebaseapp.com、Return URL 为 https://<project>.firebaseapp.com//auth/handler;在 Firebase Console 的 Apple provider 中填写 OAuth code flow 配置(Services ID、Team ID、Key ID、完整 .p8 内容),保存后服务端生效、无需重新构建;Android 还需在 Firebase 项目设置中登记 SHA-1/SHA-256。
  3. 配套文档:REFERENCE.md 提供含精确字段值的分步说明;EXAMPLES.md 给出原生登录、账号关联与解绑,以及 sign_in_with_apple 包替代方案(用于符合 HIG 的原生按钮);TROUBLESHOOTING.md 说明 operation-not-allowed 与 invalid_client 的区别、平台路由陷阱,以及通过单请求二分测试快速定位 Services ID 或密钥配置错误。

使用方式:按快速开始完成 iOS 接入,再依据 setup checklist 逐项补充 Android/Web 所需配置,代码与排查参考对应文档。

适用场景:使用 Flutter 与 Firebase 且需要 Apple 登录的移动端或 Web 应用。

限制:资料未提供价格、平台支持范围之外的信息或效果保证;非 iOS 平台必须完成 Apple 与 Firebase 的 OAuth 注册,否则无法登录。