Xcode-Projekt einrichten

Nachdem Sie die Abrechnung aktiviert und einen API-Schlüssel erstellt haben, können Sie das Xcode-Projekt für die Entwicklung Ihrer App einrichten.

Für jede Version sind Versionshinweise verfügbar.

Schritt 1: Erforderliche Software installieren

Wenn Sie ein Projekt mit dem Navigation SDK for iOS erstellen möchten, müssen Sie Folgendes herunterladen und installieren:

  • Xcode Version 16.0 oder höher

Schritt 2: Xcode-Projekt erstellen und Navigation SDK installieren

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.

: In dieser Anleitung wird davon ausgegangen, dass Sie Xcode 15 oder höher verwenden. Die Schritte sollten aber auch für frühere Versionen von Xcode ähnlich sein.

So fügen Sie das SDK einem neuen oder vorhandenen Projekt hinzu:

  1. Öffnen Sie Ihr Xcode-Projekt project oder workspace und gehen Sie 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 „Paket hinzufügen“.
  3. Wenn Sie eine bestimmte version installieren möchten, legen Sie für das Feld Dependency Rule (Abhängigkeitsregel) eine der versionsbasierten Optionen fest. Bei neuen Projekten empfehlen wir, die neueste Version anzugeben und die Option „Genaue Version“ zu verwenden. Klicken Sie anschließend 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.

So entfernen Sie das vorhandene Navigation SDK for iOS, das manuell installiert wurde:
  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 im Verzeichnis der obersten Ebene Ihres Xcode-Projekts das GoogleMaps-Bundle.

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:
  2. Starte Xcode und öffne ein vorhandenes oder erstelle ein neues Projekt. Wenn du noch keine Erfahrung mit iOS hast, erstelle ein neues Projekt und wähle die Vorlage für iOS-Apps aus.
  3. Entfernen Sie alle vorhandenen Verweise auf Google Maps, Google Navigation und Google Places aus dem Projekt.
  4. Ziehen Sie die folgenden XCFrameworks in Ihr Projekt unter Frameworks, Libraries, and Embedded Content (Frameworks, Bibliotheken und eingebettete Inhalte), 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 dem heruntergeladenen Ordner GoogleMapsResources in das oberste Verzeichnis Ihres Xcode-Projekts. Prüfen Sie, ob Elemente bei Bedarf kopieren ausgewählt ist.
  6. Ziehen Sie GoogleNavigation.bundle aus dem heruntergeladenen GoogleNavigationResources in das Verzeichnis der obersten Ebene Ihres Xcode-Projekts. Prüfe, wenn du dazu aufgefordert wirst, ob 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 Capabilities aus, aktivieren Sie Background Modes 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 Settings (Build-Einstellungen). Fügen Sie im Bereich Other Linker Flags (Weitere Verknüpfungsmerker) für debug (Debug) und release (Release) jeweils ‑ObjC hinzu. 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 (Privacy – Location When In Use Usage Description)
      Wert: „Diese App benötigt die Berechtigung, Ihren Standort für die Turn-by-Turn-Navigation zu verwenden.“
    • Schlüssel:NSLocationAlwaysAndWhenInUseUsageDescription (Datenschutz – Beschreibung der Verwendung von „Immer“ und „Bei Verwendung“ für den Standort)
      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 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 in 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 das Projekt die Benutzeroberfläche auf Storyboard fest.
      4. Legen Sie für Language (Sprache) 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. Bearbeite die Podfile und füge deine 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.1.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. Öffnen Sie ein Terminal und wechseln Sie in 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. Öffnen Sie ein Terminal und wechseln Sie zum Projektverzeichnis mit der Podfile.
  2. Führen Sie den Befehl pod update aus: Dadurch werden alle in Podfile angegebenen APIs auf die neueste Version aktualisiert.

Schritt 3: API-Schlüssel zum Projekt hinzufügen

In den folgenden Beispielen sehen Sie, wie Sie den API-Schlüssel in Xcode in Ihr Projekt einfügen:

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

Schritt 4 (optional): Apple-Datei mit Datenschutzmanifest prüfen

Apple verlangt Angaben zum App-Datenschutz für Apps im App Store. Aktuelle Informationen finden Sie auf der Seite „App Privacy Details“ im Apple App Store.

Die Apple-Datenschutzmanifestdatei ist im Ressourcen-Bundle für das SDK enthalten. Wenn Sie prüfen möchten, ob die Datei mit dem Datenschutzmanifest enthalten ist, und ihren Inhalt ansehen möchten, erstellen Sie ein Archiv Ihrer App und generieren Sie einen Datenschutzbericht aus dem Archiv.

Wenn Sie ein Mobility-Consulting-Kunde sind

Wenn Sie Kunde von Mobility Services sind, finden Sie Informationen zur Abrechnung in der Mobility-Dokumentation. Weitere Informationen zum Aufzeichnen von Transaktionen finden Sie unter Abrechnung einrichten. Informationen zum Hinzufügen von Transaktions-IDs zu Ihrer Navigation SDK-Implementierung finden Sie unter Dienstnutzung mit Mobility-Transaktionen verknüpfen.

Nächste Schritte

Da Sie nun einen API-Schlüssel und ein Xcode-Projekt haben, können Sie Apps erstellen und ausführen. Das Navigation SDK for iOS bietet Anleitungen, die Ihnen den Einstieg erleichtern. Weitere Informationen finden Sie hier: