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

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

Hinweis

Installieren Sie eine aktuelle Version von Xcode.

Abhängigkeiten für Google Sign-in in Ihrem Projekt installieren

CocoaPods

  1. Wenn du CocoaPods noch nicht installiert hast, folge der Anleitung im Einstiegsleitfaden zu CocoaPods.

  2. Öffnen Sie ein Terminalfenster und wechseln Sie zum Verzeichnis mit dem Xcode-Projekt Ihrer App.

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

    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. Hinweis: Diese Datei unterscheidet sich von der im Lieferumfang enthaltenen .xcodeproj-Projektdatei, die beim Öffnen zu Build-Fehlern führen würde.

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

Swift Package Manager

  1. Öffnen Sie Ihr Projekt in Xcode.

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

    Repository https://github.com/google/GoogleSignIn-iOS
    Version 7.0.0
    Paketprodukt GoogleSignIn

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

    Paketprodukt GoogleSignInSwift

OAuth-Client-ID abrufen

Ihre App benötigt eine OAuth-Client-ID, um sich beim Authentifizierungs-Backend von Google zu identifizieren. Bei iOS- und macOS-Apps muss der Anwendungstyp der OAuth-Client-ID 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

Notieren Sie sich nach dem Erstellen der OAuth-Client-ID 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 herunterladen, um sie für später aufzubewahren.

Wenn Sie bereits eine OAuth-Client-ID erstellt haben, klicken Sie auf die Schaltfläche unten, um Ihre vorhandenen OAuth-Informationen aufzurufen.

Bestehende OAuth-Client-ID abrufen

OAuth-Server-Client-ID abrufen

Die meisten Apps müssen die Identität angemeldeter Nutzer an einen Back-End-Dienst weitergeben. Um die Identität von Nutzern, die sich mit Google angemeldet haben, sicher an Ihr Backend weiterzugeben, 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, die Server-Client-ID, die für Ihr Backend steht.

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 von Google Sign-In in Ihrer App benötigen.

Anwendungsprojekt konfigurieren

Für Google Log-in 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, indem Sie Ihre OAuth-Client-ID und ein benutzerdefiniertes URL-Schema basierend auf der umgekehrten Client-ID hinzufügen.

Die umgekehrte Client-ID ist Ihre Client-ID, bei der die Reihenfolge der durch Punkte getrennten Felder umgekehrt ist. Dieser Wert 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 Backend-Authentifizierung abrufen müssen, müssen Sie auch den Schlüssel GIDServerClientID in der Info.plist-Datei Ihrer App festlegen.

<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, wenn Sie einen OpenID-Realm angeben möchten.

<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, um Anmeldedaten über den Schlüsselbund zu speichern.

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.