開始使用適用於 iOS 和 macOS 的 Google 登入功能

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

您必須先下載依附元件並設定 Xcode 專案,才能開始將 iOS 或 macOS 應用程式與 Google 登入元件整合。本頁提供的步驟接下來,我們將說明後續步驟,瞭解如何將 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 套件管理員

  1. 在 Xcode 中開啟專案。

  2. 在應用程式中加入 Google 登入依附元件 (Xcode 說明文件):

    存放區 https://github.com/google/GoogleSignIn-iOS
    版本 6.0.2
    包裝產品 Google 登入
  3. 如果您使用 SwiftUI,請一併為「使用 Google 帳戶登入」按鈕新增下列擴充功能套件產品:

    包裝產品 Google 登入

取得 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:

  1. Cloud 控制台中開啟專案。

  2. 建立新的「網路應用程式」類型 OAuth 用戶端 ID。記下用戶端 ID 字串,您必須在應用程式中設定 Google 登入。

設定應用程式專案

Google 登入要求您的專案必須使用 OAuth 用戶端 ID 和自訂網址配置。或者,您也可以新增伺服器用戶端 ID 以進行後端驗證,或針對 Google Workspace 網域最佳化應用程式。

新增 OAuth 用戶端 ID 和自訂網址配置

更新應用程式的 Info.plist 檔案,以根據反向用戶端 ID 新增 OAuth 用戶端 ID 和自訂網址配置。

反向用戶端 ID 是指用戶端 ID,以半形句號分隔欄位的順序對調。當您在 Cloud 控制台中選取現有的 iOS OAuth 用戶端時,也會顯示在「iOS URL 配置」下。例如:com.googleusercontent.apps.1234567890-abcdefg

<key>GIDClientID</key>
<string>YOUR_IOS_CLIENT_ID</string>
<key>CFBundleURLTypes</key>
<array>
  <dict>
    <key>CFBundleURLSchemes</key>
    <array>
      <string>YOUR_DOT_REVERSED_IOS_CLIENT_ID</string>
    </array>
  </dict>
</array>

選用:設定後端驗證

如果您需要取得使用者的 ID 憑證以進行後端驗證,請一併在應用程式的 Info.plist 檔案中設定 GIDServerClientID 金鑰。

<key>GIDServerClientID</key>
<string>YOUR_SERVER_CLIENT_ID</string>

選用:針對 Google Workspace 網域或 OpenID 領域進行最佳化

如果您要最佳化 Google Workspace 網域的登入流程,請使用 GIDHostedDomain 參數。

<key>GIDHostedDomain</key>
<string>YOUR_HOSTED_DOMAIN</string>

如要指定 OpenID 運作範圍,請使用 GIDOpenIDRealm 參數。

<key>GIDOpenIDRealm</key>
<string>YOUR_OPENID_REALM</string>

簽署應用程式

您的應用程式必須以 Apple 核發的憑證進行簽署,才能在 macOS 和 iOS 裝置上以原生方式執行,以便透過鑰匙圈儲存憑證。

後續步驟

下載專案依附元件並設定 Xcode 專案後,您現在可以在 iOS 應用程式中加入 Google 登入功能。