Bevor du deine iOS- oder macOS-App in die Komponenten von Google Log-in einbinden kannst, musst du die Abhängigkeiten herunterladen und dein Xcode-Projekt konfigurieren. Genau das tun die Schritte auf dieser Seite. In den nächsten Schritten wird beschrieben, wie du die Google Log-in-Funktionen in deine App einbindest.
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 Startleitfaden zu CocoaPods.
Öffnen Sie ein Terminalfenster und gehen Sie zum Speicherort des Xcode-Projekts Ihrer Anwendung.
Wenn Sie noch keine Podfile-Datei für Ihre Anwendung erstellt haben, erstellen Sie jetzt eine:
pod init
Öffnen Sie die Podfile-Datei, die für Ihre Anwendung erstellt wurde, 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 folgenden Befehl aus:
pod install
Öffnen Sie die generierte
.xcworkspace-Datei workspace für Ihre Anwendung in Xcode. Verwenden Sie diese Datei für alle zukünftigen Entwicklungen Ihrer App. Hinweis: Dies unterscheidet sich von der enthaltenen.xcodeproj-Projektdatei, die beim Öffnen Build-Fehler verursachen würde.Ein Beispiel hierfür finden Sie in der Podfile-Datei der Objective-C-Beispielanwendung.
Swift Package Manager
Öffnen Sie Ihr Projekt in Xcode.
Fügen Sie Ihrer Anwendung die Google Log-in-Abhängigkeiten hinzu (Xcode-Dokumentation):
Repository https://github.com/google/GoogleSignIn-iOSVersion 7.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 Anwendung benötigt eine OAuth-Client-ID, um sich beim Authentifizierungs-Back-End von Google zu identifizieren. Für iOS- und macOS-Apps muss der OAuth-Client-ID-Anwendungstyp als iOS konfiguriert werden.
Wenn du noch keine OAuth-Client-ID erstellt hast, klicke dazu 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 Anwendung benötigen. Optional können Sie die Konfigurationsdatei herunterladen, die Ihre Client-ID und andere Konfigurationsdaten für die zukünftige Verwendung enthält.
Wenn Sie bereits eine OAuth-Client-ID erstellt haben, finden Sie die vorhandenen OAuth-Informationen, indem Sie auf die Schaltfläche unten klicken.
Vorhandene OAuth-Client-ID abrufen
OAuth-Server-Client-ID abrufen
Die meisten Anwendungen müssen die Identität angemeldeter Nutzer an einen Back-End-Dienst übergeben. Um die Identität von Nutzern, die sich über Google angemeldet haben, sicher an Ihr Back-End zu übergeben, verwenden Sie ID-Tokens, wie unter Authentifizierung bei einem Back-End-Server beschrieben. Zum Abrufen des ID-Tokens eines Nutzers ist eine zweite Client-ID – Ihre Server-Client-ID – erforderlich, die Ihr Back-End 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 Back-End-Authentifizierung hinzufügen oder die Anwendung für Ihre Google Workspace-Domain optimieren.
OAuth-Client-ID und benutzerdefiniertes URL-Schema hinzufügen
Aktualisieren Sie die Datei Info.plist Ihrer Anwendung, um Ihre OAuth-Client-ID und ein Schema für benutzerdefinierte URLs hinzuzufügen, das auf der umgekehrten Client-ID basiert.
Die umgekehrte Client-ID ist Ihre Client-ID, wobei die Reihenfolge der durch Punkte getrennten Felder umgekehrt ist. Dies 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: Back-End-Authentifizierung konfigurieren
Wenn Sie die ID-Tokens der Nutzer für die Back-End-Authentifizierung abrufen müssen, legen Sie auch den Schlüssel GIDServerClientID in der Datei Info.plist Ihrer Anwendung fest.
<key>GIDServerClientID</key> <string>YOUR_SERVER_CLIENT_ID</string>
Optional: Für eine Google Workspace-Domain oder einen OpenID-Bereich 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, damit Anmeldedaten über den Schlüsselbund gespeichert werden können.
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.