Auf dieser Seite wird beschrieben, wie Sie die Dienstprogrammbibliothek für das Maps SDK for iOS
Um diese Dienstprogramme auszuprobieren, haben Sie folgende Möglichkeiten:
- Installieren Sie die Dienstprogrammbibliothek in einem vorhandenen Xcode-Projekt. Fügen Sie diese Dienstprogramme in Ihr eigenes Projekt ein.
- Installieren Sie die Demo-App und führen Sie sie aus. 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
- Wenn Sie noch kein Xcode-Projekt haben, erstellen Sie eines und speichern Sie es auf Ihrem lokalen Computer. Wenn Sie mit der iOS-Entwicklung noch nicht vertraut sind, erstellen Sie ein neues Projekt und wählen Sie die Option iOS-App Vorlage. Unter Xcode 11.7 oder älter müssen Sie eine Single View Application (Anwendung mit Einzelansicht) erstellen.
- Fügen Sie das Maps SDK for iOS als Abhängigkeit hinzu. Weitere Informationen finden Sie unter SDK installieren, um Optionen zu sehen
- Gehen Sie in Ihrem Xcode-Projekt zu File (Datei) -> Swift-Pakete -> Paketabhängigkeit hinzufügen.
- Gib im angezeigten Fenster die Repository-URL der Maps SDK for iOS-Dienstprogrammbibliothek ein
https://github.com/googlemaps/google-maps-ios-utils
und wählen Sie Weiter aus. - Sie werden dann möglicherweise aufgefordert, sich mit Ihrem GitHub-Konto zu authentifizieren. Folgen Sie Anleitung zum Erstellen einer GitHub persönliches Zugriffstoken, um den Vorgang fortzusetzen.
- Wählen Sie im nächsten Fenster das Optionsfeld Version und dann Bis zur nächsten Hauptversion aus. aus der Drop-down-Liste und geben Sie die neueste Version der Maps SDK for iOS-Dienstprogrammbibliothek ein. (z. B. „6.0.0“).
- Klicken Sie auf das Drop-down-Menü neben Add to Project (Zum Projekt hinzufügen), wählen Sie Ihr Projekt und dann Add Package (Paket hinzufügen) aus.
Mit CocoaPods
- Wenn Sie noch kein Xcode-Projekt haben, erstellen Sie eines und speichern Sie es unter auf Ihrem lokalen Computer. Wenn Sie noch keine Erfahrung mit der iOS-Entwicklung haben, erstellen Sie eine Single Anwendung ansehen.
- Wenn Sie für Ihr Projekt noch keine Pod-Datei haben, erstellen Sie eine Datei
in Ihrem Projektverzeichnis:
Podfile
. Diese Datei definiert Ihre Abhängigkeiten des Projekts. - Bearbeiten Sie die Pod-Datei Ihres Projekts und fügen Sie eine Abhängigkeit vom
Pod
Google-Maps-iOS-Utils
. Hier ist eine Beispiel mit den Abhängigkeiten, Maps SDK for iOS und die Dienstprogrammbibliothek: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.0.0' # x-release-please-version end
- Führen Sie
pod install
aus. - Schließen Sie Xcode und öffnen Sie dann per Doppelklick das
.xcworkspace
-Datei, um Xcode zu starten. Ab diesem Zeitpunkt Sie müssen die Datei.xcworkspace
zum Öffnen des Projekts verwenden.
Hinweis: Das Markierungs-Clustering-Dienstprogramm hängt vom
Quadtree, aber Sie können den Quadtree ohne Marker-Clustering verwenden. Bei Bedarf
nur das Dienstprogramm Quadtree verwenden, können Sie
pod 'Google-Maps-iOS-Utils'
bis
'Google-Maps-iOS-Utils/QuadTree'
in der Pod-Datei.
API-Schlüssel in die App einfügen
Anweisungen zum Generieren finden Sie unter Xcode-Projekt einrichten. einen API-Schlüssel und fügen ihn Ihrem Xcode-Projekt hinzu.Projekt erstellen und ausführen
Nachdem Sie den API-Schlüssel hinzugefügt haben, erstellen Sie das Projekt und führen es aus.
Dienstprogramm in Ihrer App verwenden
Weitere Informationen zur Verwendung in Ihrer Anwendung 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 jedes Dienstprogramm ausprobieren können.
Installieren Sie die Demo-App mit einer der folgenden Methoden:Dateien von GitHub verwenden
- Herunterladen das Codebeispiel-Archiv von GitHub und entpacke das Archiv.
- Öffnen Sie ein Terminalfenster, gehen Sie zu dem Verzeichnis, in dem Sie die Beispieldateien maximiert haben, und
Rufen Sie das entsprechende Beispielverzeichnis für die zu verwendende Sprache auf:
<ph type="x-smartling-placeholder">
- </ph>
- Führen Sie für Swift
cd google-maps-ios-utils-master/samples/SwiftDemoApp
aus. - Führen Sie für Objective-C
cd google-maps-ios-utils-master/samples/ObjCDemoApp
aus.
- Führen Sie für Swift
- Führen Sie dazu diesen Befehl aus:
pod install
- Schließen Sie Xcode und öffnen Sie dann per Doppelklick das
.xcworkspace
-Datei, um Xcode zu starten. Ab diesem Zeitpunkt Sie müssen die Datei.xcworkspace
zum Öffnen des Projekts verwenden.
CocoaPods v1.6.1 verwenden
- Öffnen Sie ein Terminalfenster und installieren Sie Version 1.6.1:
sudo gem install cocoapods -v1.6.1
- Rufen Sie die Google Maps-Dateien mithilfe von CocoaPods ab:
pod try Google-Maps-iOS-Utils
Wählen Sie bei entsprechender Aufforderung entweder „Swift“ oder „Objective-C“ aus. CocoaPods aktualisiert Ihre Spezifikations-Repositories, Anschließend wird die Demo in einem temporären Xcode-Projekt mit dem Namen
SwiftDemoApp.xcodeproj
geöffnet. oderObjCDemoApp.xcodeproj
.
API-Schlüssel zur Demo-App hinzufügen
Unter API-Schlüssel abrufen generieren Sie einen API-Schlüssel für Ihre App. Fügen Sie diesen Schlüssel nun 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, um Ihren API-Schlüssel zwischen doppelten Anführungszeichen einzufügen:
// 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, um Ihren API-Schlüssel zwischen doppelten Anführungszeichen einzufügen:
// 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 Sie das Projekt und führen es aus:
- Wenn Sie die Swift-Version der Demo verwenden, können Sie auswählen, welches Dienstprogramm in der App angezeigt werden soll.
- Wenn Sie die Objective-C-Version der Demo ausführen, sehen Sie die Demo des Markierungs-Clustering-Dienstprogramms. Anschließend können Sie die Objective-C-Version der Demo bearbeiten, um jedes Dienstprogramm auszuprobieren. Weitere Informationen finden Sie unten im Abschnitt Dienstprogramm zur App hinzufügen.