Xcode-Projekt einrichten

Swift Package Manager

Das Places 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 Places 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-places-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“.
4. Prüfen Sie im Fenster Paketprodukte auswählen, ob GooglePlaces, GooglePlacesSwift oder beides dem festgelegten Hauptziel hinzugefügt werden. Klicken Sie abschließend auf Paket hinzufügen.

   Wenn Sie Google Places Swift über die eingestellte GitHub-URL aktualisieren

   Wichtig:Die GitHub-URL für den Zugriff auf Google Places Swift hat sich ab Version 0.3.0 geändert. Wenn Sie eine Version von GooglePlacesSwift aktualisieren, auf die über die alte URL https://github.com/googlemaps/ios-places-swift-sdk zugegriffen wurde, entfernen Sie sie aus dem Bereich „Paketabhängigkeiten“ in Xcode.

5. Rufen Sie den Bereich Allgemein des Ziels auf, um die Installation zu prüfen. Unter Frameworks, Bibliotheken und eingebettete Inhalte sollten die installierten Pakete angezeigt werden. Sie können sich auch den Bereich Paketabhängigkeiten im Project Navigator ansehen, um das Paket und seine Version zu überprüfen. In Xcode wird die GitHub-Version angezeigt, die mit der Version von GooglePlaces (z. B. 9.2.0) übereinstimmt, aber nicht mit der Version von GooglePlacesSwift (z. B. 0.3.0).

So aktualisieren Sie die package für ein bestehendes Projekt:

1. Wählen Sie in Xcode „Datei“ > „Pakete“ > „Auf die neuesten Paketversionen aktualisieren“ aus.

   Wenn Sie Google Places Swift über die eingestellte GitHub-URL aktualisieren

   Wichtig:Die GitHub-URL für den Zugriff auf Google Places Swift hat sich ab Version 0.3.0 geändert. Wenn Sie eine Version von GooglePlacesSwift aktualisieren, auf die über die alte URL https://github.com/googlemaps/ios-places-swift-sdk zugegriffen wurde, entfernen Sie sie aus dem Bereich „Paketabhängigkeiten“ in Xcode.

2. 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 ein manuell installiertes Places SDK for iOS:

1. Suchen Sie in den Konfigurationseinstellungen Ihres Xcode-Projekts nach Frameworks, Bibliotheken und eingebetteten Inhalten. Verwenden Sie das Minuszeichen(-), um die folgenden Frameworks zu entfernen:
   • GooglePlaces.xcframework
   • GooglePlacesSwift.xcframework
2. Entfernen Sie das GooglePlaces-Bundle aus dem Verzeichnis der obersten Ebene Ihres Xcode-Projekts.

Manuelle Installation

In diesem Leitfaden erfährst du, wie du die XCFrameworks mit dem Places SDK for iOS und dem Places Swift SDK for iOS (Vorabversion) 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 Apple-Silizium. Sie können das Places SDK for iOS, das Places Swift SDK for iOS (Vorabversion) oder beides hinzufügen.

1. Laden Sie die folgenden SDK-Binary- und Ressourcendateien herunter:
   • GooglePlaces
   • GooglePlacesResources
2. Wenn Sie das Places Swift SDK for iOS (Vorabversion) installieren, müssen Sie die folgenden Dateien installieren:
   • GooglePlacesSwift
   • GooglePlacesSwiftResources
3. Extrahieren Sie die Dateien, um auf das XCFramework und die Ressourcen zuzugreifen.
4. Starte Xcode und öffne ein vorhandenes oder erstelle ein neues Projekt. Wenn du noch keine Erfahrung in der iOS-Entwicklung hast, erstelle ein neues Projekt und wähle die Vorlage für iOS-Apps aus.
5. Entfernen Sie Maps-Bündel aus vorherigen Releases aus Ihrem Projekt.
6. Öffnen Sie den Tab Allgemein. Ziehen Sie das folgende XCFramework unter Frameworks, Bibliotheken und eingebettete Inhalte in Ihr Projekt. Wähle Nicht einbetten aus:
   • GooglePlaces.xcframework
   Wenn Sie das Places Swift SDK for iOS (Vorabversion) installieren, ziehen Sie das folgende XCFramework unter Frameworks, Libraries und eingebettete Inhalte in Ihr Projekt. Wähle Nicht einbetten aus:
   • GooglePlacesSwift.xcframework
7. Kopieren Sie die GooglePlaces.bundle aus den heruntergeladenen GooglePlacesResources in das oberste Verzeichnis Ihres Xcode-Projekts. Wähle Copy items into destination group's folder (Elemente in Ordner der Zielgruppe kopieren) aus, wenn du dazu aufgefordert wirst.
   
   Wenn Sie das Places Swift SDK for iOS (Vorabversion) installieren, kopieren Sie die GooglePlacesSwift.bundle aus den heruntergeladenen GooglePlacesSwiftResources in das Stammverzeichnis Ihres Xcode-Projekts. Wähle Copy items into destination group's folder (Elemente in Ordner der Zielgruppe kopieren) aus, wenn du dazu aufgefordert wirst.
8. Wähle im Project Navigator dein Projekt aus und gib dann das Ziel deiner App an.
9. Öffnen Sie den Tab Build-Phasen. Füge unter Link Binary with Libraries (Binärdatei mit Bibliotheken verknüpfen) die folgenden Frameworks und Bibliotheken hinzu:
   • CoreGraphics.framework
   • CoreLocation.framework
   • libc++.tbd
   • libz.tbd
   • QuartzCore.framework
   • UIKit.framework

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

CocoaPods

Das Places SDK for iOS und das Places Swift SDK for iOS (Vorabversion) sind als CocoaPod verfügbar: GooglePlaces und GooglePlacesSwift.

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, um die SDKs und ihre Abhängigkeiten zu installieren:

1. Falls du noch kein Xcode-Projekt hast, erstelle eines und speichere es auf dem lokalen Rechner. Wenn du noch keine Erfahrung in der iOS-Entwicklung hast, erstelle ein neues Projekt und wähle die Vorlage für iOS-Apps 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 die Abhängigkeiten mit ihren Versionen hinzu. Hier ist ein Beispiel, in dem der Name des Anwendungsziels und die Namen der Pods GooglePlaces und GooglePlacesSwift angegeben sind:

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

   Führen Sie pod outdated regelmäßig aus, um zu prüfen, ob es eine neuere Version gibt, damit Sie immer auf dem neuesten Stand sind.
4. Speichere die Podfile.

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

   cd <path-to-project>

6. Führe 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:

• Fügen Sie die folgende Importanweisung hinzu:

  import GooglePlaces

• Füge Folgendes in die Methode application(_:didFinishLaunchingWithOptions:) ein, wobei YOUR_API_KEY durch deinen API-Schlüssel ersetzt werden muss:

  GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

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

• Fügen Sie die folgende Importanweisung hinzu:

  @import GooglePlaces;

• Füge Folgendes in die Methode application:didFinishLaunchingWithOptions: ein, wobei YOUR_API_KEY durch deinen API-Schlüssel ersetzt werden muss:

  [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

GooglePlacesSwift

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

• Fügen Sie die folgende Importanweisung hinzu:

  import GooglePlacesSwift

• Füge Folgendes in die Methode application(_:didFinishLaunchingWithOptions:) ein, wobei YOUR_API_KEY durch deinen API-Schlüssel ersetzt werden muss:

  PlacesClient.provideAPIKey("YOUR_API_KEY")