Treiber SDK herunterladen

In diesem Abschnitt wird beschrieben, wie Sie prüfen, ob Ihr System die Mindestanforderungen erfüllt, Ihre Workspace-Gruppe einrichten und das Driver SDK abrufen.

Hinweis

Für das Driver SDK for iOS muss Ihre App die folgenden Kriterien erfüllen:

  • Das Navigation SDK muss installiert sein.
  • Aktivieren Sie das Maps SDK for iOS in der Google Cloud Console und rufen Sie einen API-Schlüssel ab.

Mindestsystemanforderungen prüfen

In den Versionshinweisen finden Sie die Mindestanforderungen für die Version des Driver SDK, die Sie verwenden. Weitere Informationen finden Sie in den Versionshinweisen.

  • Auf dem Mobilgerät muss iOS 16 oder höher ausgeführt werden.
  • Apple Xcode Version 26 oder höher.

Zugriff auf Google Workspace erhalten

Wenn Sie Google Workspace-Kunde sind,führen Sie die folgenden Schritte aus:

  1. Erstellen Sie eine Workspace-Gruppe. Weitere Informationen finden Sie unter Workspace-Gruppe.

    Wir empfehlen, Ihre Gruppe bei der Einrichtung beispielsweise google-maps-platform-sdk-users@workspacedomain.com zu nennen.

  2. Geben Sie den Namen an Google weiter, damit Ihre Workspace-Gruppe einer Zulassungsliste hinzugefügt werden kann, die Zugriff auf die richtigen CocoaPods-Repositories gewährt.

  3. Prüfen Sie, ob die E‑Mail-Adressen der Nutzer und Dienstkonten, die Zugriff benötigen, in dieser Liste enthalten sind.

Wenn Ihre Organisation keine Workspace-Gruppen erstellen kann , senden Sie Google eine Liste der E‑Mail-Adressen von Nutzern und Dienstkonten, die Zugriff auf diese Artefakte benötigen.

Mit dem Cloud SDK anmelden

Melden Sie sich für die lokale Entwicklung mit dem Cloud SDK an. Weitere Informationen finden Sie unter gcloud CLI installieren.

Die folgenden Beispiele zeigen, wie Sie sich mit dem Cloud SDK anmelden.

gcloud

gcloud auth login

Sie müssen eine E‑Mail-Adresse verwenden, die Mitglied der Workspace-Gruppe ist.

Automatisierungshosts einrichten

Richten Sie für Build-Systeme oder die kontinuierliche Integration Ihre Automatisierungshosts anhand der bereitgestellten Liste der Methoden zum Authentifizieren bei Google APIs und ‑Diensten mit einem Dienstkonto ein. Weitere Informationen finden Sie im Abschnitt zu Dienstkonten auf der Seite Authentifizierungsmethoden bei Google.

  • Wenn Ihr Prozess in einer Google Cloud-Umgebung ausgeführt wird, verwenden Sie die automatische Anmeldedatenerkennung. Weitere Informationen finden Sie unter Automatische Anmeldedatenerkennung.

  • Andernfalls speichern Sie die Dienstkontoschlüsseldatei an einem sicheren Ort im Dateisystem des Hosts und legen Sie die Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS entsprechend fest. Weitere Informationen finden Sie unter GOOGLE_APPLICATION_CREDENTIALS.

Die E‑Mail-Adresse des Dienstkontos, die mit den Anmeldedaten verknüpft ist, muss Mitglied der Workspace-Gruppe sein.

Driver SDK abrufen

Installieren und konfigurieren Sie das Driver SDK.

CocoaPods

  1. CocoaPods-Tool installieren: Öffnen Sie ein Terminalfenster und führen Sie den folgenden Befehl aus.

    sudo gem install cocoapods
    

    Weitere Informationen finden Sie in der Anleitung Erste Schritte mit CocoaPods.

  2. Podfile für das Driver SDK erstellen: Mit der Podfile-Datei installieren Sie die API und ihre Abhängigkeiten.

    1. Erstellen Sie in Ihrem Projektverzeichnis eine Datei mit dem Namen Podfile. In dieser Datei sind die Abhängigkeiten des Projekts definiert.

    2. Bearbeiten Sie die Podfile-Datei und fügen Sie die Abhängigkeiten hinzu. Hier ein Beispiel, das die Abhängigkeiten enthält:

      source "https://github.com/CocoaPods/Specs.git"
      
      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver'
      end
      

      Hier ein Beispiel, das die Alpha- und Beta-Pods für das Driver SDK als Abhängigkeiten enthält:

      source "https://cpdc-eap.googlesource.com/ridesharing-driver-sdk.git"
      source "https://github.com/CocoaPods/Specs.git"
      
      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver'
      end
      
    3. Podfile speichern: Öffnen Sie ein Terminal und wechseln Sie zu dem Ordner mit der Podfile-Datei:

      cd <path-to-project>
      
  3. Befehl „pod install“ ausführen: Dadurch werden die in der Podfile-Datei angegebenen APIs und ggf. zugehörige Abhängigkeiten installiert.

    pod install
    
  4. Projekt in Xcode öffnen: Schließen Sie Xcode und öffnen Sie dann mit einem Doppelklick die Datei „.xcworkspace“ Ihres Projekts, um Xcode wieder zu starten. Wenn Sie das Projekt später öffnen möchten, verwenden Sie die Datei „.xcworkspace“.

Swift Package Manager

Das Driver SDK kann über den Swift Package Manager installiert werden. Wenn Sie das SDK hinzufügen möchten, müssen Sie alle vorhandenen Driver SDK-Abhängigkeiten entfernen.

