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:
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.comzu nennen.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.
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
CocoaPods-Tool installieren: Öffnen Sie ein Terminalfenster und führen Sie den folgenden Befehl aus.
sudo gem install cocoapodsWeitere Informationen finden Sie in der Anleitung Erste Schritte mit CocoaPods.
Podfile für das Driver SDK erstellen: Mit der Podfile-Datei installieren Sie die API und ihre Abhängigkeiten.
Erstellen Sie in Ihrem Projektverzeichnis eine Datei mit dem Namen
Podfile. In dieser Datei sind die Abhängigkeiten des Projekts definiert.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' endHier 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' endPodfile speichern: Öffnen Sie ein Terminal und wechseln Sie zu dem Ordner mit der Podfile-Datei:
cd <path-to-project>
Befehl „pod install“ ausführen: Dadurch werden die in der Podfile-Datei angegebenen APIs und ggf. zugehörige Abhängigkeiten installiert.
pod installProjekt 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:
-
Öffnen Sie Ihr Xcode-
projectoder Ihrenworkspaceund gehen Sie dann zu File > Add Package Dependencies. - 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).
-
Wenn Sie eine bestimmte
versioninstallieren 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:
- 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:
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
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:
Laden Sie die SDK-Binärdatei und ‑Ressourcen herunter:
Entpacken Sie die ZIP-Dateien, um auf das XCFramework und die Ressourcen zuzugreifen.
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.
Wenn Ihre Projektgruppe keine Frameworks-Gruppe enthält, erstellen Sie sie.
Wenn Sie das Driver SDK installieren möchten, ziehen Sie die Datei
GoogleRidesharingDriver.xcframeworkin 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.Ziehen Sie das heruntergeladene
GoogleRidesharingDriver.bundlein das Verzeichnis der obersten Ebene Ihres Xcode-Projekts. Wählen Sie bei Aufforderung Copy items if needed (Elemente bei Bedarf kopieren) aus.Wählen Sie im Project Navigator (Projektnavigator) Ihr Projekt aus und geben Sie dann das Ziel Ihrer App an.
Ö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.frameworkAudioToolbox.frameworkAVFoundation.frameworkCoreData.frameworkCoreGraphics.frameworkCoreLocation.frameworkCoreTelephony.frameworkCoreText.frameworkGLKit.frameworkImageIO.frameworklibc++.tbdlibxml2.tbdlibz.tbdLocalAuthentication.frameworkOpenGLES.frameworkQuartzCore.frameworkSystemConfiguration.frameworkUIKit.frameworkWebKit.framework
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
-ObjChinzu.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