game_cocos_2c/native/engine/ios/GOOGLE.md

Google iOS 登录

1. 在 Google Cloud 同一项目创建 iOS 类型 OAuth Client，Bundle ID 与 Xcode 最终应用一致。
2. 在本目录 Info.plist 替换 GIDClientID 和 google URL Scheme 两处 YOUR_IOS_CLIENT_ID 占位符。 例如 Client ID 为 123-abc.apps.googleusercontent.com，Scheme 为 com.googleusercontent.apps.123-abc。
3. 服务端 Client ID 使用现有 AppConfig.GoogleID（Web 类型），由 TS init 传入，不需要重复填写 GIDServerClientID。
4. Creator 重新构建 iOS 后，在 Mac 的 native/engine/ios 执行 pod install，打开生成的 xcworkspace 编译。

GoogleIOSImpl 复用 GoogleNativeImpl 的请求协议。AppKernel 已调用 google.init()。 await AppKernel.google.login() 返回 accessToken（兼容旧接口，实际为 Google ID Token）、userId、name、email、isCancel、status。 await AppKernel.google.logOut() 清除本机 Google SDK 会话，不撤销授权，也不自动清理游戏服务器会话。

后端必须验证 Google ID Token 的签名、issuer、audience、过期时间，以验证后的 sub 识别用户；不得信任客户端资料作为认证依据。 Google 登录不依赖 ATT。系统授权弹窗尚未关闭时请稍后重试。 测试：成功登录、用户取消、断网、重复点击、登出再登录、Facebook URL 回调不受影响。 Windows 无法验证 CocoaPods 安装和 Xcode 原生编译，需要 Mac 真机测试。

官方文档：https://developers.google.com/identity/sign-in/ios/start-integrating