Auf dieser Seite wird beschrieben, wie die Dienstprogrammbibliothek für das Maps SDK for iOS eingerichtet wird.
Sie haben zwei Möglichkeiten, diese Dienstprogramme auszuprobieren:
- Installieren Sie die Utility-Bibliothek in einem vorhandenen Xcode-Projekt. Fügen Sie diese Dienstprogramme Ihrem eigenen Projekt hinzu.
- Installieren und ausführen der Demo-App: Die Demo-App ist ein eigenständiges Projekt, das den gesamten Code enthält, der zum Testen der Dienstprogramme erforderlich ist.
Maps SDK for iOS-Dienstprogrammbibliothek einem Xcode-Projekt hinzufügen
Gehen Sie wie folgt vor, um die Hilfsprogrammbibliothek Ihrem Xcode-Arbeitsbereich hinzuzufügen:
Swift Package Manager verwenden
- 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. In Xcode 11.7 oder einer früheren Version musst du eine Single View Application (App mit Einzelansicht) einrichten.
- Fügen Sie das Maps SDK for iOS als Abhängigkeit hinzu. Informationen zu den Optionen finden Sie unter SDK installieren.
- Gehen Sie in Ihrem Xcode-Projekt zu Datei -> Swift-Pakete -> Paketabhängigkeit hinzufügen.
- Geben Sie im angezeigten Fenster die Repository-URL der Maps SDK for iOS-Dienstprogrammbibliothek
https://github.com/googlemaps/google-maps-ios-utils
ein und wählen Sie Weiter aus. - Möglicherweise werden Sie aufgefordert, sich mit Ihrem GitHub-Konto zu authentifizieren. Folgen Sie der Anleitung, um ein persönliches GitHub-Zugriffstoken zu erstellen, um fortzufahren.
- Wählen Sie im nächsten Fenster die Option Version aus, wählen Sie in der Drop-down-Liste Bis zur nächsten Hauptversion aus und geben Sie die neueste Version der Dienstprogrammbibliothek des Google Maps SDK for iOS ein (z. B. „6.0.0“).
- Klicken Sie auf das Drop-down-Menü neben Zum Projekt hinzufügen, wählen Sie Ihr Projekt und dann Paket hinzufügen aus.
Mit CocoaPods
- 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 eine Single View Application.)
- Wenn Sie noch keine Pod-Datei für Ihr Projekt haben, erstellen Sie in Ihrem Projektverzeichnis eine Datei mit dem Namen
Podfile
. In dieser Datei sind die Abhängigkeiten des Projekts definiert. - Bearbeiten Sie die Pod-Datei Ihres Projekts und fügen Sie eine Abhängigkeit vom
Google-Maps-iOS-Utils
-Pod hinzu. Im Folgenden findest du ein Beispiel, das die Abhängigkeiten enthält, die du für das Maps SDK for iOS und die Dienstprogrammbibliothek benötigst:source 'https://github.com/CocoaPods/Specs.git' platform :ios, '15.0' target 'YOUR_APPLICATION_TARGET_NAME_HERE' do use_frameworks! pod 'GoogleMaps', '9.0.0' pod 'Google-Maps-iOS-Utils', '6.1.0' # x-release-please-version end
- Führen Sie
pod install
aus. - 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.
Hinweis:Das Tool zum Markierungsclustern ist vom Quadtree abhängig, Sie können das Quadtree aber auch ohne Markierungscluster verwenden. Wenn Sie nur das Quadtree-Dienstprogramm benötigen, können Sie in Ihrer Pod-Datei pod 'Google-Maps-iOS-Utils'
in 'Google-Maps-iOS-Utils/QuadTree'
ändern.
API-Schlüssel in die App einfügen
Eine Anleitung zum Generieren eines API-Schlüssels und zum Hinzufügen desselben zu Ihrem Xcode-Projekt finden Sie unter Xcode-Projekt einrichten.Projekt erstellen und ausführen
Nachdem Sie den API-Schlüssel hinzugefügt haben, erstellen und führen Sie das Projekt aus.
Dienstprogramm in Ihrer App verwenden
Weitere Informationen zur Verwendung in Ihrer App finden Sie in der Dokumentation zu den einzelnen Dienstprogrammen:
Demo-App installieren und ausführen
Die Dienstprogrammbibliothek enthält eine Demo-App, die Sie installieren und dann die einzelnen Dienstprogramme ausprobieren können.
So installieren Sie die Demo-App:Dateien von GitHub verwenden
- Laden Sie das Codebeispielarchiv von GitHub herunter und entpacken Sie es.
- Öffnen Sie ein Terminalfenster, wechseln Sie zum Verzeichnis, in dem Sie die Beispieldateien entpackt haben, und rufen Sie das entsprechende Beispielverzeichnis für die gewünschte Sprache auf:
- Für Swift: Führen Sie
cd google-maps-ios-utils-master/samples/SwiftDemoApp
aus. - Für Objective-C: Führen Sie
cd google-maps-ios-utils-master/samples/ObjCDemoApp
aus.
- Für Swift: Führen Sie
- Führen Sie dazu diesen Befehl aus:
pod install
- 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.
API-Schlüssel zur Demo-App hinzufügen
Unter API-Schlüssel anfordern haben Sie einen API-Schlüssel für Ihre App generiert. Fügen Sie diesen Schlüssel jetzt dem Xcode-Projekt für die Demo-App hinzu.Swift
Füge deinen API-Schlüssel folgendermaßen in AppDelegate.swift
ein:
- Fügen Sie die folgende Importanweisung hinzu:
import GoogleMaps
- Bearbeiten Sie die folgende Zeile, indem Sie Ihren API-Schlüssel zwischen die Anführungszeichen setzen:
// Change this key to a valid key registered with the demo app bundle id. let mapsAPIKey = ""
Objective-C
Füge deinen API-Schlüssel folgendermaßen in AppDelegate.m
ein:
- Fügen Sie die folgende Importanweisung hinzu:
@import GoogleMaps;
- Bearbeiten Sie die folgende Zeile, indem Sie Ihren API-Schlüssel zwischen die Anführungszeichen setzen:
// Change this key to a valid key registered with the demo app bundle id. static NSString *const kMapsAPIKey = @"";
Demo-App erstellen und ausführen
Nachdem Sie den API-Schlüssel hinzugefügt haben, erstellen und führen Sie das Projekt aus:
- Wenn Sie die Swift-Version der Demo ausführen, können Sie auswählen, welches Dienstprogramm in der App angezeigt werden soll.
- Wenn Sie die Objective-C-Version der Demo ausführen, wird die Demo des Markierungs-Clustering-Dienstprogramms angezeigt. Sie können dann die Objective-C-Version der Demo bearbeiten, um die einzelnen Dienstprogramme auszuprobieren. Weitere Informationen finden Sie unten im Abschnitt Dienstprogramm zur App hinzufügen.