Xcode-Projekt einrichten

Swift Package Manager

Das Maps SDK for iOS kann über den Swift Package Manager installiert werden. Wenn Sie das SDK hinzufügen möchten, müssen Sie alle vorhandenen Abhängigkeiten des Maps SDK for iOS 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-maps-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. 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).
4. Prüfen Sie im Fenster Choose Package Products (Paketprodukte auswählen), ob GoogleMaps (für Versionen vor 9.0.0 prüfen Sie, ob GoogleMaps, GoogleMapsBase und GoogleMapsCore hinzugefügt werden) zu Ihrem 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, gehen Sie zum Bereich General (Allgemein) Ihres Ziels. 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 die Version korrekt sind.

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

1. Wenn Sie ein Upgrade von einer Version vor 9.0.0 durchführen, müssen Sie nach dem Upgrade die folgenden Abhängigkeiten entfernen: GoogleMapsBase, GoogleMapsCore und GoogleMapsM4B. Entfernen Sie nicht die Abhängigkeit für GoogleMaps. Weitere Informationen finden Sie in den Versionshinweisen zu Version 9.0.0.

   Suchen Sie in den Konfigurationseinstellungen Ihres Xcode-Projekts nach Frameworks, Libraries, und eingebettete Inhalte. Entfernen Sie das folgende Framework mit dem Minuszeichen(-):

   • GoogleMapsBase (nur für Upgrades von Versionen vor 9.0.0)
   • GoogleMapsCore (nur für Upgrades von Versionen vor 9.0.0)
   • GoogleMapsM4B (nur für Upgrades von Versionen vor 9.0.0)
2. Gehen Sie in Xcode zu File > Packages > Update To Latest Package Versions (Datei > Pakete > Auf neueste Paketversionen aktualisieren).
3. Wenn Sie die Installation überprüfen möchten, gehen Sie zum Bereich Package Dependencies (Paketabhängigkeiten) des Project Navigator (Projekt-Navigator) und prüfen Sie, ob das Paket und die Version korrekt sind.

So entfernen Sie vorhandene Abhängigkeiten des Maps SDK for iOS, die mit CocoaPods hinzugefügt wurden:

1. Schließen Sie Ihren Xcode-Arbeitsbereich. Öffnen Sie das Terminal und führen Sie den folgenden Befehl aus:

   sudo gem install cocoapods-deintegrate cocoapods-clean
   pod deintegrate
   pod cache clean --all

2. Entfernen Sie die Dateien Podfile, Podfile.resolved und den Xcode workspace, wenn Sie sie nur für CocoaPods verwenden.

1. Suchen Sie in den Konfigurationseinstellungen Ihres Xcode-Projekts nach Frameworks, Libraries, and Embedded Content (Frameworks, Bibliotheken und eingebettete Inhalte). Entfernen Sie das folgende Framework mit dem Minuszeichen (-) :
   • GoogleMaps
   • GoogleMapsBase (nur für Installationen vor Version 9.2.0)
   • GoogleMapsCore (nur für Installationen vor Version 9.2.0)
   • GoogleMapsM4B (nur für Installationen vor Version 9.0.0)
2. Entfernen Sie im obersten Verzeichnis Ihres Xcode-Projekts das GoogleMaps Bundle.

Manuelle Installation

In diesem Leitfaden wird beschrieben, wie Sie die XCFrameworks mit 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 Apple-Silizium.

1. Laden Sie die folgenden SDK-Binärdateien und Ressourcendateien herunter:
   • GoogleMaps
   • GoogleMapsResources
2. Extrahieren Sie die Dateien, um auf die XCFrameworks und Ressourcen zuzugreifen.
3. 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, gehen Sie so vor:
   1. Erstellen Sie ein neues Projekt.
   2. Wählen Sie die Vorlage iOS > App aus.
   3. Gehen Sie auf dem Bildschirm mit den Projektoptionen so vor:
      1. Geben Sie den Projektnamen ein.
      2. Notieren Sie sich den Wert des Felds Bundle identifier (Paket-Identifikator). Sie können diesen Wert verwenden, um Ihren API-Schlüssel unten einzuschränken.
      3. Legen Sie für die Interface (Schnittstelle) des Projekts Storyboard fest.
      4. Legen Sie für die Language (Sprache) Swift oder Objective-C fest.
4. Öffnen Sie den Tab General (Allgemein). Ziehen Sie die folgenden XCFrameworks unter Frameworks, Libraries, and Embedded Content (Frameworks, Bibliotheken und eingebettete Inhalte) in Ihr Projekt. Stellen Sie sicher, dass Sie Do Not Embed auswählen:
   • GoogleMaps.xcframework
5. Kopieren Sie die Datei GoogleMaps.bundle aus den heruntergeladenen GoogleMapsResources in das oberste Verzeichnis Ihres Xcode-Projekts. Wählen Sie bei Aufforderung Copy items into destination group's folder (Elemente in den Ordner der Zielgruppe kopieren) aus.
6. Wählen Sie im Project Navigator Ihr Projekt aus und geben Sie dann das Ziel Ihrer App an.
7. Öffnen Sie den Tab Build Phases (Build-Phasen) für das Ziel Ihrer App. Fügen Sie unter Link Binary with Libraries die folgenden Frameworks und Bibliotheken hinzu:
   • Accelerate.framework
   • Contacts.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreImage.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libz.tbd
   • Metal.framework
   • MetricKit.framework
   • OpenGLES.framework (nur wenn Sie OpenGL verwenden)
   • QuartzCore.framework
   • Security.framework
   • SystemConfiguration.framework
   • UIKit.framework

8. Wählen Sie statt eines bestimmten Ziels Ihr Projekt aus und öffnen Sie den Build Settings Tab. Fügen Sie im Bereich Linking - General -> Other Linker Flags (Verknüpfung – Allgemein – > Weitere Verknüpfungsmerker) -ObjC zu „Debug“ und „Release“ hinzu. Falls die Einstellungen nicht angezeigt werden, filtern Sie in der Leiste Build Settings (Build-Einstellungen) nicht mehr nach Basic (Standard), sondern nach All (Alle).

9. Informationen zum Installieren des Places SDK for iOS XCFramework finden Sie im Startleitfaden zum Places SDK for iOS.

Swift

Füge deinen API-Schlüssel folgendermaßen in AppDelegate.swift ein:

1. Fügen Sie die folgende Importanweisung hinzu:

   import GoogleMaps

2. Fügen Sie der Methode application(_:didFinishLaunchingWithOptions:) Folgendes hinzu und verwenden Sie dabei Ihren API-Schlüssel:

   GMSServices.provideAPIKey("YOUR_API_KEY")

3. Wenn Sie auch die Places API verwenden, fügen Sie Ihren Schlüssel wie hier gezeigt noch einmal ein:

   GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

Füge deinen API-Schlüssel folgendermaßen in AppDelegate.m ein:

1. Fügen Sie die folgende Importanweisung hinzu:

   @import GoogleMaps;

2. Fügen Sie der Methode application:didFinishLaunchingWithOptions: Folgendes hinzu und verwenden Sie dabei Ihren API-Schlüssel:

   [GMSServices provideAPIKey:@"YOUR_API_KEY"];

3. Wenn Sie auch die Places API verwenden, fügen Sie Ihren Schlüssel wie hier gezeigt noch einmal ein:

   [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];