Erste Schritte mit Google Log-in für iOS und macOS

Bevor Sie mit der Integration Ihrer iOS- oder macOS-App in die Google-Anmeldungskomponenten beginnen können, müssen Sie die Abhängigkeiten herunterladen und Ihr Xcode-Projekt konfigurieren. Die Schritte auf dieser Seite beschreiben genau das. In den nächsten Schritten wird dann beschrieben, wie Sie die Google-Anmeldefunktionen in Ihre App einbinden.

Hinweis

Installieren Sie eine aktuelle Version von Xcode.

Google Log-in-Abhängigkeiten in Ihrem Projekt installieren

CocoaPods

  1. Falls Sie CocoaPods noch nicht installiert haben, folgen Sie der Anleitung für den Einstieg.

  2. Öffnen Sie ein Terminalfenster und wechseln Sie zum Speicherort des Xcode-Projekts Ihrer App.

  3. Wenn Sie noch kein Podfile für Ihre Anwendung erstellt haben, tun Sie das jetzt: 

    pod init

  4. Öffnen Sie die für Ihre Anwendung erstellte Podfile-Datei und fügen Sie Folgendes hinzu: 

    pod 'GoogleSignIn'

  5. Wenn Sie SwiftUI verwenden, fügen Sie auch die Pod-Erweiterung für die Schaltfläche „Über Google anmelden“ hinzu: 

    pod 'GoogleSignInSwiftSupport'

  6. Speichern Sie die Datei und führen Sie den folgenden Befehl aus: 

    pod install

  7. Öffnen Sie die generierte .xcworkspace-Arbeitsbereichsdatei für Ihre Anwendung in Xcode. Verwenden Sie diese Datei für alle zukünftigen Entwicklungsphasen Ihrer App. Das ist nicht dasselbe wie die enthaltene .xcodeproj-Projektdatei, die beim Öffnen zu Build-Fehlern führen würde.

    Ein Beispiel finden Sie im Podfile der Objective-C-Beispiel-App.

Swift Package Manager

  1. Öffnen Sie Ihr Projekt in Xcode.

  2. Fügen Sie Ihrer App die Google-Anmeldung-Abhängigkeiten hinzu (Xcode-Dokumentation):

    Repository https://github.com/google/GoogleSignIn-iOS
    Version 9.0.0
    Produkt verpacken GoogleSignIn

  3. Wenn Sie SwiftUI verwenden, fügen Sie auch das folgende Erweiterungspaketprodukt für die Schaltfläche „Über Google anmelden“ hinzu:

    Produkt verpacken GoogleSignInSwift

OAuth-Client-ID abrufen

Ihre App benötigt eine OAuth-Client-ID, um sich beim Authentifizierungs-Backend von Google zu identifizieren. Für iOS- und macOS-Apps muss der OAuth-Client-ID-Anwendungstyp als „iOS“ konfiguriert sein.

Wenn Sie noch keine OAuth-Client-ID erstellt haben, klicken Sie auf die Schaltfläche unten, um dies zu tun.

OAuth-Client-ID erstellen

Nachdem Sie die OAuth-Client-ID erstellt haben, notieren Sie sich den Client-ID-String, den Sie zum Konfigurieren von Google Log-in in Ihrer App benötigen. Optional können Sie die Konfigurationsdatei mit Ihrer Client-ID und anderen Konfigurationsdaten zur späteren Verwendung herunterladen.

Wenn Sie bereits eine OAuth-Client-ID erstellt haben, können Sie Ihre vorhandenen OAuth-Informationen über die Schaltfläche unten aufrufen.

Bestehende OAuth-Client-ID abrufen

OAuth-Server-Client-ID abrufen

Bei den meisten Apps muss die Identität angemeldeter Nutzer an einen Back-End-Dienst übergeben werden. Um die Identität von Nutzern, die sich mit Google angemeldet haben, sicher an Ihr Backend zu übergeben, verwenden Sie ID-Tokens, wie unter Authentifizierung bei einem Backend-Server beschrieben. Zum Abrufen des ID-Tokens eines Nutzers ist eine zweite Client-ID erforderlich, nämlich die Client-ID Ihres Servers, die Ihr Backend darstellt.

So erstellen Sie eine Server-Client-ID:

  1. Öffnen Sie Ihr Projekt in der Cloud Console.

  2. Erstellen Sie eine neue OAuth-Client-ID vom Typ Webanwendung. Notieren Sie sich den Client-ID-String, den Sie zum Konfigurieren der Google-Anmeldung in Ihrer App benötigen.

Anwendungsprojekt konfigurieren

Für die Anmeldung über Google muss Ihr Projekt mit Ihrer OAuth-Client-ID und einem benutzerdefinierten URL-Schema konfiguriert sein. Optional können Sie auch Ihre Server-Client-ID für die Backend-Authentifizierung hinzufügen oder Ihre App für Ihre Google Workspace-Domain optimieren.

OAuth-Client-ID und benutzerdefiniertes URL-Schema hinzufügen

Aktualisieren Sie die Datei Info.plist Ihrer App, um Ihre OAuth-Client-ID und ein benutzerdefiniertes URL-Schema basierend auf der umgekehrten Client-ID hinzuzufügen.

Die umgekehrte Client-ID ist Ihre Client-ID, bei der die Reihenfolge der durch Punkte getrennten Felder umgekehrt wurde. Diese wird auch unter iOS-URL-Schema angezeigt, wenn Sie einen vorhandenen iOS-OAuth-Client in der Cloud Console auswählen. Beispiel: 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>

Optional: Backend-Authentifizierung konfigurieren

Wenn Sie die ID-Tokens der Nutzer für die Back-End-Authentifizierung benötigen, legen Sie auch den Schlüssel GIDServerClientID in der Datei Info.plist Ihrer App fest.

<key>GIDServerClientID</key>
<string>YOUR_SERVER_CLIENT_ID</string>

Optional: Für eine Google Workspace-Domain oder einen OpenID-Realm optimieren

Verwenden Sie den Parameter GIDHostedDomain, wenn Sie den Anmeldevorgang für eine Google Workspace-Domain optimieren möchten.

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

Verwenden Sie den Parameter GIDOpenIDRealm, um einen OpenID-Realm anzugeben.

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

Anwendung signieren

Ihre Anwendung muss mit einem von Apple ausgestellten Zertifikat signiert sein, damit sie nativ auf macOS- und iOS-Geräten ausgeführt werden kann und Anmeldedaten im Schlüsselbund gespeichert werden können.

Damit Ihre macOS-App Anmeldedaten mithilfe von Keychain speichern kann, müssen Sie $(AppIdentifierPrefix)$(CFBundleIdentifier) auch der Keychain-Zugriffsgruppe hinzufügen.

Nächste Schritte

Nachdem Sie die Projektabhängigkeiten heruntergeladen und Ihr Xcode-Projekt konfiguriert haben, können Sie Ihrer iOS-App Google Log-in hinzufügen.