适用于 iOS 和 macOS 的 Google 登录服务使用入门

在开始将 iOS 或 macOS 应用与 Google 登录组件集成之前,您必须下载依赖项并配置 Xcode 项目。只需按照此页面上的步骤操作,后续步骤介绍了如何将 Google 登录功能集成到您的应用中。

准备工作

安装最新版本的 Xcode

在项目中安装 Google 登录依赖项

CocoaPods

  1. 如果您尚未安装 CocoaPods,请按照 CocoaPods 使用入门指南中的步骤操作。

  2. 打开一个终端窗口,然后导航到应用的 Xcode 项目所在的位置。

  3. 如果您还没有为应用创建 Podfile,请立即创建一个:

    pod init

  4. 打开为应用创建的 Podfile 并添加以下内容:

    pod 'GoogleSignIn'

  5. 如果您使用的是 SwiftUI,请同时添加“使用 Google 帐号登录”按钮的 pod 扩展程序:

    pod 'GoogleSignInSwiftSupport'

  6. 保存文件并运行:

    pod install

  7. 在 Xcode 中为应用打开生成的 .xcworkspace 工作区文件。以后开发您的应用时都要使用此文件。(请注意,这与包含的 .xcodeproj 项目文件不同,后者会在打开时造成构建错误。)

    如需查看示例,请参阅 Objective-C 示例应用的 Podfile

Swift Package Manager

  1. 在 Xcode 中打开您的项目。

  2. 将 Google 登录依赖项添加到您的应用(Xcode 文档):

    代码库 https://github.com/google/GoogleSignIn-iOS
    版本 6.0.2
    产品包 Google 登录
  3. 如果您使用的是 SwiftUI,请针对“使用 Google 帐号登录”按钮添加以下扩展程序包产品:

    产品包 Google 登录 InSwift

获取 OAuth 客户端 ID

您的应用需要 OAuth 客户端 ID 来向 Google 的身份验证后端标识自身。对于 iOS 和 macOS 应用,OAuth 客户端 ID 应用类型必须配置为 iOS。

如果您尚未创建 OAuth 客户端 ID,请点击下方按钮创建。

创建 OAuth 客户端 ID

创建 OAuth 客户端 ID 后,请记下客户端 ID 字符串,您将需要在应用中配置 Google 登录。您可以选择下载包含您的客户端 ID 和其他配置数据的配置文件,以供日后参考。

如果您已创建 OAuth 客户端 ID,可以点击下面的按钮,找到现有的 OAuth 信息。

获取现有的 OAuth 客户端 ID

获取 OAuth 服务器客户端 ID

大多数应用都需要将已登录用户的身份传递给某种后端服务。要将使用 Google 帐号登录的用户的身份安全地传递到后端,请使用 ID 令牌,如使用后端服务器进行身份验证中所述。检索用户的 ID 令牌需要第二个客户端 ID,也就是代表后端的服务器客户端 ID。

如需创建服务器客户端 ID,请执行以下操作:

  1. Cloud Console 中打开您的项目。

  2. 创建一个新的 Web 应用类型 OAuth 客户端 ID。记下客户端 ID 字符串,您将需要在应用中配置 Google 登录。

将用于 Google 登录的网址协议添加到您的项目中

Google 登录要求为您的项目添加自定义网址架构。如需添加自定义架构,请执行以下操作:

  1. 打开您的项目配置:在左侧的树状视图中双击项目名称。从目标部分中选择您的应用,然后选择信息标签页,并展开网址类型部分。

  2. 点击 + 按钮,然后将您的倒序客户端 ID 添加为网址架构。

    倒序客户端 ID 是指以点分隔字段的顺序颠倒的客户端 ID。例如:

    com.googleusercontent.apps.1234567890-abcdefg

完成上述操作后,您的配置应显示如下(但其中的值应替换为您的应用的值):

为应用签名

您的应用必须使用 Apple 颁发的证书进行签名,才能在 macOS 和 iOS 设备上以原生方式运行,以便通过密钥链存储凭据。

后续步骤

现在,您已经下载了项目依赖项并配置了 Xcode 项目,接下来就可以向您的 iOS 应用添加 Google 登录了。