Intégrer Google Sign-In à votre application iOS ou macOS

Cette page vous explique comment intégrer Google Sign-In à une application iOS ou macOS. Vous devrez peut-être adapter ces instructions au cycle de vie ou au modèle d'UI de votre application.

Avant de commencer

Téléchargez les dépendances, configurez votre projet Xcode et définissez votre ID client.

Essayez notre application exemple iOS et macOS pour découvrir comment fonctionne Sign-In.

1. Gérer l'URL de redirection de l'authentification

iOS: UIApplicationDelegate

Dans la méthode application:openURL:options de votre AppDelegate, appelez la fonction GIDSignIn Méthode handleURL::

func application(
  _ app: UIApplication,
  open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]
) -> Bool {
  var handled: Bool

  handled = GIDSignIn.sharedInstance.handle(url)
  if handled {
    return true
  }

  // Handle other custom URL types.

  // If not handled by this app, return false.
  return false
}

- (BOOL)application:(UIApplication *)app
            openURL:(NSURL *)url
            options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options {
  BOOL handled;

  handled = [GIDSignIn.sharedInstance handleURL:url];
  if (handled) {
    return YES;
  }

  // Handle other custom URL types.

  // If not handled by this app, return NO.
  return NO;
}

macOS: NSApplicationDelegate

1. Dans le composant AppDelegate de votre application, enregistrez un gestionnaire pour les événements kAEGetURL dans applicationDidFinishLaunching:

   Swift

   func applicationDidFinishLaunching(_ notification: Notification) {
     // Register for GetURL events.
     let appleEventManager = NSAppleEventManager.shared()
     appleEventManager.setEventHandler(
       self,
       andSelector: "handleGetURLEvent:replyEvent:",
       forEventClass: AEEventClass(kInternetEventClass),
       andEventID: AEEventID(kAEGetURL)
     )
   }
   

   Objective-C

   - (void)applicationDidFinishLaunching:(NSNotification *)aNotification {
     // Register for GetURL events.
     NSAppleEventManager *appleEventManager = [NSAppleEventManager sharedAppleEventManager];
     [appleEventManager setEventHandler:self
                        andSelector:@selector(handleGetURLEvent:withReplyEvent:)
                        forEventClass:kInternetEventClass
                        andEventID:kAEGetURL];
   }
   

2. Définissez le gestionnaire pour ces événements qui appelle le handleURL de GIDSignIn:

   Swift

   func handleGetURLEvent(event: NSAppleEventDescriptor?, replyEvent: NSAppleEventDescriptor?) {
       if let urlString =
         event?.paramDescriptor(forKeyword: AEKeyword(keyDirectObject))?.stringValue{
           let url = NSURL(string: urlString)
           GIDSignIn.sharedInstance.handle(url)
       }
   }
   

   Objective-C

   - (void)handleGetURLEvent:(NSAppleEventDescriptor *)event
              withReplyEvent:(NSAppleEventDescriptor *)replyEvent {
         NSString *URLString = [[event paramDescriptorForKeyword:keyDirectObject] stringValue];
         NSURL *URL = [NSURL URLWithString:URLString];
         [GIDSignIn.sharedInstance handleURL:url];
   }
   

SwiftUI

Dans la fenêtre ou la scène de votre application, enregistrez un gestionnaire pour recevoir l'URL et appeler handleURL de GIDSignIn:

@main
struct MyApp: App {

  var body: some Scene {
    WindowGroup {
      ContentView()
        // ...
        .onOpenURL { url in
          GIDSignIn.sharedInstance.handle(url)
        }
    }
  }
}

2. Essayer de restaurer l'état de connexion de l'utilisateur

Au démarrage de votre application, appelez restorePreviousSignInWithCallback pour essayer restaurer l'état de connexion des utilisateurs qui se sont déjà connectés à l'aide de Google ; Procéder à cette opération garantit que les utilisateurs n'ont pas à se connecter à chaque fois qu'ils ouvrent votre application (sauf s'il s'est déconnecté).

Les applications iOS le font souvent dans les applications UIApplicationDelegate la méthode application:didFinishLaunchingWithOptions: et applicationDidFinishLaunching: de NSApplicationDelegate pour les applications macOS. Utilisez le résultat pour déterminer la vue à présenter à l'utilisateur. Exemple :

func application(
  _ application: UIApplication,
  didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
) -> Bool {
  GIDSignIn.sharedInstance.restorePreviousSignIn { user, error in
    if error != nil || user == nil {
      // Show the app's signed-out state.
    } else {
      // Show the app's signed-in state.
    }
  }
  return true
}

- (BOOL)application:(UIApplication *)application
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  [GIDSignIn.sharedInstance restorePreviousSignInWithCompletion:^(GIDGoogleUser * _Nullable user,
                                                                  NSError * _Nullable error) {
    if (error) {
      // Show the app's signed-out state.
    } else {
      // Show the app's signed-in state.
    }
  }];
  return YES;
}

SwiftUI

Si vous utilisez SwiftUI, ajoutez un appel à restorePreviousSignIn dans onAppear pour votre vue initiale:

@main
struct MyApp: App {
  var body: some Scene {
    WindowGroup {
      ContentView()
        // ...
        .onAppear {
          GIDSignIn.sharedInstance.restorePreviousSignIn { user, error in
            // Check if `user` exists; otherwise, do something with `error`
          }
        }
    }
  }
}

3. Ajouter un bouton Google Sign-In

Ajouter un lien "Se connecter avec Google" à votre vue de connexion. Des composants pour SwiftUI et UIKit génèrent automatiquement un avec la marque Google et leur utilisation est recommandée.

4. Ajouter un bouton de déconnexion

1. Ajoutez à votre application un bouton de déconnexion, visible par les utilisateurs connectés.

2. Connecter le bouton à une méthode de ViewController qui appelle signOut: Par exemple, utilisez un IBAction:

   Swift

   @IBAction func signOut(sender: Any) {
     GIDSignIn.sharedInstance.signOut()
   }
   

   Objective-C

   - (IBAction)signOut:(id)sender {
     [GIDSignIn.sharedInstance signOut];
   }
   

Étapes suivantes

Maintenant que les utilisateurs peuvent se connecter à votre application à l'aide de leur compte Google, découvrez comment par:

• Obtenir l'analyse informations de profil du compte Google.
• Authentifiez-vous auprès de votre backend à l'aide de l'ID Google de l'utilisateur. à partir d'un jeton d'accès.
• Appelez les API Google au nom de l'utilisateur.