So fügen Sie das SDK einem neuen oder vorhandenen Projekt hinzu:

  1. Öffnen Sie Ihr Xcode-project oder Ihren workspace und gehen Sie dann zu File > Add Package Dependencies.
  2. Geben Sie https://github.com/googlemaps/ios-driver-sdk als URL ein, drücken Sie die Eingabetaste , um das Paket abzurufen, und klicken Sie auf „Add Package“ (Paket hinzufügen).
  3. Wenn Sie eine bestimmte version installieren möchten, legen Sie im Feld Dependency Rule eine der der versionsbasierten Optionen fest. Für neue Projekte empfehlen wir, die neueste Version anzugeben und die Option „Exact Version“ (Genaue Version) zu verwenden. Klicken Sie nach Abschluss des Vorgangs auf „Add Package“ (Paket hinzufügen).

So aktualisieren Sie das package für ein vorhandenes Projekt:

  1. Prüfen Sie die Installation im Bereich Package Dependencies (Paketabhängigkeiten) des Project Navigator (Projektnavigator) Dort sehen Sie das Paket und seine Version.

So entfernen Sie das vorhandene Driver SDK, das manuell installiert wurde:

  1. Suchen Sie in den Konfigurationseinstellungen Ihres Xcode-Projekts nach Frameworks, Libraries, and Embedded Content (Frameworks, Bibliotheken und eingebettete Inhalte). Entfernen Sie das folgende Framework mit dem Minuszeichen (-):

    • GoogleRidesharingDriver.xcframework
  2. Entfernen Sie das GoogleRidesharingDriver-Bundle aus dem Verzeichnis der obersten Ebene Ihres Xcode-Projekts.

Manuelle Installation

In diesem Leitfaden erfahren Sie, wie Sie das XCFramework mit dem Driver SDK manuell in Ihr Projekt einfügen und die Build-Einstellungen in Xcode konfigurieren.

Bevor Sie dieser Anleitung folgen, führen Sie die folgenden Schritte aus:

  • Laden Sie das XCFramework herunter, ein Binärpaket, mit dem Sie das Driver SDK installieren. Sie können dieses Paket auf mehreren Plattformen verwenden, einschließlich Computern mit Apple-Silizium

  • Installieren Sie das Navigation SDK.

So installieren Sie das Driver SDK manuell:

  1. Laden Sie die SDK-Binärdatei und ‑Ressourcen herunter:

  2. Entpacken Sie die ZIP-Dateien, um auf das XCFramework und die Ressourcen zuzugreifen.

  3. Starten Sie Xcode und öffnen Sie ein vorhandenes Projekt oder erstellen Sie ein neues. Wenn Sie neu bei iOS sind, erstellen Sie ein neues Projekt und wählen Sie die Vorlage für iOS-Apps aus.

  4. Wenn Ihre Projektgruppe keine Frameworks-Gruppe enthält, erstellen Sie sie.

  5. Wenn Sie das Driver SDK installieren möchten, ziehen Sie die Datei GoogleRidesharingDriver.xcframework in Ihr Projekt unter Frameworks, Libraries, and Embedded Content (Frameworks, Bibliotheken und eingebettete Inhalte). Wählen Sie bei Aufforderung Copy items if needed (Elemente bei Bedarf kopieren) aus.

  6. Ziehen Sie das heruntergeladene GoogleRidesharingDriver.bundle in das Verzeichnis der obersten Ebene Ihres Xcode-Projekts. Wählen Sie bei Aufforderung Copy items if needed (Elemente bei Bedarf kopieren) aus.

  7. Wählen Sie im Project Navigator (Projektnavigator) Ihr Projekt aus und geben Sie dann das Ziel Ihrer App an.

  8. Öffnen Sie den Tab Build Phases (Build-Phasen) und fügen Sie unter Link Binary with Libraries (Binärdatei mit Bibliotheken verknüpfen) die folgenden Frameworks und Bibliotheken hinzu, falls sie noch nicht vorhanden sind:

    • Accelerate.framework
    • AudioToolbox.framework
    • AVFoundation.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreLocation.framework
    • CoreTelephony.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libxml2.tbd
    • libz.tbd
    • LocalAuthentication.framework
    • OpenGLES.framework
    • QuartzCore.framework
    • SystemConfiguration.framework
    • UIKit.framework
    • WebKit.framework
  9. Wählen Sie statt eines bestimmten Ziels Ihr Projekt aus und öffnen Sie den Tab Build Settings (Build-Einstellungen). Fügen Sie im Bereich Other Linker Flags (Weitere Verknüpfungsmerker) für Debug- und Release-Builds -ObjC hinzu.

    Falls die Einstellungen nicht angezeigt werden, filtern Sie in der Leiste Build Settings (Build-Einstellungen) nicht mehr nach Basic (Standard), sondern nach All (Alle).

Datenschutzmanifestdatei von Apple prüfen

Apple verlangt Angaben zum Datenschutz für Apps im App Store. Auf der Seite Datenschutzdetails im Apple App Store finden Sie Updates und weitere Informationen.

Die Datenschutzmanifestdatei von Apple ist im Ressourcen-Bundle für das SDK enthalten. Wenn Sie prüfen möchten, ob die Datenschutzmanifestdatei enthalten ist, und ihren Inhalt einsehen möchten, erstellen Sie ein Archiv Ihrer App und generieren Sie daraus einen Datenschutzbericht.

Nächste Schritte

Google Cloud Console-Projekt konfigurieren