Auf dieser Seite wird beschrieben, wie Sie die Dienstprogrammbibliothek für das Maps SDK for iOS einrichten.
Sie haben folgende Möglichkeiten, diese Dienstprogramme auszuprobieren:
- 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.
- Installieren Sie die Dienstprogrammbibliothek in einem vorhandenen Xcode-Projekt. Fügen Sie diese Dienstprogramme in Ihrem eigenen Projekt hinzu.
Optional: CocoaPods installieren
Die Dienstprogrammbibliothek ist als CocoaPods-Pod mit dem Namen Google-Maps-iOS-Utils
verfügbar. CocoaPods ist ein Open-Source-Abhängigkeitsmanager für Swift- und Objective-C-Cocoa-Projekte.
Wenn du das Tool CocoaPods noch nicht hast, installiere es unter macOS, indem du den folgenden Befehl über das Terminal ausführst:
sudo gem install cocoapods
Weitere Informationen findest du im Startleitfaden zu CocoaPods.
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
- Laden Sie das Codebeispielarchiv von GitHub herunter und entpacken Sie das Archiv.
- Öffnen Sie ein Terminalfenster, gehen Sie zu dem Verzeichnis, in dem Sie die Beispieldateien erweitert haben, und schlüsseln Sie das entsprechende Beispielverzeichnis für die Sprache auf, die Sie verwenden möchten:
- Führen Sie für Swift
cd google-maps-ios-utils-master/samples/SwiftDemoApp
aus. - Führen Sie für Objective-C den Befehl
cd google-maps-ios-utils-master/samples/ObjCDemoApp
aus.
- Führen Sie für Swift
- Führen Sie den folgenden Befehl aus:
pod install
- Schließen Sie Xcode und klicken Sie mit einem Doppelklick auf die Datei
.xcworkspace
Ihres Projekts, um Xcode zu starten. Ab diesem Zeitpunkt müssen Sie die Datei.xcworkspace
verwenden, um das Projekt zu öffnen.
CocoaPods v1.6.1 verwenden
- Öffnen Sie ein Terminalfenster und installieren Sie Version 1.6.1:
sudo gem install cocoapods -v1.6.1
- Rufe die Google Maps-Dateien mit CocoaPods ab:
pod try Google-Maps-iOS-Utils
Wählen Sie bei entsprechender Aufforderung entweder „Swift“ oder „Objective-C“ aus. CocoaPods aktualisiert die Spezifikations-Repositories und öffnet die Demo in einem temporären Xcode-Projekt mit dem Namen
SwiftDemoApp.xcodeproj
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 dann 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 doppelte 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 doppelte 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 Sie es 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, sehen Sie die Demo des Markierungs-Clustering-Dienstprogramms. Anschließend können Sie die Objective-C-Version der Demo bearbeiten und jedes Dienstprogramm ausprobieren. Weitere Informationen finden Sie unten im Abschnitt Dienstprogramm zur App hinzufügen.
Hilfsprogrammbibliothek als Xcode-Projekt installieren
Gehen Sie wie folgt vor, um die Hilfsprogrammbibliothek Ihrem Xcode-Arbeitsbereich hinzuzufügen:
Mit CocoaPods
- 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 eine Single View Application (App mit Einzelansicht).
- 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 werden die Abhängigkeiten Ihres Projekts definiert. - Bearbeiten Sie die Pod-Datei Ihres Projekts und fügen Sie eine Abhängigkeit zum Pod
Google-Maps-iOS-Utils
hinzu. Das folgende Beispiel enthält die Abhängigkeiten, die Sie für das Maps SDK for iOS und die Dienstprogrammbibliothek benötigen:source 'https://github.com/CocoaPods/Specs.git' platform :ios, '13.0' target 'YOUR_APPLICATION_TARGET_NAME_HERE' do use_frameworks! pod 'GoogleMaps', '7.4.0' pod 'Google-Maps-iOS-Utils', '4.2.2' end
- Führen Sie
pod install
aus. - Schließen Sie Xcode und klicken Sie mit einem Doppelklick auf die Datei
.xcworkspace
Ihres Projekts, um Xcode zu starten. Ab diesem Zeitpunkt müssen Sie die Datei.xcworkspace
verwenden, um das Projekt zu öffnen.
Hinweis:Das Markierungs-Clustering-Dienstprogramm ist vom Quadtree abhängig. Sie können den Quadtree ohne Markierungscluster verwenden. Wenn Sie nur das Quadtree-Dienstprogramm verwenden möchten, können Sie in Ihrer Pod-Datei pod 'Google-Maps-iOS-Utils'
zu 'Google-Maps-iOS-Utils/QuadTree'
ändern.
Karthago verwenden
- Installiere Carthage. Es gibt verschiedene Methoden. Die genauen Schritte finden Sie in der Readme-Datei von Karthago.
- 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.
- Erstelle in deinem Projektverzeichnis eine Datei mit dem Namen
Cartfile
. In dieser Datei sind die Abhängigkeiten Ihres Projekts definiert. - Bearbeiten Sie die
Cartfile
und fügen Sie die Abhängigkeit der Dienstprogrammbibliothek des Maps SDK for iOS hinzu:
github "googlemaps/google-maps-ios-utils"
- Speichere die
Cartfile
. - Wechseln Sie in einem Terminalfenster zum Verzeichnis mit der
Cartfile
:
cd <path-to-project>
- Führen Sie den Befehl „update“ aus:
carthage update --platform iOS
Dadurch werden die in der DateiCartfile
angegebenen APIs und ggf. zugehörige Abhängigkeiten installiert. - Gehen Sie im Finder in Ihrem Projektverzeichnis unter
Carthage/Build/iOS
zu den heruntergeladenen Framework-Dateien. - Fügen Sie Ihrem Projekt die Maps SDK for iOS-Frameworks hinzu, indem Sie die folgenden Bundles in Ihr Projekt ziehen.
Wenn Sie dazu aufgefordert werden, wählen Sie Copy items if needed, use the same version as above (Elemente bei Bedarf kopieren und dieselbe Version wie oben verwenden) aus.
GoogleMaps-x.x.x/Base/Frameworks/GoogleMapsBase.framework
GoogleMaps-x.x.x/Maps/Frameworks/GoogleMaps.framework
GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsCore.framework
GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsUtils.framework
- Klicke in deinem Projekt mit der rechten Maustaste auf
GoogleMaps.framework
und wähle Show In Finder (In Finder zeigen) aus. - Ziehen Sie
Carthage/Build/iOS/GoogleMaps.framework/Resources/GoogleMaps.bundle
aus dem OrdnerResources
in Ihr Projekt. Prüfe, wenn du dazu aufgefordert wirst, ob Copy items into destination group's folder (Elemente in Ordner der Zielgruppe kopieren) ausgewählt ist. Das sollte nicht der Fall sein. - Wähle im Project Navigator dein Projekt aus und gib dann das Ziel deiner App an.
- Öffnen Sie den Tab Build Phase (Build-Phasen) für das Ziel Ihrer Anwendung und fügen Sie unter Link Binary with Libraries (Binärdatei mit Bibliotheken verknüpfen) die folgenden Frameworks hinzu:
Accelerate.framework
CoreData.framework
CoreGraphics.framework
CoreImage.framework
CoreLocation.framework
CoreTelephony.framework
CoreText.framework
GLKit.framework
ImageIO.framework
libc++.tbd
libz.tbd
OpenGLES.framework
QuartzCore.framework
SystemConfiguration.framework
UIKit.framework
Wähle statt eines bestimmten Ziels dein Projekt aus und öffne den Tab Build Settings (Build-Einstellungen). Gib im Bereich Other Linker Flags (Weitere Verknüpfungsmerker) den Code
-ObjC
ein. Falls die Einstellungen nicht angezeigt werden, filtere in der Leiste Build Settings nicht mehr nach Basic (Standard), sondern nach All (Alle).
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 Vorlage für iOS-Apps aus. Erstellen Sie unter Xcode 11.7 oder älter eine Single View Application (App mit Einzelansicht).
- Füge das Maps SDK for iOS als Abhängigkeit hinzu. Optionen finden Sie unter SDK installieren.
- Gehen Sie in Ihrem Xcode-Projekt zu File -> Swift Packages -> Add Package Dependency.
- 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. - An dieser Stelle werden Sie möglicherweise aufgefordert, sich mit Ihrem GitHub-Konto zu authentifizieren. Folgen Sie der Anleitung, um ein persönliches GitHub-Zugriffstoken zu erstellen und mit dem Vorgang fortzufahren.
- Wählen Sie im nächsten Fenster das Optionsfeld Version aus, wählen Sie in der Drop-down-Liste Genau passend aus, geben Sie die neueste Version der Maps SDK for iOS-Dienstprogrammbibliothek ein (z.B. „3.4.0“) und wählen Sie Weiter aus.
API-Schlüssel in die App einfügen
Unter Xcode-Projekt einrichten erfahren Sie, wie Sie einen API-Schlüssel generieren und Ihrem Xcode-Projekt hinzufügen.Projekt erstellen und ausführen
Nachdem Sie den API-Schlüssel hinzugefügt haben, erstellen Sie das Projekt und führen Sie es aus.
Dienstprogramm zur App hinzufügen
Weitere Informationen zur Verwendung in Ihrer App finden Sie in der Dokumentation zu den einzelnen Dienstprogrammen: