Google Log-in in die iOS- oder macOS-App einbinden

Auf dieser Seite erfahren Sie, wie Sie Google Log-in in eine iOS- oder macOS-App integrieren. Möglicherweise müssen Sie diese Anleitung an den Lebenszyklus oder das UI-Modell Ihrer App anpassen.

Hinweis

Laden Sie die Abhängigkeiten herunter, konfigurieren Sie Ihr Xcode-Projekt und legen Sie Ihre Client-ID fest.

Probieren Sie unsere Beispiel-App für iOS und macOS aus, um zu sehen, wie die Anmeldung funktioniert.

1. Die Weiterleitungs-URL für die Authentifizierung verarbeiten

iOS: UIApplicationDelegate

Rufen Sie in der Methode application:openURL:options von AppDelegate die Methode von GIDSignIn auf. Methode 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. Registrieren Sie in der AppDelegate-Datei einen Handler für kAEGetURL-Ereignisse in 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. Definieren Sie den Handler für diese Ereignisse, die das handleURL von GIDSignIn aufrufen:

   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

Registrieren Sie im Fenster oder in der Szene Ihrer App einen Handler, der die URL empfängt und GIDSignIn handleURL:

@main
struct MyApp: App {

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

2. Versuchen, den Anmeldestatus des Nutzers wiederherzustellen

Wenn die App gestartet wird, rufe restorePreviousSignInWithCallback auf, um zu versuchen, Anmeldestatus von Nutzern wiederherstellen, die sich bereits über Google angemeldet haben Vorgehensweise Nutzer müssen sich nicht jedes Mal anmelden, wenn sie Ihre App öffnen (es sei denn, sich abgemeldet hat.

iOS-Apps tun das oft in der UIApplicationDelegate application:didFinishLaunchingWithOptions:-Methode und applicationDidFinishLaunching: von NSApplicationDelegate für macOS-Apps. Verwenden Sie um zu bestimmen, welche Ansicht für den Nutzer präsentiert werden soll. Beispiel:

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

Wenn Sie SwiftUI verwenden, fügen Sie restorePreviousSignIn in onAppear für Ihre erste Ansicht:

@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. Google Log-in-Schaltfläche hinzufügen

„Über Google anmelden“ hinzufügen zur Anmeldeansicht hinzu. Es sind Komponenten für SwiftUI und UIKit verfügbar, die automatisch ein mit Google-Branding. Wir empfehlen, diese Schaltfläche zu verwenden.

4. Abmeldeschaltfläche hinzufügen

1. Fügen Sie Ihrer App eine Abmeldeschaltfläche hinzu, die für angemeldete Nutzer sichtbar ist.

2. Verbinden Sie die Schaltfläche mit einer Methode in Ihrem ViewController, die das Aufrufen von signOut: Verwenden Sie beispielsweise einen IBAction:

   Swift

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

   Objective-C

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

Nächste Schritte

Nutzer können sich jetzt mit ihren Google-Konten bei Ihrer App anmelden. Hier erfahren Sie, wie in:

• Nutzerdaten abrufen Profilinformationen für Ihr Google-Konto.
• Mit der Google-ID des Nutzers beim Backend authentifizieren Token.
• Google APIs im Namen des Nutzers aufrufen