Check out what’s new from Firebase at Google I/O 2022. Learn more

在 Apple 平台上使用 Google 登錄進行身份驗證

您可以通過將 Google Sign-In 集成到您的應用中，讓您的用戶使用他們的 Google 帳戶向 Firebase 進行身份驗證。

在你開始之前

  1. 將 Firebase 添加到您的 Apple 項目中。在您的Podfile中包含以下 pod：
    pod 'FirebaseAuth'
pod 'GoogleSignIn'
  2. 如果您尚未將應用連接到 Firebase 項目，請從Firebase 控制台執行此操作。
  3. 在 Firebase 控制台中啟用 Google 作為登錄方法：
    1. 在Firebase 控制台中，打開Auth部分。
    2. 在登錄方法選項卡上，啟用Google登錄方法並單擊保存。

1.導​​入需要的頭文件

首先，您必須將 Firebase SDK 和 Google Sign-In SDK 頭文件導入您的應用。

迅速

import FirebaseCore
import GoogleSignIn

Objective-C

@import FirebaseCore;
@import GoogleSignIn;

2. 實施谷歌登錄

按照以下步驟實施 Google 登錄。有關在 iOS 中使用 Google Sign-In 的詳細信息，請參閱Google Sign-In 開發人員文檔。

  1. 將自定義 URL 方案添加到您的 Xcode 項目：
    1. 打開您的項目配置：雙擊左側樹視圖中的項目名稱。從TARGETS部分中選擇您的應用程序，然後選擇Info選項卡，然後展開URL Types部分。
    2. 單擊+按鈕，並為您的反向客戶端 ID 添加 URL 方案。要查找此值，請打開GoogleService-Info.plist配置文件，然後查找REVERSED_CLIENT_ID鍵。複製該鍵的值，並將其粘貼到配置頁面上的URL 方案框中。將其他字段留空。

      完成後，您的配置應類似於以下內容（但使用特定於應用程序的值）：

  2. 在您的應用委託的application:didFinishLaunchingWithOptions:方法中，配置FirebaseApp對象。

    迅速

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    Objective-C

    // Use Firebase library to configure APIs
[FIRApp configure];
  3. 實現應用程序委託的application:openURL:options:方法。該方法應調用GIDSignIn實例的handleURL方法，該方法將正確處理您的應用程序在身份驗證過程結束時收到的 URL。

    迅速

    @available(iOS 9.0, *)
func application(_ application: UIApplication, open url: URL,
                 options: [UIApplication.OpenURLOptionsKey: Any])
  -> Bool {
  return GIDSignIn.sharedInstance.handle(url)
}

    Objective-C

    - (BOOL)application:(nonnull UIApplication *)application
            openURL:(nonnull NSURL *)url
            options:(nonnull NSDictionary<NSString *, id> *)options {
  return [[GIDSignIn sharedInstance] handleURL:url];
}
  4. 將應用的呈現視圖控制器和客戶端 ID 傳遞給 Google Sign In 登錄方法，並從生成的 Google 身份驗證令牌創建 Firebase 身份驗證憑據：

    迅速

    guard let clientID = FirebaseApp.app()?.options.clientID else { return }

// Create Google Sign In configuration object.
let config = GIDConfiguration(clientID: clientID)

// Start the sign in flow!
GIDSignIn.sharedInstance.signIn(with: config, presenting: self) { [unowned self] user, error in

  if let error = error {
    // ...
    return
  }

  guard
    let authentication = user?.authentication,
    let idToken = authentication.idToken
  else {
    return
  }

  let credential = GoogleAuthProvider.credential(withIDToken: idToken,
                                                 accessToken: authentication.accessToken)

  // ...
}

    Objective-C

    GIDConfiguration *config = [[GIDConfiguration alloc] initWithClientID:[FIRApp defaultApp].options.clientID];

