Bevor Sie mit der Integration Ihrer iOS- oder macOS-App in die Google Log-in-Komponenten 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 Google Log-in-Funktionen in Ihre App einbinden.
Hinweis
Installieren Sie eine aktuelle Version von Xcode.
Google Log-in-Abhängigkeiten in Ihrem Projekt installieren
CocoaPods
Wenn Sie CocoaPods noch nicht installiert haben, folgen Sie der Anleitung im CocoaPods Leitfaden für den Einstieg guide.
Öffnen Sie ein Terminalfenster und wechseln Sie zum Verzeichnis mit dem Xcode-Projekt Ihrer App.
Wenn Sie noch keine Podfile-Datei für Ihre Anwendung erstellt haben, tun Sie das jetzt:
pod init
Öffnen Sie die für Ihre Anwendung erstellte Podfile-Datei und fügen Sie Folgendes hinzu:
pod 'GoogleSignIn'
Wenn Sie SwiftUI verwenden, fügen Sie auch die Pod-Erweiterung für die Schaltfläche „Über Google anmelden“ hinzu:
pod 'GoogleSignInSwiftSupport'
Speichern Sie die Datei und führen Sie den folgenden Befehl aus:
pod install
Öffnen Sie die generierte
.xcworkspace-Datei Arbeitsbereich für Ihre Anwendung in Xcode. Verwenden Sie diese Datei für alle zukünftigen Entwicklungsphasen Ihrer Anwendung. Hinweis: Diese Datei unterscheidet sich von der enthaltenen.xcodeproj-Datei Projekt. Wenn Sie diese öffnen, treten Build-Fehler auf.Ein Beispiel finden Sie in der Objective-C-Beispiel-App Podfile.
Swift Package Manager
Öffnen Sie Ihr Projekt in Xcode.
Fügen Sie Ihrer App die Google Log-in-Abhängigkeiten hinzu (Xcode-Dokumentation):
Repository https://github.com/google/GoogleSignIn-iOSVersion 9.0.0 Paketprodukt GoogleSignIn Wenn Sie SwiftUI verwenden, fügen Sie auch das folgende Erweiterungspaketprodukt für die Schaltfläche „Über Google anmelden“ hinzu:
Paketprodukt 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 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.
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 für die spätere Verwendung herunterladen.
Wenn Sie bereits eine OAuth-Client-ID erstellt haben, können Sie Ihre vorhandenen OAuth-Informationen abrufen, indem Sie auf die Schaltfläche unten klicken.
Vorhandene OAuth-Client-ID abrufen
OAuth-Server-Client-ID abrufen
Die meisten Apps müssen die Identität angemeldeter Nutzer an einen Backend-Dienst weitergeben. Um die Identität von Nutzern, die sich über Google angemeldet haben sicher an Ihr Backend zu übergeben, verwenden Sie ID-Tokens, wie unter Mit einem Backend-Server authentifizieren beschrieben. Zum Abrufen des ID-Tokens eines Nutzers ist eine zweite Client-ID erforderlich, die Server-Client-ID, die Ihr Backend darstellt.
So erstellen Sie eine Server-Client-ID:
Öffnen Sie Ihr Projekt in der Cloud Console.
Erstellen Sie eine neue OAuth-Client-ID vom Typ Webanwendung. Notieren Sie sich den Client-ID-String, den Sie zum Konfigurieren von Google Log-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 Info.plist-Datei 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 ist. Sie wird auch unter "iOS-URL-Schema" angezeigt, wenn Sie in der Cloud
Console eine vorhandene iOS-OAuth-Client-ID
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 von Nutzern für die Backend-Authentifizierung,
abrufen müssen, legen Sie auch den GIDServerClientID Schlüssel in der Info.plist Datei 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, wenn Sie einen OpenID-Bereich 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 und Anmeldedaten mit Keychain gespeichert werden können.
Damit Ihre macOS-App Anmeldedaten mit Keychain speichern kann, müssen Sie außerdem $(AppIdentifierPrefix)$(CFBundleIdentifier) 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.