Xcode-Projekt einrichten

Swift Package Manager

Das Navigation SDK kann über den Swift Package Manager installiert werden. Wenn Sie das SDK hinzufügen möchten, müssen Sie alle vorhandenen Abhängigkeiten des Navigation SDK 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 zu File > Add Package Dependencies.
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 Dependency Rule eine der der versionsbasierten Optionen fest. Bei neuen Projekten empfehlen wir, die aktuelle Version anzugeben und die Option „Exact Version“ (Genaue Version) zu verwenden. Klicken Sie anschließend auf „Add Package“ (Paket hinzufügen).
4. Prüfen Sie im Fenster Choose Package Products (Paketprodukte auswählen), ob GoogleNavigation dem angegebenen main-Ziel hinzugefügt wird. Klicken Sie anschließend auf „Add Package“ (Paket hinzufügen).
5. Wenn Sie die Installation überprüfen möchten, rufen Sie den Bereich General (Allgemein) Ihres Ziels auf. Unter Frameworks, Libraries, and Embedded Content (Frameworks, Bibliotheken und eingebettete Inhalte) sollten die installierten Pakete angezeigt werden. Sie können auch im Bereich „Package Dependencies“ (Paketabhängigkeiten) von „Project Navigator“ prüfen, ob das Paket und seine Version korrekt sind.

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

1. Gehen Sie in Xcode zu File > Packages > Update To Latest Package Versions (Datei > Pakete > Auf neueste Paketversionen aktualisieren).
2. Wenn Sie die Installation überprüfen möchten, rufen Sie im Project Navigator (Projektnavigator) den Bereich Package Dependencies (Paketabhängigkeiten) auf und prüfen Sie, ob das Paket und seine Version korrekt sind.

1. Suchen Sie in den Konfigurationseinstellungen Ihres Xcode-Projekts nach Frameworks, Libraries, and Embedded Content (Frameworks, Bibliotheken und eingebettete Inhalte). Entfernen Sie mit dem Minuszeichen(-) das folgende Framework:
   • GoogleMaps.xcframework
   • GoogleNavigation.xcframework
2. Entfernen Sie im Verzeichnis der obersten Ebene Ihres Xcode-Projekts das GoogleMaps Bundle.

Manuelle Installation

In dieser Anleitung 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 Buildeinstellungen in Xcode konfigurieren. Ein XCFramework ist ein binäres Paket, das Sie auf mehreren Plattformen verwenden können, 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:

1. Laden Sie die folgenden SDK-Binärdateien und Ressourcendateien herunter:
   • GoogleMaps
   • GoogleMapsResources
   • GoogleNavigation
   • GoogleNavigationResources
2. Starten Sie Xcode und öffnen Sie ein vorhandenes oder erstellen Sie ein neues Projekt. Wenn Sie iOS noch nicht kennen, erstellen Sie ein neues Projekt und wählen Sie die iOS App template (iOS-App-Vorlage) aus.
3. Entfernen Sie alle vorhandenen Maps-, Navigation- und Places-Verweise aus dem Projekt.
4. Ziehen Sie die folgenden XCFrameworks unter Frameworks, Libraries, and Embedded Content (Frameworks, Bibliotheken und eingebettete Inhalte) in Ihr Projekt, um sowohl das Maps SDK als auch das Navigation SDK zu installieren. Wählen Sie bei Aufforderung Copy items if needed (Elemente bei Bedarf kopieren) aus:
   • GoogleMaps.xcframework
   • GoogleNavigation.xcframework
5. Ziehen Sie GoogleMaps.bundle aus GoogleMapsResources, das Sie heruntergeladen haben , in das Verzeichnis der obersten Ebene Ihres Xcode-Projekts. Achten Sie darauf, dass bei Aufforderung Copy items if needed (Elemente bei Bedarf kopieren) ausgewählt ist.
6. Ziehen Sie GoogleNavigation.bundle aus GoogleNavigationResources, das Sie heruntergeladen haben , in das Verzeichnis der obersten Ebene Ihres Xcode-Projekts. Achten Sie darauf, dass bei Aufforderung Copy items into destination group's folder (Elemente in den Ordner der Zielgruppe kopieren) ausgewählt ist.
7. Wählen Sie Ihr Projekt im Projektnavigator aus und wählen Sie das Ziel Ihrer Anwendung aus.
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:
   • 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 Capabilities-Tab aus, aktivieren Sie Background Modes und aktivieren Sie die folgenden Modi:
   • Audio, AirPlay, and Picture in Picture (Audio, AirPlay und Bild im Bild)
   • Location updates (Standort-Updates)
10. Wählen Sie Ihr Projekt und nicht ein bestimmtes Ziel aus und öffnen Sie den Build Settings Tab. Fügen Sie im Bereich Other Linker Flags für debug und release ‑ObjC hinzu. Wenn diese Einstellungen nicht sichtbar sind, ändern Sie den Filter in der Leiste Build Settings von Basic zu All.
11. Öffnen Sie Info.plist und fügen Sie die folgenden Schlüssel-Wert-Paare hinzu:
    • Schlüssel: NSLocationWhenInUseUsageDescription (Datenschutz – Beschreibung der Nutzung des Standorts bei Verwendung)
      Wert: "Diese App benötigt die Berechtigung, Ihren Standort für die detaillierte Routenführung zu verwenden."
    • Schlüssel: NSLocationAlwaysAndWhenInUseUsageDescription (Datenschutz – Beschreibung der Nutzung des Standorts immer und bei Verwendung)
      Wert: "Diese App benötigt die Berechtigung, Ihren Standort für die detaillierte Routenführung zu verwenden."

Swift

Fügen Sie Ihren 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ügen Sie Ihren 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"];