__weak __auto_type weakSelf = self;
[GIDSignIn.sharedInstance signInWithConfiguration:config presentingViewController:self callback:^(GIDGoogleUser * _Nullable user, NSError * _Nullable error) {
  __auto_type strongSelf = weakSelf;
  if (strongSelf == nil) { return; }

  if (error == nil) {
    GIDAuthentication *authentication = user.authentication;
    FIRAuthCredential *credential =
    [FIRGoogleAuthProvider credentialWithIDToken:authentication.idToken
                                     accessToken:authentication.accessToken];
    // ...
  } else {
    // ...
  }
}];
  5. 將GIDSignInButton添加到您的故事板、XIB 文件，或以編程方式對其進行實例化。要將按鈕添加到情節提要或 XIB 文件，請添加一個 View 並將其自定義類設置為GIDSignInButton 。
  6. 可選：如果要自定義按鈕，請執行以下操作：

    迅速

    1. 在您的視圖控制器中，將登錄按鈕聲明為屬性。 
      @IBOutlet weak var signInButton: GIDSignInButton!
    2. 將按鈕連接到您剛剛聲明的signInButton屬性。
    3. 通過設置GIDSignInButton對象的屬性來自定義按鈕。

    Objective-C

    1. 在視圖控制器的頭文件中，將登錄按鈕聲明為屬性。 
      @property(weak, nonatomic) IBOutlet GIDSignInButton *signInButton;
    2. 將按鈕連接到您剛剛聲明的signInButton屬性。
    3. 通過設置GIDSignInButton對象的屬性來自定義按鈕。

3. 使用 Firebase 進行身份驗證

最後，使用上一步中創建的身份驗證憑據完成 Firebase 登錄過程。

迅速

Auth.auth().signIn(with: credential) { authResult, error in
    if let error = error {
      let authError = error as NSError
      if isMFAEnabled, authError.code == AuthErrorCode.secondFactorRequired.rawValue {
        // The user is a multi-factor user. Second factor challenge is required.
        let resolver = authError
          .userInfo[AuthErrorUserInfoMultiFactorResolverKey] as! MultiFactorResolver
        var displayNameString = ""
        for tmpFactorInfo in resolver.hints {
          displayNameString += tmpFactorInfo.displayName ?? ""
          displayNameString += " "
        }
        self.showTextInputPrompt(
          withMessage: "Select factor to sign in\n\(displayNameString)",
          completionBlock: { userPressedOK, displayName in
            var selectedHint: PhoneMultiFactorInfo?
            for tmpFactorInfo in resolver.hints {
              if displayName == tmpFactorInfo.displayName {
                selectedHint = tmpFactorInfo as? PhoneMultiFactorInfo
              }
            }
            PhoneAuthProvider.provider()
              .verifyPhoneNumber(with: selectedHint!, uiDelegate: nil,
                                 multiFactorSession: resolver
                                   .session) { verificationID, error in
                if error != nil {
                  print(
                    "Multi factor start sign in failed. Error: \(error.debugDescription)"
                  )
                } else {
                  self.showTextInputPrompt(
                    withMessage: "Verification code for \(selectedHint?.displayName ?? "")",
                    completionBlock: { userPressedOK, verificationCode in
                      let credential: PhoneAuthCredential? = PhoneAuthProvider.provider()
                        .credential(withVerificationID: verificationID!,
                                    verificationCode: verificationCode!)
                      let assertion: MultiFactorAssertion? = PhoneMultiFactorGenerator
                        .assertion(with: credential!)
                      resolver.resolveSignIn(with: assertion!) { authResult, error in
                        if error != nil {
                          print(
                            "Multi factor finanlize sign in failed. Error: \(error.debugDescription)"
                          )
                        } else {
                          self.navigationController?.popViewController(animated: true)
                        }
                      }
                    }
                  )
                }
              }
          }
        )
      } else {
        self.showMessagePrompt(error.localizedDescription)
        return
      }
      // ...
      return
    }
    // User is signed in
    // ...
}

Objective-C

