Xcode-Projekt einrichten

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:

1. Öffnen Sie Ihre 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-navigation-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 GoogleNavigation dem angegebenen main-Ziel hinzugefügt wird. Klicken Sie anschließend auf „Paket hinzufügen“.
5. Wenn Sie die Installation überprüfen möchten, rufen Sie den Bereich Allgemein des Ziels auf. 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.

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:
   • GoogleMaps.xcframework
   • GoogleNavigation.xcframework
2. Entfernen Sie das GoogleMaps-Bundle aus dem obersten Verzeichnis Ihres Xcode-Projekts.

Manuelle Installation

In diesem Leitfaden wird beschrieben, wie Sie die XCFrameworks mit dem Navigation SDK for iOS und dem Maps SDK for iOS manuell zu Ihrem Projekt hinzufügen und die Build-Einstellungen in Xcode konfigurieren. Ein XCFramework ist ein Binärpaket, das Sie auf mehreren Plattformen verwenden können, einschließlich Geräten mit dem M1-Chipsatz.

So installieren Sie die XCFrameworks für das Navigation SDK for iOS und das Maps SDK for iOS:

1. Laden Sie die folgenden SDK-Binärdateien und Ressourcendateien herunter:
   • GoogleMaps
   • GoogleMapsResources
   • GoogleNavigation
   • GoogleNavigationResources
2. Starte Xcode und öffne ein vorhandenes oder erstelle ein neues Projekt. Wenn Sie neu bei iOS sind, erstellen Sie ein neues Projekt und wählen Sie die iOS-App-Vorlage aus.
3. Entfernen Sie alle vorhandenen Verweise auf Maps, Navigation und Places aus dem Projekt.
4. Ziehen Sie die folgenden XCFrameworks in Ihr Projekt unter Frameworks, Libraries, and Embedded Content, um sowohl das Maps SDK als auch das Navigation SDK zu installieren. Wählen Sie bei Aufforderung Copy items if needed aus:
   • GoogleMaps.xcframework
   • GoogleNavigation.xcframework
5. Ziehen Sie GoogleMaps.bundle aus dem heruntergeladenen Verzeichnis GoogleMapsResources in das oberste Verzeichnis Ihres Xcode-Projekts. Wenn Sie dazu aufgefordert werden, muss Copy items if needed (Elemente bei Bedarf kopieren) ausgewählt sein.
6. Ziehen Sie GoogleNavigation.bundle aus den heruntergeladenen GoogleNavigationResources in das Verzeichnis auf oberster Ebene Ihres Xcode-Projekts. Achten Sie darauf, dass die Option Elemente in den Ordner der Zielgruppe kopieren ausgewählt ist, wenn Sie dazu aufgefordert werden.
7. Wählen Sie Ihr Projekt im Projektnavigator und dann das Ziel Ihrer Anwendung aus.
8. Öffnen Sie den Tab Build Phases und fügen Sie unter Link Binary with Libraries die folgenden Frameworks und Bibliotheken hinzu:
   • Accelerate.framework
   • AudioToolbox.framework
   • AVFoundation.framework
   • CarPlay.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
   • MapKit.framework
   • Metal.framework
   • OpenGLES.framework
   • QuartzCore.framework
   • Security.framework
   • SystemConfiguration.framework
   • UIKit.framework
   • UserNotifications.framework
   • WebKit.framework
9. Wählen Sie im Ziel Ihrer Anwendung den Tab Capabilities (Funktionen) aus, aktivieren Sie Background Modes (Hintergrundmodi) und aktivieren Sie die folgenden Modi:
   • Audio, AirPlay und Bild im Bild
   • Standort-Updates
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) sowohl für debug (Fehlerbehebung) als auch für release (Release) ‑ObjC hinzu. Wenn diese Einstellungen nicht sichtbar sind, ändern Sie den Filter in der Leiste Build-Einstellungen von Einfach in Alle.
11. Öffnen Sie Info.plist und fügen Sie die folgenden Schlüssel/Wert-Paare hinzu:
    • Schlüssel: NSLocationWhenInUseUsageDescription (Privacy - Location When In Use Usage Description)
      Wert: „Diese App benötigt die Berechtigung, Ihren Standort für die detaillierte Routenführung zu verwenden.“
    • Schlüssel: NSLocationAlwaysAndWhenInUseUsageDescription (Privacy - Location Always and When In Use Usage Description)
      Wert: „Diese App benötigt die Berechtigung, Ihren Standort für die detaillierte Routenführung zu verwenden.“

Swift

Füge deinen API-Schlüssel folgendermaßen in AppDelegate.swift ein:

1. Fügen Sie die folgenden Importanweisungen hinzu:

   import GoogleMaps
   import GoogleNavigation

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

1. Fügen Sie die folgenden Importanweisungen hinzu:

   @import GoogleMaps;
   @import GoogleNavigation;

2. Fügen Sie der Methode application:didFinishLaunchingWithOptions: Folgendes hinzu:

   [GMSServices provideAPIKey:@"YOUR_API_KEY"];