在 iOS 上使用 Google 登录服务进行身份验证

您可以将 Google 登录集成到您的应用中,让您的用户可使用自己的 Google 帐号进行 Firebase 身份验证。

开始之前

  1. 将 Firebase 添加到您的 iOS 项目。在您的 Podfile 中添加以下 pod:
    pod 'Firebase/Auth'
    pod 'GoogleSignIn'
    
  2. 如果您尚未将您的应用与 Firebase 项目相关联,请在 Firebase 控制台中将其关联。
  3. 在 Firebase 控制台中启用 Google 登录服务:
    1. Firebase 控制台中,打开 Authentication(身份验证)部分。
    2. 登录方法标签中,启用 Google 登录方法,然后点击保存

1. 导入所需的头文件

首先,您必须将 Firebase SDK 和 Google Sign-In SDK 的头文件导入到您的应用中。

Swift

在您的应用委托中,导入以下头文件:

import Firebase
import GoogleSignIn

在您的登录视图的视图控制器中,导入以下头文件:

import Firebase
import GoogleSignIn

Objective-C

在您的应用委托中,导入以下头文件:

@import Firebase;
@import GoogleSignIn;

在您的登录视图的视图控制器中,导入以下头文件:

@import Firebase;
@import GoogleSignIn;

2. 实现 Google 登录

