開始使用 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，請同時為「登入」方塊 。」按鈕： 

    pod 'GoogleSignInSwiftSupport'

  6. 儲存檔案並執行： 

    pod install

  7. 開啟應用程式產生的 .xcworkspace 工作區檔案： Xcode應用程式日後的所有開發作業都將使用這個檔案。(注意： 與加入的 .xcodeproj 專案檔案不同， 開啟時會導致建構錯誤)。

    您可以參考 Objective-C 範例應用程式的 Podfile 例如，

Swift 套件管理工具

  1. 在 Xcode 中開啟專案。

  2. 將 Google 登入依附元件新增至應用程式 (Xcode 說明文件)：

    存放區 https://github.com/google/GoogleSignIn-iOS
    版本 7.0.0 版
    套件產品 GoogleSignIn

  3. 如果您使用 SwiftUI，請同時新增下列擴充功能套件產品 關於「使用 Google 帳戶登入」問題按鈕：

    套件產品 GoogleSignInSwift

取得 OAuth 用戶端 ID

您的應用程式需要 OAuth 用戶端 ID，以便我們在 Google 驗證中辨識自己 後端。iOS 和 macOS 應用程式的 OAuth 用戶端 ID 應用程式類型 必須設為 iOS。

如果您尚未建立 OAuth 用戶端 ID，請按一下按鈕 。

建立 OAuth 用戶端 ID

建立 OAuth 用戶端 ID 後，請記下用戶端 ID 字串， 您必須在應用程式中設定 Google 登入。您可以選擇 下載設定檔，其中包含用戶端 ID 和其他 設定資料以供日後參考

如果您已建立 OAuth 用戶端 ID， 請點選下方按鈕查看相關資訊。

取得現有的 OAuth 用戶端 ID

取得 OAuth 伺服器用戶端 ID

大多數應用程式都必須將已登入使用者的身分傳送至後端服務 或是某種程度上安全地傳遞使用 Google 帳戶登入的使用者身分 您需要使用 ID 權杖，如「透過後端伺服器進行驗證」一文所述。 擷取使用者的 ID 符記時，需要第二個用戶端 ID，也就是您的「伺服器」 代表您的後端。

如何建立伺服器用戶端 ID：

  1. 在 Cloud 控制台：

  2. 建立新的網頁應用程式類型 OAuth 用戶端 ID。記下 用戶端 ID 字串，您需要在 應用程式。

設定應用程式專案

Google 登入功能必須使用 OAuth 用戶端 ID 設定專案 和自訂網址通訊協定您也可以選擇新增以下項目的伺服器用戶端 ID： 後端驗證，或針對 Google Workspace 網域。

新增 OAuth 用戶端 ID 和自訂網址通訊協定

更新應用程式的 Info.plist 檔案以新增 OAuth 用戶端 ID 與自訂網址通訊協定 (根據撤銷的用戶端 ID)。

反轉的用戶端 ID 就是您的用戶端 ID，與以點分隔的順序排列 這兩個欄位會反向排序。這項資訊也會顯示在「iOS 網址配置」下方選取 Cloud 中現有的 iOS OAuth 用戶端 控制台。例如：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 領域進行最佳化

如要最佳化使用者的登入流程，請使用 GIDHostedDomain 參數 Google Workspace 網域

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

如要指定 OpenID 領域，請使用 GIDOpenIDRealm 參數。

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

簽署應用程式

您必須使用 Apple 核發的憑證簽署應用程式，才能執行 才能從 macOS 和 iOS 裝置上儲存憑證 。

後續步驟

您已下載專案依附元件，並設定 Xcode 可讓您在 iOS 應用程式中加入 Google 登入。