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 Ihren workspace und wählen Sie dann File > Add Package Dependencies (Datei > Paketabhängigkeiten hinzufügen) 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 das Feld Dependency Rule auf eine der die 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:

1. Prüfen Sie die Installation im Bereich Package Dependencies (Paketabhängigkeiten) des Project Navigator (Projektnavigator) Dort sehen Sie das Paket und seine Version.

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. 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 im Project Navigator (Projektnavigator) 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 Linker-Flags) 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 Nutzung des Standorts bei Verwendung)
      Wert: "Diese App benötigt die Berechtigung, Ihren Standort für die Turn-by-Turn-Navigation 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 Turn-by-Turn-Navigation zu verwenden."

CocoaPods

Das Navigation SDK for iOS ist als CocoaPods Pod verfügbar. CocoaPods ist ein Open-Source-Abhängigkeitsmanager für Cocoa-Projekte in Swift und Objective-C

Falls Sie das Tool „CocoaPods“ noch nicht nutzen, installieren Sie es unter macOS, indem Sie den folgenden Befehl über das Terminal ausführen. Weitere Informationen finden Sie im Startleitfaden zu CocoaPods (in englischer Sprache).

sudo gem install cocoapods

Erstellen Sie eine Podfile für das Navigation SDK for iOS und verwenden Sie es, um die API und die zugehörigen Abhängigkeiten zu installieren:

1. Falls Sie noch kein Xcode-Projekt haben, erstellen Sie eines und speichern Sie es auf dem lokalen Rechner. Wenn Sie noch keine Erfahrung in der iOS-Entwicklung haben:
   1. Erstellen Sie ein neues Projekt.
   2. Wählen Sie die Vorlage iOS > App (iOS > App) aus.
   3. Auf dem Bildschirm mit den Projektoptionen:
      1. Geben Sie den Project Name (Projektnamen) ein.
      2. Notieren Sie sich den Wert des Felds Bundle identifier (Bundle-ID). Sie können diesen Wert verwenden, um Ihren API-Schlüssel unten einzuschränken.
      3. Legen Sie für das Projekt Interface (Schnittstelle) Storyboard fest.
      4. Legen Sie für Language (Sprache) Swift oder Objective-C fest.
2. Erstellen Sie in Ihrem Projektverzeichnis eine Datei mit dem Namen Podfile. In dieser Datei sind die Abhängigkeiten des Projekts definiert.
3. Bearbeiten Sie die Podfile und fügen Sie die Abhängigkeiten zusammen mit ihren Versionen hinzu. Im Folgenden finden Sie ein Beispiel, das die Abhängigkeit enthält, die Sie für das Navigation SDK for iOS benötigen: # Cocoapods install reference #

   source 'https://github.com/CocoaPods/Specs.git'
   
   platform :ios, '16.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     pod 'GoogleNavigation', '10.10.0'
   end
           

   Führen Sie regelmäßig pod outdated aus, um neuere Versionen zu erkennen. Aktualisieren Sie bei Bedarf auf die neueste Version.
4. Speichern Sie die Podfile.

5. Öffnen Sie ein Terminalfenster und suchen Sie das Verzeichnis mit der Podfile:

   cd <path-to-project>

6. Führen Sie den Befehl pod install aus. Dadurch werden die APIs in der Podfile und alle zugehörigen Abhängigkeiten installiert.

   pod install

7. Schließen Sie Xcode und öffnen Sie dann mit einem Doppelklick die Datei .xcworkspace Ihres Projekts, um Xcode wieder zu starten. Ab jetzt müssen Sie das Projekt über die Datei .xcworkspace aufrufen.

So aktualisieren Sie die API für ein vorhandenes Projekt:

1. Öffnen Sie ein Terminalfenster und wechseln Sie zum Projektverzeichnis mit der Podfile.
2. Führen Sie den Befehl pod update aus. Dadurch werden alle in der Podfile angegebenen APIs auf die neueste Version aktualisiert.

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"];