Google 登录 iOS

GitHub

复制一个包含安装步骤和本插件的完整 Markdown 指南的设置提示。

介绍

在本指南中，您将学习如何在 iOS 设备上设置 Google 登录和 Capgo 社交登录。已阅读通用设置指南.

在本部分中，您将学习如何在 iOS 设备上设置 Google 登录。

在 Google 控制台中创建一个 iOS 客户端 ID
1. 点击搜索栏
2. 在搜索栏中输入 credentials 并点击第二个结果（截图中的第 2 项） APIs and Services Google Console search bar
3. 点击 Google Console 中的 create credentials
4. 选择 OAuth client ID
5. 选择 Application type 到 iOS
6. 找到 bundle ID
  1. 打开 Xcode
  2. 双击 Xcode 项目导航器中的 App
  3. 确保您已在 Targets -> App
  4. 找到您的 Bundle Identifier
  5. 返回Google控制台并将您的 Bundle Identifier 输入 Bundle ID
7. 可选地，添加您的 App Store ID 或 Team ID 如果您已发布应用程序到App Store，则将其输入到客户端ID中
8. 填写所有详细信息后，点击 create
9. 点击 OK
10. 打开刚创建的 iOS 客户端
11. 复制以下数据
  
  在这个图片中将会变成 nr. 1 在图片中将会变成 iOSClientId 将会被称为 initialize 的调用
  The nr. 2 在这张图片中将会变成 YOUR_DOT_REVERSED_IOS_CLIENT_ID
修改您的应用程序的Info.plist
1. 打开Xcode并找到 Info.plist 文件
2. 右键单击此文件并以源代码code打开
3. 您的文件底部 Plist 您将看到一个 </dict> 标签
4. 在关闭标签之前，插入以下片段 </dict> 标签
```
<key>CFBundleURLTypes</key>
<array>
 <dict>
   <key>CFBundleURLSchemes</key>
   <array>
     <string>YOUR_DOT_REVERSED_IOS_CLIENT_ID</string>
   </array>
 </dict>
</array>
```
5. 将其更改为上一步中复制的值 YOUR_DOT_REVERSED_IOS_CLIENT_ID Info.plist文件中，实际反转的客户端ID插入到URL方案中
  
  以开始 with com.googleusercontent.apps
6. 保存文件时 Command + S

修改 AppDelegate.swift

打开AppDelegate
插入 import GoogleSignIn 在AppDelegate.swift文件顶部添加GoogleSignIn导入语句
函数 func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey: Any] = [:]) AppDelegate中的原始应用程序openURL函数

复制到剪贴板

func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey: Any] = [:]) -> Bool {
    // Called when the app was launched with a url. Feel free to add additional processing here,
    // but if you want the App API to support tracking app url opens, make sure to keep this call

    var handled: Bool

    handled = GIDSignIn.sharedInstance.handle(url)
    if handled {
      return true
    }

    return ApplicationDelegateProxy.shared.application(app, open: url, options: options)
}

保存文件 Command + S

Setup Google login in your JavaScript/TypeScript code

导入 SocialLogin 并 Capacitor

import { SocialLogin } from '@capgo/capacitor-social-login';
import { Capacitor } from '@capacitor/core';

调用初始化方法（应只调用一次）

基本设置（在线模式-大多数应用程序推荐）
```
// onMounted is Vue specific
onMounted(() => {
  SocialLogin.initialize({
    google: {
      iOSClientId: '673324426943-redacted.apps.googleusercontent.com',
      mode: 'online' // Default mode
    }
  })
})
```
高级设置：附加客户端ID
```
onMounted(() => {
  SocialLogin.initialize({
    google: {
      webClientId: 'YOUR_WEB_CLIENT_ID',           // Optional: for web platform support
      iOSClientId: 'YOUR_IOS_CLIENT_ID',           // Required: from step 1
      iOSServerClientId: 'YOUR_WEB_CLIENT_ID',     // Optional: same as webClientId, needed for some advanced features
      mode: 'online'                               // 'online' or 'offline'
    }
  })
})
```
注意
客户端 ID 要求:
- iOSClientId: 必需 - 必须以 googleusercontent.com (从步骤 1 中)
- webClientId: 可选 - 只有在您也支持 web 平台或需要高级功能时才需要
- iOSServerClientId: 可选 - 应该与 webClientId 当提供时
高级设置与 webClientId 和 iOSServerClientId, 请参阅 web 配置指南用于创建这些凭据的
关于离线模式: 在使用 mode: 'offline', 登录响应将不包含用户数据。相反，您将接收一个服务器认证 code，必须通过您的后端服务器进行交换以获取用户信息。 SocialLogin.refresh({ provider: 'google' }) 在此模式下，刷新功能不可用；刷新必须在交换 serverAuthCode后在您的后端进行。请参阅通用配置指南了解实现细节

实现登录功能。创建一个按钮并在点击时运行以下code

在线模式:

const res = await SocialLogin.login({
  provider: 'google',
  options: {}
})
// handle the response - contains user data
console.log(JSON.stringify(res))

离线模式:

const res = await SocialLogin.login({
  provider: 'google',
  options: {
    forceRefreshToken: true // Recommended for offline mode
  }
})
// res contains serverAuthCode, not user data
// Send serverAuthCode to your backend to get user information
// Do not call SocialLogin.refresh() in offline mode
console.log('Server auth code:', res.result.serverAuthCode)

测试您的应用
1. 构建您的应用并运行 cap sync
2. 如果您已经正确完成了所有步骤，您应该看到Google登录流程正常工作

已知问题

隐私屏幕插件不兼容性

Google 登录插件与 @capacitor/privacy-screen不兼容。当同时使用这两个插件时，Google 登录 webview 将被隐私屏幕中断。

解决方法： 在调用登录函数之前 await PrivacyScreen.disable(); 复制到剪贴板

import { PrivacyScreen } from '@capacitor/privacy-screen';
import { SocialLogin } from '@capgo/capacitor-social-login';

await PrivacyScreen.disable();
await SocialLogin.login({
  provider: 'google',
  options: {}
});

如果您正在使用 Google iOS 登录 来规划身份验证和帐户流程，连接它到使用 @capgo/capacitor 社交登录为 @capgo/capacitor 社交登录中的本机能力 @capgo/capacitor 社交登录为 @capgo/capacitor 社交登录中的实现细节 @capgo/capacitor-passkey 为 @capgo/capacitor-passkey 中的实现细节 @capgo/capacitor-native-biometric 为 @capgo/capacitor-native-biometric 中的实现细节双因素验证双因素验证的实现细节。

Google 登录 iOS

介绍

使用 Google 登录在 iOS 设备上

已知问题

隐私屏幕插件不兼容性

Call