iOS Consumer SDK herunterladen

Plattform auswählen: Android iOS JavaScript

Wenn Sie On-Demand-Fahrten in Ihren iOS-Verbraucher-Apps verfolgen möchten, verwenden Sie das Consumer SDK. Weitere Informationen und eine Einführung zum Verfolgen von Fahrten finden Sie unter Fahrt in iOS verfolgen.

Beispiele finden Sie in den iOS-Beispiel-Apps oder in den kombinierten Beispielen.

So richten Sie das Consumer SDK für Ihre iOS-Verbraucher-App ein:

1. Prüfen Sie die Mindestsystemanforderungen.
2. Consumer SDK herunterladen
3. Datenschutzmanifestdatei von Apple prüfen
4. Google Cloud Console-Projekt konfigurieren
5. Authentifizierungstokens abrufen
6. Consumer SDK initialisieren

Mindestsystemanforderungen prüfen

In den Versionshinweisen finden Sie die Mindestanforderungen für die von Ihnen verwendete Version des Consumer SDK. Weitere Informationen finden Sie in den Versionshinweisen.

• Auf dem Mobilgerät muss iOS 16 oder höher installiert sein.
• Apple Xcode Version 26 oder höher.

Consumer SDK abrufen

Sie installieren und konfigurieren das Consumer SDK mit CocoaPods.

Swift Package Manager

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

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

1. Öffnen Sie Ihr Xcode-project oder workspace und gehen Sie dann zu File > Add Package Dependencies (Datei > Paketabhängigkeiten hinzufügen).
2. Geben Sie https://github.com/googlemaps/ios-consumer-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 Abhängigkeitsregel eine der versionsbasierten Optionen fest. Für neue Projekte empfehlen wir, die aktuelle Version anzugeben und die Option „Genaue Version“ zu verwenden. Klicken Sie anschließend auf „Paket hinzufügen“.
4. Prüfen Sie im Fenster Paketprodukte auswählen, ob GoogleRidesharingConsumer dem angegebenen main-Ziel hinzugefügt wird. Klicken Sie anschließend auf „Paket hinzufügen“.
5. Rufen Sie den Bereich Allgemein des Ziels auf, um die Installation zu prüfen. Unter Frameworks, Libraries, and Embedded Content (Frameworks, Bibliotheken und eingebettete Inhalte) sollten die installierten Pakete angezeigt werden. Sie können auch den Abschnitt „Package Dependencies“ (Paketabhängigkeiten) im „Project Navigator“ (Projektnavigator) aufrufen, um das Paket und seine Version zu prüfen.

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

1. Gehen Sie in Xcode zu File > Packages > Update To Latest Package Versions.
2. Prüfen Sie die Installation im Abschnitt Paketabhängigkeiten des Project Navigator, um das Paket und seine Version zu bestätigen.

Wichtig: Manchmal können Artefakte nicht aufgelöst werden oder es treten Fehler auf. Wählen Sie in diesem Fall „File > Packages > Reset Package Cache“ aus.

So entfernen Sie das vorhandene, manuell installierte Consumer SDK:

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

   • GoogleRidesharingConsumer.xcframework

2. Entfernen Sie das GoogleRidesharingConsumer-Bundle aus dem obersten Verzeichnis Ihres Xcode-Projekts.

Mit 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 im Startleitfaden für CocoaPods.

2. Podfile für das Consumer SDK erstellen: Sie verwenden das Podfile, um die API und ihre Abhängigkeiten zu installieren.

   1. Erstelle in deinem Projektverzeichnis eine Datei mit dem Namen Podfile. In dieser Datei werden die Abhängigkeiten Ihres Projekts definiert.

   2. Bearbeiten Sie die Podfile-Datei und fügen Sie Ihre Abhängigkeiten hinzu. Hier ist ein Beispiel mit den Abhängigkeiten:

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

   3. Podfile speichern: Öffnen Sie ein Terminal und rufen Sie den Ordner mit dem Podfile auf:

      cd <path-to-project>
      

3. Führen Sie den Befehl „pod install“ aus: Mit diesem Befehl werden die in der Podfile angegebenen APIs zusammen mit allen Abhängigkeiten installiert.

   pod install
   

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

   Hinweis: Führen Sie pod outdated regelmäßig aus, um zu prüfen, ob eine neuere Version des SDK verfügbar ist. Weitere Informationen finden Sie in den Versionshinweisen zum Consumer SDK unter „Consumer SDK-Versionen“.

Manuelle Installation

In diesem Leitfaden wird beschrieben, wie Sie das XCFramework mit dem Consumer SDK manuell zu Ihrem Projekt hinzufügen und die Build-Einstellungen in Xcode konfigurieren.

Achtung: Es empfiehlt sich, das Consumer SDK nach Möglichkeit mit Cocoapods zu installieren.

Führen Sie folgende Schritte aus, bevor Sie diese Anleitung durcharbeiten:

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

• Installieren Sie das Maps SDK.

1. Laden Sie das SDK-Binärprogramm und die Ressourcen herunter:

   • GoogleRidesharingConsumer.xcframework
   • GoogleRidesharingConsumer.bundle
   • gRPCCertificates.bundle

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

3. Starten Sie Xcode und öffnen oder erstellen Sie ein Projekt. Wenn Sie neu bei iOS sind, erstellen Sie ein neues Projekt und wählen Sie die Vorlage „iOS-App“ aus.

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

5. Ziehen Sie die heruntergeladene Datei gRPCCertificates.bundle in das Verzeichnis der obersten Ebene Ihres Xcode-Projekts. Wenn Sie dazu aufgefordert werden, wählen Sie Elemente kopieren aus.

6. Ziehen Sie die Datei GoogleRidesharingConsumer.xcframework in Ihr Projekt unter Frameworks, Libraries, and Embedded Content, um das Consumer SDK zu installieren. Wählen Sie bei Aufforderung Elemente kopieren aus.

7. Ziehen Sie die heruntergeladene GoogleRidesharingConsumer.bundle-Datei in das Verzeichnis auf oberster Ebene Ihres Xcode-Projekts. Wählen Sie bei Aufforderung Elemente kopieren aus.

8. Wählen Sie Ihr Projekt im Project Navigator und dann das Ziel Ihrer Anwendung aus.

9. Öffnen Sie den Tab Build Phases und fügen Sie unter Link Binary with Libraries die folgenden Frameworks und Bibliotheken hinzu, falls sie noch nicht vorhanden sind:

   • Accelerate.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreImage.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libz.tbd
   • Metal.framework
   • OpenGLES.framework
   • QuartzCore.framework
   • SystemConfiguration.framework
   • UIKit.framework

10. Wählen Sie Ihr Projekt und nicht ein bestimmtes Ziel aus und öffnen Sie den Tab Build Settings (Build-Einstellungen). Fügen Sie im Abschnitt Other Linker Flags (Andere Linker-Flags) -ObjC für Debug und Release hinzu.

    Wenn diese Einstellungen nicht sichtbar sind, ändern Sie den Filter in der Leiste Build-Einstellungen von Basic in Alle.

Datenschutzmanifestdatei von Apple prüfen

Apple verlangt Datenschutzdetails für Apps im App Store. Aktuelle Informationen und weitere Details finden Sie auf der Detailseite mit Datenschutzinformationen im Apple App Store.

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 einen Datenschutzbericht aus dem Archiv.

Nächste Schritte

Google Cloud Console-Projekt konfigurieren