Xcode-Projekt einrichten

Swift Package Manager

Das Places SDK for iOS kann über den Swift Package Manager installiert werden. Wenn Sie das SDK hinzufügen möchten, müssen Sie alle vorhandenen Places SDK for iOS-Abhängigkeiten 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 dann zu File > Add Package Dependencies.
2. Geben Sie https://github.com/googlemaps/ios-places-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. Bei neuen Projekten 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 GooglePlaces, GooglePlacesSwift, oder beide Ihrem angegebenen Hauptziel hinzugefügt werden. Klicken Sie nach Abschluss des Vorgangs auf Add Package (Paket hinzufügen).

   Google Places Swift über die veraltete 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 Abschnitt „Package Dependencies“ (Paketabhängigkeiten) von Xcode.

5. Prüfen Sie die Installation im 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 Abschnitt Package Dependencies (Paketabhängigkeiten) des Project Navigator (Projektnavigator) prüfen, ob das Paket und die Version korrekt sind.

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

1. Gehen Sie in Xcode zu File > Packages > Update To Latest Package Versions (Datei > Pakete > Auf neueste Paketversionen aktualisieren).

   Google Places Swift über die veraltete 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 Abschnitt „Package Dependencies“ (Paketabhängigkeiten) von Xcode.

2. Prüfen Sie die Installation im Abschnitt Package Dependencies (Paketabhängigkeiten) des Project Navigator (Projektnavigator). Dort können Sie prüfen, ob das Paket und die Version korrekt sind.

So entfernen Sie vorhandene Places SDK for iOS-Installationen, die manuell installiert wurden: führen Sie die folgenden Schritte aus:

1. Suchen Sie in den Konfigurationseinstellungen Ihres Xcode-Projekts nach Frameworks, Libraries, and Embedded Content (Frameworks, Bibliotheken und eingebettete Inhalte). Entfernen Sie die folgenden Frameworks mit dem Minuszeichen(-) :
   • GooglePlaces.xcframework
   • GooglePlacesSwift.xcframework
2. Entfernen Sie das GooglePlaces Bundle aus dem obersten Verzeichnis Ihres Xcode-Projekts.

Manuelle Installation

In diesem Leitfaden erfahren Sie, wie Sie die XCFrameworks mit dem Places SDK for iOS und dem Places Swift 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. Sie können das Places SDK for iOS, das Places Swift SDK for iOS oder beide hinzufügen.

1. Laden Sie die folgenden SDK-Binär- und Ressourcendateien herunter:
   • GooglePlaces
   • GooglePlacesResources
2. Wenn Sie das Places Swift SDK for iOS installieren, installieren Sie die folgenden Dateien:
   • GooglePlacesSwift
   • GooglePlacesSwiftResources
3. Extrahieren Sie die Dateien, um auf das XCFramework und die Ressourcen zuzugreifen.
4. Starten Sie Xcode und öffnen Sie ein vorhandenes oder erstellen Sie ein neues Projekt. Falls Sie noch keine Erfahrung in der iOS-Entwicklung haben, erstellen Sie ein neues Projekt und wählen Sie die Vorlage für iOS-Apps aus.
5. Entfernen Sie Maps-Bündel aus vorherigen Releases aus Ihrem Projekt.
6. Öffnen Sie den Tab General (Allgemein). Ziehen Sie das folgende XCFramework unter Frameworks, Libraries, and Embedded Content (Frameworks, Bibliotheken und eingebettete Inhalte) in Ihr Projekt. Stellen Sie sicher, dass Sie Do Not Embed (Nicht einbetten) auswählen:
   • GooglePlaces.xcframework
   Wenn Sie das Places Swift SDK installieren, ziehen Sie das folgende XCFramework unter Frameworks, Libraries, and Embedded Content in Ihr Projekt. Stellen Sie sicher, dass Sie Do Not Embed (Nicht einbetten) auswählen:
   • GooglePlacesSwift.xcframework
7. Kopieren Sie die Datei GooglePlaces.bundle aus GooglePlacesResources 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.
   
   Wenn Sie das Places Swift SDK installieren, kopieren Sie die Datei GooglePlacesSwift.bundle aus GooglePlacesSwiftResources 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.
8. Wählen Sie im Project Navigator Ihr Projekt aus und geben Sie dann das Ziel Ihrer App an.
9. Öffnen Sie den Tab Build Phases (Build-Phasen). Fügen Sie 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ä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).

GooglePlacesSwift

Fügen Sie Ihren API-Schlüssel folgendermaßen in AppDelegate.swift ein:

• Fügen Sie die folgende Importanweisung hinzu:

  import GooglePlacesSwift

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

  PlacesClient.provideAPIKey("YOUR_API_KEY")

Swift

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

• Fügen Sie die folgende Importanweisung hinzu:

  import GooglePlaces

• Fügen Sie Folgendes in die Methode application(_:didFinishLaunchingWithOptions:) ein, wobei YOUR_API_KEY durch Ihren 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ügen Sie Folgendes in die Methode application:didFinishLaunchingWithOptions: ein, wobei YOUR_API_KEY durch Ihren API-Schlüssel ersetzt werden muss:

  [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];