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:
-
Öffnen Sie Ihre Xcode-
projectoderworkspaceund gehen Sie dann zu File > Add Package Dependencies (Datei > Paketabhängigkeiten hinzufügen). - 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).
-
Wenn Sie eine bestimmte
versioninstallieren 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“. - Prüfen Sie im Fenster Paketprodukte auswählen, ob
GooglePlaces,GooglePlacesSwiftoder 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-sdkzugegriffen wurde, entfernen Sie sie aus dem Abschnitt „Package Dependencies“ (Paketabhängigkeiten) in Xcode. - 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:
-
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-sdkzugegriffen wurde, entfernen Sie sie aus dem Abschnitt „Package Dependencies“ (Paketabhängigkeiten) in Xcode. - 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:
-
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.xcframeworkGooglePlacesSwift.xcframework
-
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.
- Laden Sie die folgenden SDK-Binär- und Ressourcendateien herunter:
- Wenn Sie das Places Swift SDK for iOS installieren, installieren Sie die folgenden Dateien:
- Extrahieren Sie die Dateien, um auf das XCFramework und die Ressourcen zuzugreifen.
- 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.
- Entfernen Sie Maps-Bündel aus vorherigen Releases aus Ihrem Projekt.
-
Ö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
GooglePlacesSwift.xcframework
-
Kopieren Sie die Datei
GooglePlaces.bundleaus 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 dieGooglePlacesSwift.bundleaus den heruntergeladenen GooglePlacesSwiftResources in das oberste Verzeichnis Ihres Xcode-Projekts. Wählen Sie bei Aufforderung Elemente in den Ordner der Zielgruppe kopieren aus. - Wählen Sie Ihr Projekt im Project Navigator aus und wählen Sie das Ziel Ihrer Anwendung aus.
-
Öffnen Sie den Tab Build Phases (Build-Phasen). Fügen Sie unter Link Binary with Libraries die folgenden Frameworks und Bibliotheken hinzu:
CoreGraphics.frameworkCoreLocation.frameworklibc++.tbdlibz.tbdQuartzCore.frameworkUIKit.framework
-
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)
-ObjCzu „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.
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
- Beginnen Sie mit dem Schreiben von Code. Als Ausgangspunkt empfiehlt es sich, eine Starter-App zu implementieren, die den aktuellen Ort des Nutzers abruft.
- Nachdem Ihr Projekt konfiguriert wurde, können Sie sich die Beispiel-Apps ansehen.
- API-Schlüssel mit App Check schützen