[[FIRAuth auth] signInWithCredential:credential
                          completion:^(FIRAuthDataResult * _Nullable authResult,
                                       NSError * _Nullable error) {
    if (isMFAEnabled && error && error.code == FIRAuthErrorCodeSecondFactorRequired) {
      FIRMultiFactorResolver *resolver = error.userInfo[FIRAuthErrorUserInfoMultiFactorResolverKey];
      NSMutableString *displayNameString = [NSMutableString string];
      for (FIRMultiFactorInfo *tmpFactorInfo in resolver.hints) {
        [displayNameString appendString:tmpFactorInfo.displayName];
        [displayNameString appendString:@" "];
      }
      [self showTextInputPromptWithMessage:[NSString stringWithFormat:@"Select factor to sign in\n%@", displayNameString]
                           completionBlock:^(BOOL userPressedOK, NSString *_Nullable displayName) {
       FIRPhoneMultiFactorInfo* selectedHint;
       for (FIRMultiFactorInfo *tmpFactorInfo in resolver.hints) {
         if ([displayName isEqualToString:tmpFactorInfo.displayName]) {
           selectedHint = (FIRPhoneMultiFactorInfo *)tmpFactorInfo;
         }
       }
       [FIRPhoneAuthProvider.provider
        verifyPhoneNumberWithMultiFactorInfo:selectedHint
        UIDelegate:nil
        multiFactorSession:resolver.session
        completion:^(NSString * _Nullable verificationID, NSError * _Nullable error) {
          if (error) {
            [self showMessagePrompt:error.localizedDescription];
          } else {
            [self showTextInputPromptWithMessage:[NSString stringWithFormat:@"Verification code for %@", selectedHint.displayName]
                                 completionBlock:^(BOOL userPressedOK, NSString *_Nullable verificationCode) {
             FIRPhoneAuthCredential *credential =
                 [[FIRPhoneAuthProvider provider] credentialWithVerificationID:verificationID
                                                              verificationCode:verificationCode];
             FIRMultiFactorAssertion *assertion = [FIRPhoneMultiFactorGenerator assertionWithCredential:credential];
             [resolver resolveSignInWithAssertion:assertion completion:^(FIRAuthDataResult * _Nullable authResult, NSError * _Nullable error) {
               if (error) {
                 [self showMessagePrompt:error.localizedDescription];
               } else {
                 NSLog(@"Multi factor finanlize sign in succeeded.");
               }
             }];
           }];
          }
        }];
     }];
    }
  else if (error) {
    // ...
    return;
  }
  // User successfully signed in. Get user data from the FIRUser object
  if (authResult == nil) { return; }
  FIRUser *user = authResult.user;
  // ...
}];

下一步

用戶首次登錄後，會創建一個新用戶帳戶並將其鏈接到憑據（即用戶名和密碼、電話號碼或身份驗證提供商信息），即用戶登錄時使用的憑據。這個新帳戶作為 Firebase 項目的一部分存儲，可用於在項目中的每個應用中識別用戶，無論用戶如何登錄。

  • 在您的應用程序中，您可以從FIRUser對象獲取用戶的基本個人資料信息。請參閱管理用戶。

  • 在您的 Firebase 實時數據庫和雲存儲安全規則中，您可以從auth變量中獲取登錄用戶的唯一用戶 ID，並使用它來控制用戶可以訪問哪些數據。

您可以通過將身份驗證提供程序憑據鏈接到現有用戶帳戶來允許用戶使用多個身份驗證提供程序登錄您的應用程序。

要註銷用戶，請調用signOut: 。

迅速

    let firebaseAuth = Auth.auth()
do {
  try firebaseAuth.signOut()
} catch let signOutError as NSError {
  print("Error signing out: %@", signOutError)
}

Objective-C

    NSError *signOutError;
BOOL status = [[FIRAuth auth] signOut:&signOutError];
if (!status) {
  NSLog(@"Error signing out: %@", signOutError);
  return;
}

