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 App 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 16.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. Wenn Sie das SDK hinzufügen möchten, müssen Sie alle vorhandenen Abhängigkeiten des Places SDK for iOS entfernen.

: In dieser Anleitung wird davon ausgegangen, dass Sie Xcode 15 oder höher verwenden. Die Schritte sollten aber auch für frühere Versionen von Xcode ähnlich sein.

So fügen Sie das SDK einem neuen oder vorhandenen Projekt hinzu:

  1. Öffnen Sie Ihr Xcode-Projekt project oder workspace und gehen Sie 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 „Paket hinzufügen“.
  3. Wenn Sie eine bestimmte version installieren möchten, legen Sie für das Feld Dependency Rule (Abhängigkeitsregel) eine der versionsbasierten Optionen fest. Bei neuen Projekten empfehlen wir, die neueste 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 Ihrem festgelegten Hauptziel hinzugefügt werden. Wenn Sie alles eingegeben haben, klicken Sie 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 „Package Dependencies“ (Paketabhängigkeiten) in Xcode.

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

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

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

    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 „Package Dependencies“ (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 das Places SDK for iOS, das manuell installiert wurde:

  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 im Verzeichnis der obersten Ebene Ihres Xcode-Projekts das GooglePlaces-Bundle.

Manuelle Installation

In diesem Leitfaden erfahren Sie, wie Sie die XCFrameworks, die das Places SDK for iOS und das Places Swift SDK for iOS enthalten, 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:
  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. Falls 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 in Ihr Projekt unter Frameworks, Libraries, and Embedded Content (Frameworks, Bibliotheken und eingebettete Inhalte). Achten Sie darauf, dass Sie Nicht einbetten auswählen:
    • GooglePlaces.xcframework
    Wenn Sie das Places Swift SDK installieren, ziehen Sie das folgende XCFramework in Ihr Projekt unter Frameworks, Libraries, and Embedded Content. Achten Sie darauf, dass Sie Nicht einbetten auswählen:
    • GooglePlacesSwift.xcframework
  7. Kopieren Sie die GooglePlaces.bundle aus den heruntergeladenen GooglePlacesResources in das oberste Verzeichnis Ihres Xcode-Projekts. Wähle bei der Aufforderung Elemente in Ordner der Zielgruppe kopieren aus.

    Wenn Sie das Places Swift SDK installieren, kopieren Sie die GooglePlacesSwift.bundle aus dem heruntergeladenen GooglePlacesSwiftResources in das oberste Verzeichnis Ihres Xcode-Projekts. Wähle bei der Aufforderung Elemente in Ordner der Zielgruppe kopieren aus.
  8. Wähle im Project Navigator dein Projekt aus und gib dann das Ziel deiner App an.
  9. Öffnen Sie den Tab Build Phases (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 Settings (Build-Einstellungen). Füge im Bereich Linking - General -> Other Linker Flags (Verknüpfung – Allgemein –> Weitere Verknüpfungsmerker) den Code -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 sind als CocoaPod-Pods GooglePlaces und GooglePlacesSwift 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 finden Sie im Startleitfaden zu CocoaPods.

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. Falls 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. Bearbeite die Podfile und füge deine Abhängigkeiten zusammen mit ihren Versionen hinzu. Hier ist ein Beispiel, in dem der Zielname Ihrer Anwendung und die Namen der GooglePlaces- und GooglePlacesSwift-Pods angegeben werden: 
    source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '16.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GooglePlaces', '10.1.0'
  pod 'GooglePlacesSwift', '10.1.0'
end
     Führen Sie pod outdated regelmäßig aus, um zu erkennen, wann eine neuere Version verfügbar ist, damit Sie immer die aktuelle Version verwenden.
  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. Öffnen Sie ein Terminal und wechseln Sie zum Projektverzeichnis mit der Podfile.
  2. Führen Sie den Befehl pod update aus: Dadurch werden alle im Podfile angegebenen APIs auf die neueste Version aktualisiert.

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

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

GooglePlacesSwift

Füge deinen 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"];

Schritt 4 (optional): Apple-Datei mit Datenschutzmanifest prüfen

Apple verlangt Angaben zum App-Datenschutz für Apps im App Store. Aktuelle Informationen finden Sie auf der Seite „App Privacy Details“ im Apple App Store.

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

Nächste Schritte