Xcode-Projekt einrichten

Nachdem Sie die Abrechnung aktiviert und einen API-Schlüssel erstellt haben, können Sie das Xcode-Projekt für die Entwicklung Ihrer Anwendung einrichten.

Für jede Version sind Versionshinweise verfügbar.

Schritt 1: Erforderliche Software installieren

Wenn Sie ein Projekt mit dem Places SDK for iOS erstellen möchten, benötigen Sie Folgendes:

  • Xcode-Version 26.0 oder höher

Schritt 2: Xcode-Projekt erstellen und Places SDK for iOS installieren

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 Ihre Xcode-project oder workspace und gehen Sie dann zu File > Add Package Dependencies (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 abzurufen, und klicken Sie auf „Add Package“ (Paket hinzufügen).
  3. Wenn Sie eine bestimmte version installieren möchten, legen Sie im Feld Abhängigkeitsregel eine der versionsbasierten Optionen fest. Für neue Projekte empfehlen wir, die aktuelle Version anzugeben und die Option „Genaue Version“ zu verwenden. Klicken Sie anschließend auf „Paket hinzufügen“.
  4. Prüfen Sie im Fenster Paketprodukte auswählen, ob GooglePlaces, GooglePlacesSwift oder beide dem angegebenen Hauptziel hinzugefügt werden. Klicken Sie anschließend auf Paket hinzufügen.

    Wenn Sie Google Places Swift von der verworfenen 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) in Xcode.

  5. Rufen Sie den Bereich Allgemein des Ziels auf, um die Installation zu überprüfen. Unter Frameworks, Libraries, and Embedded Content (Frameworks, Bibliotheken und eingebettete Inhalte) sollten die installierten Pakete angezeigt werden. Sie können auch im Abschnitt Paketabhängigkeiten des Project Navigator das Paket und seine Version prüfen.

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

  1. Gehen Sie in Xcode zu File > Packages > Update To Latest Package Versions.

    Wenn Sie Google Places Swift von der verworfenen 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) in Xcode.

  2. Wenn Sie die Installation überprüfen möchten, 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, Libraries, and Embedded Content (Frameworks, Bibliotheken und eingebettete Inhalte). Verwenden Sie das Minuszeichen (-), um die folgenden Frameworks zu entfernen:
    • GooglePlaces.xcframework
    • GooglePlacesSwift.xcframework
  2. Entfernen Sie das GooglePlaces-Bundle aus dem obersten Verzeichnis Ihres Xcode-Projekts.

Manuelle Installation

In diesem Leitfaden wird beschrieben, wie Sie die XCFrameworks mit dem Places SDK for iOS und dem Places Swift SDK for iOS manuell zu Ihrem Projekt hinzufügen und die Build-Einstellungen in Xcode konfigurieren. Ein XCFramework ist ein Binärpaket, das Sie auf mehreren Plattformen verwenden können, einschließlich Computern mit Apple Silicon. 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:
  2. Wenn Sie das Places Swift SDK for iOS installieren, installieren Sie die folgenden Dateien:
  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 Sie noch nicht so viel Erfahrung mit der iOS-Entwicklung haben, erstellen Sie ein neues Projekt und wählen Sie die iOS-App-Vorlage aus.
  5. Entfernen Sie Maps-Bündel aus vorherigen Releases aus Ihrem Projekt.
  6. Öffnen Sie den Tab Allgemein. Ziehen Sie das folgende XCFramework in Ihr Projekt unter Frameworks, Libraries, and Embedded Content. Wählen Sie Nicht einbetten aus:
    • GooglePlaces.xcframework
    Wenn Sie das Places Swift SDK installieren, ziehen Sie das folgende XCFramework in Ihr Projekt unter Frameworks, Libraries, and Embedded Content. Wählen Sie Nicht einbetten aus:
    • GooglePlacesSwift.xcframework
  7. Kopieren Sie die Datei GooglePlaces.bundle aus dem heruntergeladenen GooglePlacesResources-Verzeichnis in das oberste Verzeichnis Ihres Xcode-Projekts. Wählen Sie bei Aufforderung Elemente in den Ordner der Zielgruppe kopieren aus.

    Wenn Sie das Places Swift SDK installieren, kopieren Sie die GooglePlacesSwift.bundle aus den heruntergeladenen GooglePlacesSwiftResources in das oberste Verzeichnis Ihres Xcode-Projekts. Wählen Sie bei Aufforderung Elemente in den Ordner der Zielgruppe kopieren aus.
  8. Wählen Sie Ihr Projekt im Project Navigator aus und wählen Sie das Ziel Ihrer Anwendung aus.
  9. Öffnen Sie den Tab Build Phases (Build-Phasen). Fügen Sie unter Link Binary with Libraries die folgenden Frameworks und Bibliotheken hinzu:
    • CoreGraphics.framework
    • CoreLocation.framework
    • libc++.tbd
    • libz.tbd
    • QuartzCore.framework
    • UIKit.framework
  10. Wählen Sie Ihr Projekt und nicht ein bestimmtes Ziel aus und öffnen Sie den Tab Build Settings. Fügen Sie im Abschnitt Linking - General -> Other Linker Flags (Verknüpfung – Allgemein –> Andere Linker-Flags) -ObjC zu „Debug“ und „Release“ hinzu. Wenn diese Einstellungen nicht sichtbar sind, ändern Sie den Filter in der Leiste Build-Einstellungen von Einfach zu Alle.

Schritt 3: API-Schlüssel in die App einfügen

Ersetzen Sie YOUR_API_KEY in den folgenden Beispielen durch Ihren API-Schlüssel.

<h3" data-text="12974050100921915444" id="googleplacesswift" tabindex="-1">GooglePlacesSwift</h3">

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

  • Fügen Sie die folgende Importanweisung hinzu:
    import GooglePlacesSwift
  • Fügen Sie der Methode application(_:didFinishLaunchingWithOptions:) Folgendes hinzu und ersetzen Sie dabei YOUR_API_KEY durch Ihren API-Schlüssel:
    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 der Methode application(_:didFinishLaunchingWithOptions:) Folgendes hinzu und ersetzen Sie dabei YOUR_API_KEY durch Ihren API-Schlüssel:
    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 der Methode application:didFinishLaunchingWithOptions: Folgendes hinzu und ersetzen Sie dabei YOUR_API_KEY durch Ihren API-Schlüssel:
    [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

Schritt 4 (optional): Datenschutzmanifestdatei von Apple prüfen

Apple verlangt Datenschutzdetails für Apps im App Store. Aktuelle Informationen und weitere Details finden Sie auf der Seite mit den Datenschutzdetails im Apple App Store.

Die Datenschutzmanifestdatei von Apple ist im Ressourcen-Bundle für das SDK enthalten. Wenn Sie prüfen möchten, ob die Datenschutzmanifestdatei enthalten ist, und ihren Inhalt einsehen möchten, erstellen Sie ein Archiv Ihrer App und generieren Sie einen Datenschutzbericht aus dem Archiv.

Nächste Schritte