您可能還想為所有身份驗證錯誤添加錯誤處理代碼。請參閱處理錯誤。

,

您可以通過將 Google Sign-In 集成到您的應用中，讓您的用戶使用他們的 Google 帳戶向 Firebase 進行身份驗證。

在你開始之前

  1. 將 Firebase 添加到您的 Apple 項目中。在您的Podfile中包含以下 pod：
    pod 'FirebaseAuth'
pod 'GoogleSignIn'
  2. 如果您尚未將應用連接到 Firebase 項目，請從Firebase 控制台執行此操作。
  3. 在 Firebase 控制台中啟用 Google 作為登錄方法：
    1. 在Firebase 控制台中，打開Auth部分。
    2. 在登錄方法選項卡上，啟用Google登錄方法並單擊保存。

1.導​​入需要的頭文件

首先，您必須將 Firebase SDK 和 Google Sign-In SDK 頭文件導入您的應用。

迅速

import FirebaseCore
import GoogleSignIn

Objective-C

@import FirebaseCore;
@import GoogleSignIn;

2. 實施谷歌登錄

按照以下步驟實施 Google 登錄。有關在 iOS 中使用 Google Sign-In 的詳細信息，請參閱Google Sign-In 開發人員文檔。

  1. 將自定義 URL 方案添加到您的 Xcode 項目：
    1. 打開您的項目配置：雙擊左側樹視圖中的項目名稱。從TARGETS部分中選擇您的應用程序，然後選擇Info選項卡，然後展開URL Types部分。
    2. 單擊+按鈕，並為您的反向客戶端 ID 添加 URL 方案。要查找此值，請打開GoogleService-Info.plist配置文件，然後查找REVERSED_CLIENT_ID鍵。複製該鍵的值，並將其粘貼到配置頁面上的URL 方案框中。將其他字段留空。

      完成後，您的配置應類似於以下內容（但使用特定於應用程序的值）：

  2. 在您的應用委託的application:didFinishLaunchingWithOptions:方法中，配置FirebaseApp對象。

    迅速

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    Objective-C

    // Use Firebase library to configure APIs
[FIRApp configure];
  3. 實現應用程序委託的application:openURL:options:方法。該方法應調用GIDSignIn實例的handleURL方法，該方法將正確處理您的應用程序在身份驗證過程結束時收到的 URL。

    迅速

    @available(iOS 9.0, *)
func application(_ application: UIApplication, open url: URL,
                 options: [UIApplication.OpenURLOptionsKey: Any])
  -> Bool {
  return GIDSignIn.sharedInstance.handle(url)
}

    Objective-C

    - (BOOL)application:(nonnull UIApplication *)application
            openURL:(nonnull NSURL *)url
            options:(nonnull NSDictionary<NSString *, id> *)options {
  return [[GIDSignIn sharedInstance] handleURL:url];
}
  4. 將應用的呈現視圖控制器和客戶端 ID 傳遞給 Google Sign In 登錄方法，並從生成的 Google 身份驗證令牌創建 Firebase 身份驗證憑據：

    迅速

    guard let clientID = FirebaseApp.app()?.options.clientID else { return }

// Create Google Sign In configuration object.
let config = GIDConfiguration(clientID: clientID)

// Start the sign in flow!
GIDSignIn.sharedInstance.signIn(with: config, presenting: self) { [unowned self] user, error in

  if let error = error {
    // ...
    return
  }

  guard
    let authentication = user?.authentication,
    let idToken = authentication.idToken
  else {
    return
  }

  let credential = GoogleAuthProvider.credential(withIDToken: idToken,
                                                 accessToken: authentication.accessToken)

  // ...
}

    Objective-C

    GIDConfiguration *config = [[GIDConfiguration alloc] initWithClientID:[FIRApp defaultApp].options.clientID];

