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 Xcode project oder workspace und gehen Sie zu 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 einzubinden, und klicken Sie auf „Paket hinzufügen“.
3. 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:

1. 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.

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

1. Laden Sie die folgenden SDK-Binaries und Ressourcendateien herunter:
   • GoogleMaps
   • GoogleMapsResources
   • GoogleNavigation
   • GoogleNavigationResources
2. 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.
3. Entfernen Sie alle vorhandenen Verweise auf Google Maps, Navigation und Orte aus dem Projekt.
4. 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
5. 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.
6. 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.
7. Wähle im Project Navigator dein Projekt aus und gib dann das Ziel deiner App an.
8. Ö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
9. 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
10. 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 ein. Falls die Einstellungen nicht angezeigt werden, filtere in der Leiste Build Settings 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 – 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.“

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:

1. 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:
   1. Erstellen Sie ein neues Projekt.
   2. Wählen Sie die Vorlage iOS > App aus.
   3. Auf dem Bildschirm mit den Projektoptionen:
      1. Geben Sie den Projektnamen ein.
      2. Notieren Sie sich den Wert des Felds Bundle-ID. Sie können diesen Wert verwenden, um Ihren API-Schlüssel unten einzuschränken.
      3. Legen Sie für die Benutzeroberfläche des Projekts Storyboard fest.
      4. Legen Sie für Language Swift oder Objective-C fest.
2. Erstelle in deinem 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 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 #

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

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

5. Öffne ein Terminalfenster und suche das Verzeichnis mit der Podfile:

   cd <path-to-project>

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

   pod install

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

1. Öffne ein Terminalfenster und gehe 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ü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 application(_:didFinishLaunchingWithOptions:)-Methode 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 application:didFinishLaunchingWithOptions:-Methode Folgendes hinzu:

   [GMSServices provideAPIKey:@"YOUR_API_KEY"];