Xcode-Projekt einrichten

Swift Package Manager

Das Maps SDK for iOS kann über den Swift Package Manager installiert werden. Bevor Sie das SDK hinzufügen, 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 Xcode project oder workspace und gehen Sie zu Datei > Paketabhängigkeiten hinzufügen.
2. Geben Sie https://github.com/googlemaps/ios-maps-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. Wenn Sie ein Upgrade von einer Version durchführen,die älter als 9.0.0 ist, müssen Sie nach dem Upgrade die folgenden Abhängigkeiten entfernen: GoogleMapsBase, GoogleMapsCore und GoogleMapsM4B. Entfernen Sie die Abhängigkeit für GoogleMaps nicht. Weitere Informationen finden Sie in den Versionshinweisen zur Version 9.0.0.

   Suchen Sie in den Konfigurationseinstellungen Ihres Xcode-Projekts nach Frameworks, Bibliotheken und eingebetteten Inhalten. Verwenden Sie das Minuszeichen(-), um das folgende Framework zu entfernen:

   • 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. Wählen Sie in Xcode „Datei“ > „Pakete“ > „Auf die neuesten Paketversionen aktualisieren“ aus.
3. 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 vorhandene Abhängigkeiten vom 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 Podfile, Podfile.resolved und die Xcode-workspace, wenn Sie sie nicht für andere Zwecke als CocoaPods verwenden.

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

Manuelle Installation

In dieser Anleitung wird beschrieben, wie Sie Ihrem Projekt die XCFrameworks mit dem Maps SDK for iOS manuell hinzufügen und die Build-Einstellungen in Xcode konfigurieren. Ein XCFramework ist ein Binärpaket, das auf mehreren Plattformen verwendet werden kann, einschließlich Computern mit Apple-Silicon.

1. Laden Sie die folgenden SDK-Binärdateien und Ressourcendateien herunter:
   • GoogleMaps
   • GoogleMapsM4B
   • GoogleMapsResources
2. Extrahieren Sie die Dateien, um auf die XCFrameworks und Ressourcen zuzugreifen.
3. Wenn Sie noch kein Xcode-Projekt haben, erstellen Sie jetzt eines und speichern Sie es auf Ihrem lokalen Computer. 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 identifier (Paket-ID). Sie können diesen Wert unten verwenden, um Ihren API-Schlüssel einzuschränken.
      3. Legen Sie für die Benutzeroberfläche des Projekts Storyboard fest.
      4. Wählen Sie unter Language (Sprache) die Option Swift oder Objective-C aus.
4. Öffnen Sie den Tab Allgemein. Ziehen Sie das folgende XCFramework unter Frameworks, Libraries und eingebettete Inhalte in Ihr Projekt. Wähle Nicht einbetten aus:
   • GoogleMaps.xcframework
5. Kopieren Sie die GoogleMaps.bundle aus den heruntergeladenen GoogleMapsResources in das Stammverzeichnis Ihres Xcode-Projekts. Wählen Sie bei Aufforderung die Option Elemente in den Ordner der Zielgruppe kopieren aus.
6. Wählen Sie im Projektnavigator Ihr Projekt und das Ziel Ihrer Anwendung aus.
7. Öffnen Sie den Tab Build-Phasen für das Ziel Ihrer Anwendung. Fügen Sie unter Binary mit Bibliotheken verknüpfen 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
   • OpenGLES.framework (Nur bei Verwendung von OpenGL)
   • QuartzCore.framework
   • Security.framework
   • SystemConfiguration.framework
   • UIKit.framework

8. Wählen Sie Ihr Projekt anstelle eines bestimmten Ziels aus und öffnen Sie den Tab Build-Einstellungen. Fügen Sie im Bereich Verknüpfen – Allgemein -> Andere Linker-Flags -ObjC zu „Debuggen“ und „Release“ hinzu. Wenn diese Einstellungen nicht angezeigt werden, ändern Sie den Filter in der Leiste Build-Einstellungen von Einfach zu Alle.

9. Informationen zum Installieren des XCFrameworks für das Places SDK for iOS finden Sie unter Einstieg in das Places SDK for iOS.

CocoaPods

Das Maps 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 Maps SDK for iOS und verwende sie, um die API und die zugehörigen Abhängigkeiten zu installieren:

1. Wenn Sie noch kein Xcode-Projekt haben, erstellen Sie jetzt eines und speichern Sie es auf Ihrem lokalen Computer. 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 identifier (Paket-ID). Sie können diesen Wert unten verwenden, um Ihren API-Schlüssel einzuschränken.
      3. Legen Sie für die Benutzeroberfläche des Projekts Storyboard fest.
      4. Wählen Sie als Sprache Swift oder Objective-C aus.
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 Ihre Abhängigkeiten mit ihren Versionen hinzu. Im Folgenden findest du ein Beispiel, das die Abhängigkeit enthält, die du für das Maps SDK for iOS benötigst:

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

   Führen Sie pod outdated regelmäßig aus, um zu prüfen, ob es eine neuere Version gibt, damit Sie immer die neueste Version verwenden. Führen Sie bei Bedarf ein Upgrade auf die neueste Version aus.
4. Speichere die Podfile.

5. Öffnen Sie ein Terminal und wechseln Sie zum 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 vorhandenes 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 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ügen Sie der application(_:didFinishLaunchingWithOptions:)-Methode Folgendes hinzu und verwenden Sie dabei Ihren 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ügen Sie der application:didFinishLaunchingWithOptions:-Methode Folgendes mit Ihrem API-Schlüssel hinzu:

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