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

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

  1. Wenn Sie CocoaPods noch nicht installiert haben, folgen Sie der Anleitung in der CocoaPods Erste Schritte .

  2. Öffnen Sie ein Terminalfenster und gehen Sie zum Speicherort des Xcode Ihrer App. Projekt arbeiten.

  3. Wenn Sie noch keine Podfile-Datei für Ihre Anwendung erstellt haben, erstellen Sie eine. 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 mit Google“ Schaltfläche: 

    pod 'GoogleSignInSwiftSupport'

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

    pod install

  7. Ö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

  1. Öffnen Sie Ihr Projekt in Xcode.

  2. 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

  3. 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.

OAuth-Client-ID erstellen

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:

  1. Öffnen Sie Ihr Projekt im Cloud Console:

  2. 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.