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 genau das tun können. In den nächsten Schritten wird beschrieben, wie die Google Log-in-Funktionen in deine App ein.
Hinweis
Installieren Sie eine aktuelle Version von Xcode.
Google Log-in-Abhängigkeiten im Projekt installieren
CocoaPods
Wenn Sie CocoaPods noch nicht installiert haben, folgen Sie der Anleitung in der CocoaPods Erste Schritte .
Öffnen Sie ein Terminalfenster und gehen Sie zum Speicherort des Xcode Ihrer App. Projekt arbeiten.
Wenn Sie noch keine Podfile-Datei für Ihre Anwendung erstellt haben, erstellen Sie eine. 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 mit Google“ Schaltfläche:
pod 'GoogleSignInSwiftSupport'
Speichern Sie die Datei und führen Sie den folgenden Befehl aus:
pod install
Öffnen Sie die generierte workspace-Datei
.xcworkspace
für Ihre Anwendung in Xcode. Verwenden Sie diese Datei für alle zukünftigen Entwicklungen Ihrer Anwendung. (Hinweis Sie unterscheidet sich von der enthaltenen Projektdatei.xcodeproj
, die führt beim Öffnen zu Build-Fehlern.)Weitere Informationen finden Sie in der Dokumentation der Objective-C-Beispiel-App Podfile finden Sie ein Beispiel.
Swift-Paketmanager
Öffnen Sie Ihr Projekt in Xcode.
Der App die Google Log-in-Abhängigkeiten hinzufügen (Xcode-Dokumentation):
Repository https://github.com/google/GoogleSignIn-iOS
Version 7.0.0 Paketprodukt GoogleSignIn Wenn Sie SwiftUI verwenden, fügen Sie außerdem das folgende Erweiterungspaket hinzu: für die Option „Über Google anmelden“ Schaltfläche:
Paketprodukt GoogleSignInSwift
OAuth-Client-ID abrufen
Deine Anwendung benötigt eine OAuth-Client-ID, um sich bei der Authentifizierung von Google zu identifizieren Back-End. iOS- und macOS-Apps: OAuth-Client-ID-Anwendungstyp muss als iOS konfiguriert sein.
Wenn du noch keine OAuth-Client-ID erstellt hast, klicke auf die Schaltfläche unten.
Nachdem Sie die OAuth-Client-ID erstellt haben, notieren Sie sich den Client-ID-String, der müssen Sie Google Log-in in Ihrer App konfigurieren. Sie können optional laden Sie die Konfigurationsdatei herunter, die Ihre Client-ID und andere Konfigurationsdaten zur späteren Verwendung.
Wenn du bereits eine OAuth-Client-ID erstellt hast, kannst du die vorhandene OAuth-Client-ID aufrufen. indem Sie auf die Schaltfläche unten klicken.
<ph type="x-smartling-placeholder"></ph> Vorhandene OAuth-Client-ID abrufen
OAuth-Server-Client-ID abrufen
Die meisten Apps müssen die Identität angemeldeter Nutzer an einen Back-End-Dienst übergeben. irgendwie anders. Um die Identität von Nutzern, die sich über Google angemeldet haben, sicher weiterzugeben. in Ihrem Back-End verwenden, 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 erforderlich: Ihr Server Client-ID, die Ihr Back-End darstellt.
So erstellen Sie eine Server-Client-ID:
Öffnen Sie Ihr Projekt im Cloud Console:
Erstellen Sie eine neue OAuth-Client-ID vom Typ Webanwendung. Beachten Sie die Client-ID-String, den Sie zum Konfigurieren von Google Log-in in Ihrem
Anwendungsprojekt konfigurieren
Für Google Log-in muss dein Projekt mit deiner OAuth-Client-ID konfiguriert sein und ein Schema für benutzerdefinierte URLs. Optional können Sie auch Ihre Server-Client-ID für Back-End-Authentifizierung oder optimieren Sie Ihre Anwendung für Ihre Google Workspace-Domain.
OAuth-Client-ID und benutzerdefiniertes URL-Schema hinzufügen
Aktualisieren Sie die Datei Info.plist
Ihrer Anwendung, um Ihr OAuth hinzuzufügen
Client-ID und ein benutzerdefiniertes URL-Schema basierend auf der umgekehrten Client-ID.
Die umgekehrte Client-ID ist Ihre Client-ID in der Reihenfolge
Felder umgekehrt. Dies wird auch unter iOS-URL-Schema angezeigt. wenn Sie ein
Vorhandener iOS-OAuth-Client in der Cloud
Console 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 Informationen ID-Tokens für die Back-End-Authentifizierung
Legen Sie auch den Schlüssel GIDServerClientID
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-Bereich optimieren
Verwenden Sie den Parameter GIDHostedDomain
, wenn Sie den Anmeldevorgang für
eine Google Workspace-Domain.
<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 ausgeführt werden kann. nativ auf macOS- und iOS-Geräten, um Anmeldedaten über das Schlüsselanhänger.
Nächste Schritte
Nachdem Sie nun die Projektabhängigkeiten heruntergeladen und Xcode konfiguriert haben, -Projekt können Sie Google Log-in zu Ihrer iOS-App hinzufügen.