__weak __auto_type weakSelf = self;
[GIDSignIn.sharedInstance signInWithConfiguration:config presentingViewController:self callback:^(GIDGoogleUser * _Nullable user, NSError * _Nullable error) {
  __auto_type strongSelf = weakSelf;
  if (strongSelf == nil) { return; }

  if (error == nil) {
    GIDAuthentication *authentication = user.authentication;
    FIRAuthCredential *credential =
    [FIRGoogleAuthProvider credentialWithIDToken:authentication.idToken
                                     accessToken:authentication.accessToken];
    // ...
  } else {
    // ...
  }
}];
  5. 將GIDSignInButton添加到您的故事板、XIB 文件，或以編程方式對其進行實例化。要將按鈕添加到情節提要或 XIB 文件，請添加一個 View 並將其自定義類設置為GIDSignInButton 。
  6. 可選：如果要自定義按鈕，請執行以下操作：

    迅速

    1. 在您的視圖控制器中，將登錄按鈕聲明為屬性。 
      @IBOutlet weak var signInButton: GIDSignInButton!
    2. 將按鈕連接到您剛剛聲明的signInButton屬性。
    3. 通過設置GIDSignInButton對象的屬性來自定義按鈕。

    Objective-C

    1. 在視圖控制器的頭文件中，將登錄按鈕聲明為屬性。 
      @property(weak, nonatomic) IBOutlet GIDSignInButton *signInButton;
    2. 將按鈕連接到您剛剛聲明的signInButton屬性。
    3. 通過設置GIDSignInButton對象的屬性來自定義按鈕。

3. 使用 Firebase 進行身份驗證

最後，使用上一步中創建的身份驗證憑據完成 Firebase 登錄過程。

迅速

Auth.auth().signIn(with: credential) { authResult, error in
    if let error = error {
      let authError = error as NSError
      if isMFAEnabled, authError.code == AuthErrorCode.secondFactorRequired.rawValue {
        // The user is a multi-factor user. Second factor challenge is required.
        let resolver = authError
          .userInfo[AuthErrorUserInfoMultiFactorResolverKey] as! MultiFactorResolver
        var displayNameString = ""
        for tmpFactorInfo in resolver.hints {
          displayNameString += tmpFactorInfo.displayName ?? ""
          displayNameString += " "
        }
        self.showTextInputPrompt(
          withMessage: "Select factor to sign in\n\(displayNameString)",
          completionBlock: { userPressedOK, displayName in
            var selectedHint: PhoneMultiFactorInfo?
            for tmpFactorInfo in resolver.hints {
              if displayName == tmpFactorInfo.displayName {
                selectedHint = tmpFactorInfo as? PhoneMultiFactorInfo
              }
            }
            PhoneAuthProvider.provider()
              .verifyPhoneNumber(with: selectedHint!, uiDelegate: nil,
                                 multiFactorSession: resolver
                                   .session) { verificationID, error in
                if error != nil {
                  print(
                    "Multi factor start sign in failed. Error: \(error.debugDescription)"
                  )
                } else {
                  self.showTextInputPrompt(
                    withMessage: "Verification code for \(selectedHint?.displayName ?? "")",
                    completionBlock: { userPressedOK, verificationCode in
                      let credential: PhoneAuthCredential? = PhoneAuthProvider.provider()
                        .credential(withVerificationID: verificationID!,
                                    verificationCode: verificationCode!)
                      let assertion: MultiFactorAssertion? = PhoneMultiFactorGenerator
                        .assertion(with: credential!)
                      resolver.resolveSignIn(with: assertion!) { authResult, error in
                        if error != nil {
                          print(
                            "Multi factor finanlize sign in failed. Error: \(error.debugDescription)"
                          )
                        } else {
                          self.navigationController?.popViewController(animated: true)
                        }
                      }
                    }
                  )
                }
              }
          }
        )
      } else {
        self.showMessagePrompt(error.localizedDescription)
        return
      }
      // ...
      return
    }
    // User is signed in
    // ...
}

Objective-C

