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

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. Prüfen Sie die Installation im Bereich Package Dependencies (Paketabhängigkeiten) des Project Navigator (Projektnavigator) Dort sehen Sie das Paket und seine Version.

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 Stammverzeichnis Ihres Xcode-Projekts das GoogleMaps Bundle.

Manuelle Installation

In diesem Leitfaden erfahren Sie, 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:
   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 Project Name (Projektnamen) ein.
      2. Notieren Sie 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 Interface (Schnittstelle) des Projekts Storyboard fest.
      4. Legen Sie für 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 GoogleMapsResources heruntergeladenen in das Stammverzeichnis 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 (Projektnavigator) 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 Anwendung. 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 (in englischer Sprache).

CocoaPods

Das Maps 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 Maps SDK for iOS und verwenden Sie sie, 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 aus.
   3. Auf dem Bildschirm mit den Projektoptionen:
      1. Geben Sie den Project Name (Projektnamen) ein.
      2. Notieren Sie 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 Interface (Schnittstelle) des Projekts 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 Maps SDK for iOS benötigen:

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

   Führen Sie regelmäßig pod outdated aus, um zu erkennen, wann eine neuere Version verfügbar ist, damit Sie immer die aktuelle Version verwenden. 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, die in der Podfile angegeben sind, und ggf. zugehörige 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 gehen 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üge deinen API-Schlüssel folgendermaßen in AppDelegate.swift ein:

1. Gib die folgende Importanweisung an:

   import GoogleMaps

2. Füge Folgendes in die Methode application(_:didFinishLaunchingWithOptions:) ein und verwende dabei deinen API-Schlüssel:

   GMSServices.provideAPIKey("YOUR_API_KEY")

3. Wenn du auch die Places API verwendest, füge deinen 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. Gib die folgende Importanweisung an:

   @import GoogleMaps;

2. Füge Folgendes in die Methode application:didFinishLaunchingWithOptions: ein und verwende dabei deinen API-Schlüssel:

   [GMSServices provideAPIKey:@"YOUR_API_KEY"];

3. Wenn du auch die Places API verwendest, füge deinen Schlüssel wie hier gezeigt noch einmal ein:

   [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];