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 Navigation 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 wählen Sie File > Add Package Dependencies aus.
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 neueste Version anzugeben und die Option „Exact Version“ (Genaue Version) zu verwenden. Klicken Sie nach Abschluss des Vorgangs 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 nach Abschluss des Vorgangs 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) des „Project Navigator“ prüfen, ob das Paket und seine Version korrekt sind.

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

1. Wählen Sie in Xcode File > Packages > Update To Latest Package Versions (Datei > Pakete > Auf neueste Paketversionen aktualisieren) aus.
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 das GoogleMaps Bundle aus dem Verzeichnis der obersten Ebene Ihres Xcode-Projekts.

Manuelle Installation

In diesem Leitfaden erfahren Sie, wie Sie die XCFrameworks mit dem Navigation SDK for iOS und dem Maps SDK for iOS manuell in Ihr Projekt einfügen und die Build-Einstellungen 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 noch keine Erfahrung mit iOS haben, erstellen Sie ein neues Projekt und wählen Sie die 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. Prüfen Sie, ob 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. Prüfen Sie, ob Copy items into destination group's folder (Elemente in Ordner der Zielgruppe kopieren) ausgewählt ist.
7. Wählen Sie im Project Navigator Ihr Projekt aus und geben Sie dann das Ziel Ihrer App an.
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 (Standortaktualisierungen)
10. Wählen Sie statt eines bestimmten Ziels Ihr Projekt aus und öffnen Sie den Build Settings Tab. Fügen Sie im Bereich Other Linker Flags (Weitere Verknüpfungsmerker) für debug (Debug) und release (Release) ‑ObjC hinzu. Falls die Einstellungen nicht angezeigt werden, filtern Sie in der Build Settings Leiste nicht mehr nach Basic (Standard), sondern nach All (Alle).
11. Öffnen Sie Info.plist und fügen Sie die folgenden Schlüssel-Wert-Paare hinzu:
    • Schlüssel: NSLocationWhenInUseUsageDescription (Datenschutz – Beschreibung der Verwendung 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 Verwendung 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"];