按下列步骤实现 Google 登录。如需详细了解如何在 iOS 设备上使用 Google 登录,请参阅 Google 登录开发者文档

  1. 将自定义网址架构添加到您的 Xcode 项目中:
    1. 打开您的项目配置:在左侧的树状视图中双击项目名称。从 TARGETS 部分中选择您的应用,然后选择 Info 标签,并展开 URL Types 部分。
    2. 点击 + 按钮,并为您的倒序客户端 ID 添加一个网址架构。要找到该值,请打开 GoogleService-Info.plist 配置文件,然后查找 REVERSED_CLIENT_ID 键。复制该键的值,并将其粘贴到配置页面上的 URL Schemes 框中。将其他字段留空。

      完成上述操作后,您的配置应该类似于以下内容(但其中包含的值应替换为专门针对您的应用的值):

  2. 声明此应用委托实现了 GIDSignInDelegate 协议。

    Swift

    AppDelegate.swift 中:
    class AppDelegate: UIResponder, UIApplicationDelegate, GIDSignInDelegate {
    

    Objective-C

    AppDelegate.h 中:
    @interface AppDelegate : UIResponder<UIApplicationDelegate, GIDSignInDelegate>
    
  3. 在应用委托的 application:didFinishLaunchingWithOptions: 方法中,配置 FirebaseApp 对象并设置登录委托。

    Swift

    // Use Firebase library to configure APIs
    FirebaseApp.configure()
    
    GIDSignIn.sharedInstance().clientID = FirebaseApp.app()?.options.clientID
    GIDSignIn.sharedInstance().delegate = self
    

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
    
    [GIDSignIn sharedInstance].clientID = [FIRApp defaultApp].options.clientID;
    [GIDSignIn sharedInstance].delegate = self;
    
  4. 实现您的应用委托中的 application:openURL:options: 方法。此方法应该调用 GIDSignIn 实例的 handleURL 方法,该方法将对您的应用在身份验证过程结束时收到的网址进行适当处理。

    Swift

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

    Objective-C

    - (BOOL)application:(nonnull UIApplication *)application
                openURL:(nonnull NSURL *)url
                options:(nonnull NSDictionary<NSString *, id> *)options {
      return [[GIDSignIn sharedInstance] handleURL:url
             sourceApplication:options[UIApplicationOpenURLOptionsSourceApplicationKey]
                    annotation:options[UIApplicationOpenURLOptionsAnnotationKey]];
    }
    

    要让您的应用在 iOS 8 及更早版本上也能运行,还需要实现已弃用的 application:openURL:sourceApplication:annotation: 方法。

    Swift

    func application(_ application: UIApplication, open url: URL, sourceApplication: String?, annotation: Any) -> Bool {
        return GIDSignIn.sharedInstance().handle(url,
                                                 sourceApplication: sourceApplication,
                                                 annotation: annotation)
    }
    

    Objective-C

    - (BOOL)application:(UIApplication *)application
                openURL:(NSURL *)url
      sourceApplication:(NSString *)sourceApplication
             annotation:(id)annotation {
      return [[GIDSignIn sharedInstance] handleURL:url
                                 sourceApplication:sourceApplication
                                        annotation:annotation];
    }
    
  5. 在应用委托中,通过定义以下方法来实现 GIDSignInDelegate 协议,以便处理登录过程:

    Objective-C

    - (void)signIn:(GIDSignIn *)signIn
    didSignInForUser:(GIDGoogleUser *)user
         withError:(NSError *)error {
      // ...
      if (error == nil) {
        GIDAuthentication *authentication = user.authentication;
        FIRAuthCredential *credential =
        [FIRGoogleAuthProvider credentialWithIDToken:authentication.idToken
                                         accessToken:authentication.accessToken];
        // ...
      } else {
        // ...
      }
    }
    
    - (void)signIn:(GIDSignIn *)signIn
    didDisconnectWithUser:(GIDGoogleUser *)user
         withError:(NSError *)error {
      // Perform any operations when the user disconnects from app here.
      // ...
    }
    

    Swift

    func sign(_ signIn: GIDSignIn!, didSignInFor user: GIDGoogleUser!, withError error: Error?) {
      // ...
      if let error = error {
        // ...
        return
      }
    
      guard let authentication = user.authentication else { return }
      let credential = GoogleAuthProvider.credential(withIDToken: authentication.idToken,
                                                        accessToken: authentication.accessToken)
      // ...
    }
    
    func sign(_ signIn: GIDSignIn!, didDisconnectWith user: GIDGoogleUser!, withError error: Error!) {
        // Perform any operations when the user disconnects from app here.
        // ...
    }
    
  6. 声明您的登录视图的控制器实现了 GIDSignInUIDelegate 协议。

    Swift

    在视图控制器中:

    class MainViewController: UITableViewController, GIDSignInUIDelegate {
    

    Objective-C

    在视图控制器的头文件中:

    @interface MainViewController : UITableViewController<GIDSignInUIDelegate>
    
  7. 在视图控制器中,重写 viewDidLoad 方法以设置 GIDSignIn 对象的界面委托,并(可选)尽可能以静默方式登录。

    Objective-C

    - (void)viewDidLoad {
      [super viewDidLoad];
    
    [GIDSignIn sharedInstance].uiDelegate = self;
    [[GIDSignIn sharedInstance] signIn];
    
      // TODO(developer) Configure the sign-in button look/feel
      // ...
    }
    

    Swift

    override func viewDidLoad() {
      super.viewDidLoad()
    
    GIDSignIn.sharedInstance().uiDelegate = self
    GIDSignIn.sharedInstance().signIn()
    
      // TODO(developer) Configure the sign-in button look/feel
      // ...
    }
    
  8. GIDSignInButton 添加到您的故事板或 XIB 文件中,或以编程方式将其实例化。要将该按钮添加到您的故事板或 XIB 文件中,可添加一个视图,并将其自定义类设置为 GIDSignInButton
  9. 可选:如果要自定义该按钮,请执行以下操作:

    Swift

    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 身份验证

signIn:didSignInForUser:withError: 方法中,从 GIDAuthentication 对象中获取一个 Google ID 令牌和一个 Google 访问令牌,然后用它们换取一个 Firebase 凭据:

Swift

func sign(_ signIn: GIDSignIn!, didSignInFor user: GIDGoogleUser!, withError error: Error?) {
  // ...
  if let error = error {
    // ...
    return
  }

  guard let authentication = user.authentication else { return }
  let credential = GoogleAuthProvider.credential(withIDToken: authentication.idToken,
                                                    accessToken: authentication.accessToken)
  // ...
}

Objective-C

- (void)signIn:(GIDSignIn *)signIn
didSignInForUser:(GIDGoogleUser *)user
     withError:(NSError *)error {
  // ...
  if (error == nil) {
    GIDAuthentication *authentication = user.authentication;
    FIRAuthCredential *credential =
    [FIRGoogleAuthProvider credentialWithIDToken:authentication.idToken
                                     accessToken:authentication.accessToken];
    // ...
  } else {
    // ...
  }
}

最后,使用该凭据进行 Firebase 身份验证:

Swift

Auth.auth().signInAndRetrieveData(with: credential) { (authResult, error) in
  if let error = error {
    // ...
    return
  }
  // User is signed in
  // ...
}

Objective-C

[[FIRAuth auth] signInAndRetrieveDataWithCredential:credential
                                         completion:^(FIRAuthDataResult * _Nullable authResult,
                                                      NSError * _Nullable error) {
  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 实时数据库和 Cloud Storage 安全规则中,您可以从 auth 变量获取已登录用户的唯一用户 ID,然后用此 ID 来控制用户可以访问哪些数据。

您可以通过将身份验证提供方凭据关联至现有用户帐号,让用户可以使用多个身份验证提供方服务登录您的应用。

要让用户退出帐号,请调用 signOut:

Swift

    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;
}

您可能还需要添加适用于所有身份验证错误的错误处理代码。请参阅处理错误

发送以下问题的反馈:

此网页
需要帮助?请访问我们的支持页面