[[FIRAuth auth] signInWithCredential:credential
                          completion:^(FIRAuthDataResult * _Nullable authResult,
                                       NSError * _Nullable error) {
    if (isMFAEnabled && error && error.code == FIRAuthErrorCodeSecondFactorRequired) {
      FIRMultiFactorResolver *resolver = error.userInfo[FIRAuthErrorUserInfoMultiFactorResolverKey];
      NSMutableString *displayNameString = [NSMutableString string];
      for (FIRMultiFactorInfo *tmpFactorInfo in resolver.hints) {
        [displayNameString appendString:tmpFactorInfo.displayName];
        [displayNameString appendString:@" "];
      }
      [self showTextInputPromptWithMessage:[NSString stringWithFormat:@"Select factor to sign in\n%@", displayNameString]
                           completionBlock:^(BOOL userPressedOK, NSString *_Nullable displayName) {
       FIRPhoneMultiFactorInfo* selectedHint;
       for (FIRMultiFactorInfo *tmpFactorInfo in resolver.hints) {
         if ([displayName isEqualToString:tmpFactorInfo.displayName]) {
           selectedHint = (FIRPhoneMultiFactorInfo *)tmpFactorInfo;
         }
       }
       [FIRPhoneAuthProvider.provider
        verifyPhoneNumberWithMultiFactorInfo:selectedHint
        UIDelegate:nil
        multiFactorSession:resolver.session
        completion:^(NSString * _Nullable verificationID, NSError * _Nullable error) {
          if (error) {
            [self showMessagePrompt:error.localizedDescription];
          } else {
            [self showTextInputPromptWithMessage:[NSString stringWithFormat:@"Verification code for %@", selectedHint.displayName]
                                 completionBlock:^(BOOL userPressedOK, NSString *_Nullable verificationCode) {
             FIRPhoneAuthCredential *credential =
                 [[FIRPhoneAuthProvider provider] credentialWithVerificationID:verificationID
                                                              verificationCode:verificationCode];
             FIRMultiFactorAssertion *assertion = [FIRPhoneMultiFactorGenerator assertionWithCredential:credential];
             [resolver resolveSignInWithAssertion:assertion completion:^(FIRAuthDataResult * _Nullable authResult, NSError * _Nullable error) {
               if (error) {
                 [self showMessagePrompt:error.localizedDescription];
               } else {
                 NSLog(@"Multi factor finanlize sign in succeeded.");
               }
             }];
           }];
          }
        }];
     }];
    }
  else if (error) {
    // ...
    return;
  }
  // User successfully signed in. Get user data from the FIRUser object
  if (authResult == nil) { return; }
  FIRUser *user = authResult.user;
  // ...
}];

下一步

用戶首次登錄後，會創建一個新用戶帳戶並將其鏈接到憑據（即用戶名和密碼、電話號碼或身份驗證提供商信息），即用戶登錄時使用的憑據。這個新帳戶作為 Firebase 項目的一部分存儲，可用於在項目中的每個應用中識別用戶，無論用戶如何登錄。

  • 在您的應用程序中，您可以從FIRUser對象獲取用戶的基本個人資料信息。請參閱管理用戶。

  • 在您的 Firebase 實時數據庫和雲存儲安全規則中，您可以從auth變量中獲取登錄用戶的唯一用戶 ID，並使用它來控制用戶可以訪問哪些數據。

您可以通過將身份驗證提供程序憑據鏈接到現有用戶帳戶來允許用戶使用多個身份驗證提供程序登錄您的應用程序。

要註銷用戶，請調用signOut: 。

迅速

    let firebaseAuth = Auth.auth()
do {
  try firebaseAuth.signOut()
} catch let signOutError as NSError {
  print("Error signing out: %@", signOutError)
}

Objective-C

    NSError *signOutError;
BOOL status = [[FIRAuth auth] signOut:&signOutError];
if (!status) {
  NSLog(@"Error signing out: %@", signOutError);
  return;
}

您可能還想為所有身份驗證錯誤添加錯誤處理代碼。請參閱處理錯誤。