Nachdem Sie die Abrechnung aktiviert und einen API-Schlüssel erstellt haben, können Sie das Xcode-Projekt für die Entwicklung Ihrer App einrichten.
Für jeden Release sind Versionshinweisen verfügbar.
Schritt 1: Erforderliche Software installieren
Wenn Sie ein Projekt mit dem Navigation SDK for iOS erstellen möchten, müssen Sie Folgendes herunterladen und installieren:
- Xcode 15.0 oder höher
Schritt 2: Xcode-Projekt erstellen und Navigation SDK installieren
Swift Package Manager
Das Navigation SDK kann über den Swift Package Manager installiert werden. Bevor Sie das SDK hinzufügen, müssen Sie alle vorhandenen Navigation SDK-Abhängigkeiten entfernen.
So fügen Sie das SDK einem neuen oder vorhandenen Projekt hinzu:
-
Öffnen Sie Xcode
project
oderworkspace
und gehen Sie zu Datei > Paketabhängigkeiten hinzufügen. - Geben Sie https://github.com/googlemaps/ios-navigation-sdk als URL ein, drücken Sie die Eingabetaste, um das Paket einzubinden, und klicken Sie auf „Paket hinzufügen“.
-
Wenn Sie eine bestimmte
version
installieren möchten, legen Sie im Feld Abhängigkeitsregel eine der versionbasierten Optionen fest. Für neue Projekte empfehlen wir, die neueste Version anzugeben und die Option „Genaue Version“ zu verwenden. Klicken Sie dann auf „Paket hinzufügen“.
So aktualisieren Sie die package
für ein bestehendes Projekt:
- Um die Installation zu überprüfen, rufen Sie im Project Navigator den Bereich Package Dependencies auf, um das Paket und seine Version zu prüfen.
-
Suchen Sie in den Konfigurationseinstellungen Ihres Xcode-Projekts nach Frameworks, Bibliotheken und eingebetteten Inhalten. Verwenden Sie das Minuszeichen (–), um das folgende Framework zu entfernen:
GoogleMaps.xcframework
GoogleNavigation.xcframework
-
Entfernen Sie das
GoogleMaps
-Bundle aus dem Verzeichnis der obersten Ebene Ihres Xcode-Projekts.
Manuelle Installation
In diesem Leitfaden erfährst du, wie du die XCFrameworks mit dem Navigation SDK for iOS und dem Maps SDK for iOS manuell in dein Projekt einfügst und die Build-Einstellungen in Xcode konfigurierst. Ein XCFramework ist ein Binärpaket, das auf mehreren Plattformen verwendet werden kann, einschließlich Computern mit dem M1-Chipsatz.
So installieren Sie die XCFrameworks für das Navigation SDK for iOS und das Maps SDK for iOS:
- Laden Sie die folgenden SDK-Binärdateien und -Ressourcendateien herunter:
- Starte Xcode und öffne ein vorhandenes oder erstelle ein neues Projekt. Wenn Sie noch keine Erfahrung mit iOS haben, erstellen Sie ein neues Projekt und wählen Sie die Vorlage für iOS-Apps aus.
- Entfernen Sie alle vorhandenen Verweise auf Google Maps, Navigation und Orte aus dem Projekt.
- Ziehen Sie die folgenden XCFrameworks unter Frameworks, Libraries und eingebettete Inhalte in Ihr Projekt, um sowohl das Maps SDK als auch das Navigation SDK zu installieren. Wählen Sie dazu bei Aufforderung die Option Copy items if needed (Elemente bei Bedarf kopieren) aus:
GoogleMaps.xcframework
GoogleNavigation.xcframework
- Ziehen Sie
GoogleMaps.bundle
aus dem heruntergeladenen GoogleMapsResources-Verzeichnis in das oberste Verzeichnis Ihres Xcode-Projekts. Achte darauf, dass Copy items if needed (Elemente bei Bedarf kopieren) ausgewählt ist. - Ziehen Sie
GoogleNavigation.bundle
aus dem heruntergeladenen GoogleNavigationResources-Verzeichnis in das Stammverzeichnis Ihres Xcode-Projekts. Achte darauf, dass Copy items into destination group's folder (Elemente in Ordner der Zielgruppe kopieren) ausgewählt ist. - Wähle im Project Navigator dein Projekt aus und gib dann das Ziel deiner App an.
- Öffne den Tab Build Phases (Build-Phasen) und füge unter Link Binary with Libraries (Binärdatei mit Bibliotheken verknüpfen) die folgenden Frameworks und Bibliotheken hinzu:
Accelerate.framework
AudioToolbox.framework
AVFoundation.framework
Contacts.framework
CoreData.framework
CoreGraphics.framework
CoreImage.framework
CoreLocation.framework
CoreTelephony.framework
CoreText.framework
GLKit.framework
ImageIO.framework
libc++.tbd
libxml2.tbd
libz.tbd
Metal.framework
OpenGLES.framework
QuartzCore.framework
Security.framework
SystemConfiguration.framework
UIKit.framework
UserNotifications.framework
WebKit.framework
- Wählen Sie im Ziel Ihrer Anwendung den Tab Funktionen aus, aktivieren Sie Hintergrundmodi und aktivieren Sie die folgenden Modi:
- Audio, AirPlay und Bild im Bild
- Standortaktualisierungen
- Wähle statt eines bestimmten Ziels dein Projekt aus und öffne den Tab Build-Einstellungen. Fügen Sie im Bereich Other Linker Flags (Weitere Verknüpfungsmerker) sowohl für debug als auch für release den Code
‑ObjC
hinzu. Falls die Einstellungen nicht angezeigt werden, filtere in der Leiste Build Settings nicht mehr nach Basic (Standard), sondern nach All (Alle). - Öffnen Sie
Info.plist
und fügen Sie die folgenden Schlüssel/Wert-Paare hinzu:- Schlüssel:
NSLocationWhenInUseUsageDescription
(Datenschutz – Standort bei Verwendung)
Wert: „Diese App benötigt die Berechtigung, Ihren Standort für die detaillierte Navigation zu verwenden.“ - Schlüssel:
NSLocationAlwaysAndWhenInUseUsageDescription
(Datenschutz – Beschreibung der Verwendung von Standortermittlung (immer und bei Verwendung))
Wert: „Diese App benötigt die Berechtigung, Ihren Standort für die detaillierte Navigation zu verwenden.“
- Schlüssel:
CocoaPods
Das Navigation SDK for iOS ist als Pod von CocoaPods verfügbar. CocoaPods ist ein Open-Source-Abhängigkeitsmanager für Cocoa-Projekte in Swift und Objective-C.
Falls du das Tool „CocoaPods“ noch nicht nutzt, installiere es unter macOS, indem du den folgenden Befehl über das Terminal ausführst. Weitere Informationen findest du im Startleitfaden zu CocoaPods (in englischer Sprache).
sudo gem install cocoapods
Erstelle eine Podfile
für das Navigation SDK for iOS und verwende sie, um die API und die zugehörigen Abhängigkeiten zu installieren:
- Falls du noch kein Xcode-Projekt hast, erstelle eines und speichere es auf dem lokalen Rechner. Wenn Sie noch keine Erfahrung mit der iOS-Entwicklung haben:
- Erstellen Sie ein neues Projekt.
- Wählen Sie die Vorlage iOS > App aus.
- Auf dem Bildschirm mit den Projektoptionen:
- Geben Sie den Projektnamen ein.
- Notieren Sie sich den Wert des Felds Bundle-ID. Sie können diesen Wert verwenden, um Ihren API-Schlüssel unten einzuschränken.
- Legen Sie für die Benutzeroberfläche des Projekts Storyboard fest.
- Legen Sie für Language Swift oder Objective-C fest.
- Erstelle in deinem Projektverzeichnis eine Datei mit dem Namen
Podfile
. In dieser Datei sind die Abhängigkeiten des Projekts definiert. - Bearbeiten Sie die
Podfile
und fügen Sie die Abhängigkeiten mit ihren Versionen hinzu. Im Folgenden findest du ein Beispiel, das die Abhängigkeit enthält, die du für das Navigation SDK for iOS benötigst: # Cocoapods install reference # Führen Siesource 'https://github.com/CocoaPods/Specs.git' platform :ios, '15.0' target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GoogleNavigation', '9.2.0' end
pod outdated
regelmäßig aus, um neuere Versionen zu erkennen. Führen Sie bei Bedarf ein Upgrade auf die neueste Version durch. - Speichere die
Podfile
. Öffne ein Terminalfenster und suche das Verzeichnis mit der
Podfile
:cd <path-to-project>
Führen Sie den Befehl
pod install
aus: Dadurch werden die in derPodfile
angegebenen APIs und ggf. zugehörige Abhängigkeiten installiert.pod install
Schließe Xcode und öffne dann mit einem Doppelklick die Datei
.xcworkspace
deines Projekts, um Xcode wieder zu starten. Ab jetzt musst du das Projekt über die Datei.xcworkspace
aufrufen.
So aktualisieren Sie die API für ein bestehendes Projekt:
- Öffne ein Terminalfenster und gehe zum Projektverzeichnis mit der
Podfile
. - Führen Sie den Befehl
pod update
aus: Dadurch werden alle in derPodfile
angegebenen APIs auf die neueste Version aktualisiert.
Schritt 3: API-Schlüssel zum Projekt hinzufügen
In den folgenden Beispielen wird gezeigt, wie Sie den API-Schlüssel Ihrem Projekt in Xcode hinzufügen:
Swift
Füge deinen API-Schlüssel folgendermaßen in AppDelegate.swift
ein:
- Fügen Sie die folgenden Importanweisungen hinzu:
import GoogleMaps import GoogleNavigation
- Fügen Sie der Methode
application(_:didFinishLaunchingWithOptions:)
Folgendes hinzu:GMSServices.provideAPIKey("YOUR_API_KEY")
Objective-C
Füge deinen API-Schlüssel folgendermaßen in AppDelegate.m
ein:
- Fügen Sie die folgenden Importanweisungen hinzu:
@import GoogleMaps; @import GoogleNavigation;
- Fügen Sie der Methode
application:didFinishLaunchingWithOptions:
Folgendes hinzu:[GMSServices provideAPIKey:@"YOUR_API_KEY"];
Schritt 4 (optional): Manifestdatei für den Datenschutz von Apple prüfen
Apple verlangt Angaben zum App-Datenschutz für Apps im App Store. Aktuelle Informationen finden Sie auf der Seite App-Datenschutzdetails im Apple App Store.
Die Apple-Manifestdatei für den Datenschutz ist im Ressourcenpaket für das SDK enthalten. Wenn Sie prüfen möchten, ob die Manifestdatei für den Datenschutz enthalten ist, und ihren Inhalt überprüfen möchten, erstellen Sie ein Archiv Ihrer App und generieren Sie einen Datenschutzbericht aus dem Archiv.
Wenn Sie Mobility-Consulting-Kunde sind
Wenn Sie Mobility Services-Kunde sind, finden Sie Informationen zur Abrechnung in der Mobility-Dokumentation. Weitere Informationen zum Aufzeichnen von Transaktionen finden Sie unter Abrechnung einrichten. Informationen zum Hinzufügen von Transaktions-IDs zur Navigation SDK-Implementierung finden Sie unter Nutzung Ihres Dienstes mit Mobilitätstransaktionen verknüpfen.
Nächste Schritte
Da Sie nun einen API-Schlüssel und ein Xcode-Projekt haben, können Sie Anwendungen erstellen und ausführen. Das Navigation SDK for iOS bietet Anleitungen für den Einstieg. Weitere Informationen finden Sie hier: