Das Google Maps Platform-Team aktualisiert die SDKs regelmäßig, um neue Funktionen einzuführen, Fehler zu korrigieren und die Leistung zu verbessern. Auf dieser Seite wird beschrieben, wie Sie die Abhängigkeiten von mobilen SDKs verwalten.
Welche Version soll verknüpft werden?
-
Erstellen Sie bei geschäftskritischen Apps eine Verknüpfung zur aktuellen Zwischenversion der verwendeten Hauptversion (X.*). Aktualisieren Sie die Verknüpfung außerdem jährlich auf die neue Hauptversion.
Wenn Sie im Laufe des Jahres neue Versionen Ihrer App veröffentlichen, können Sie neuere Punktversionen des Maps SDK for iOS verwenden. Hierfür müssen Sie Ihre App nicht aktualisieren, da neue Zwischenversionen abwärtskompatibel sind.
Vorteile:
- Wenn du im Maps SDK for iOS Probleme feststellst, erhältst du 12 Monate nach der ursprünglichen Veröffentlichung der Hauptversion Korrekturen, die gemäß der Richtlinie für den Support für Mobilgeräte behoben werden. Sie profitieren daher auch von Korrekturen, ohne schnell ein Upgrade auf eine inkompatible SDK-Version durchzuführen.
- Wenn Ihre App bereits auf der neuesten Version basiert, lassen sich die neuesten Verbesserungen und Funktionen ganz einfach implementieren.
- Jährliche inkrementelle Updates auf die neueste Hauptversion des SDK erfordern unter Umständen weniger Arbeit im Hinblick auf das Anpassen, Umprogrammieren und Testen Ihrer App, als bei nicht abwärtskompatiblen Änderungen, die in mehreren neuen Hauptversionen eingeführt werden, anfallen würde.
Bei nicht kritischen Apps reicht eine Verknüpfung zu einer beliebigen korrigierten Version aus. Wenn Sie eine Benachrichtigung über die Einstellung dieser Version erhalten, haben Sie 12 Monate Zeit, Nutzern den aktualisierten App-Code zur Verfügung zu stellen.
Vorteile:
- Es sind seltener Wartungsarbeiten erforderlich.
- Neue Versionen Ihrer App unterstützen Geräte mit älteren mobilen Betriebssystemen länger (bis Sie ein Upgrade auf eine neue SDK-Version ausführen).
Projektinhaber mit erreichbaren E-Mail-Adressen erhalten proaktive Benachrichtigungen über Änderungen, die sich auf ihre Projekte auswirken. Bleiben Sie über wichtige Updates, Einstellungen von Funktionen oder Diensten und andere Änderungen informiert.
Installation
Geben Sie in den Abhängigkeiten immer eine Versionsnummer an, anstatt einen optimistischen Operator (~>
) zu verwenden, da dies zu unvorhersehbaren und nicht wiederholbaren Builds führen kann. Das Maps SDK for iOS erfüllt die semantische Versionsverwaltung und die neuen Hauptversionen enthalten nicht abwärtskompatible Änderungen.
CocoaPods verwenden
Beispiel für eine Podfile-Abhängigkeit mit der Podfile-Syntax:
source 'https://github.com/CocoaPods/Specs.git' platform :ios, '14.0' target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GoogleMaps', '8.0.0' end
Karthago
Beispiel für eine Cartfile-Abhängigkeit mit der Syntax Cartfile:
binary "https://dl.google.com/geosdk/GoogleMaps.json" == 6.2.1
Wartung und Upgrade
Wenn Sie Builds mit den neuesten Verbesserungen erstellen möchten, suchen Sie regelmäßig nach neueren Versionen und aktualisieren Sie Ihre Versionsspezifikationen. Wenn Sie ein Update auf eine neue Hauptversion durchführen, lesen Sie die Versionshinweise für nicht abwärtskompatible Änderungen und zum Aktualisieren des Codes.
CocoaPods verwenden
Öffnen Sie ein Terminal und rufen Sie das Verzeichnis mit dem
Podfile
auf:cd <path-to-project>
- Führen Sie
pod outdated
aus, um zu prüfen, ob eine neuere Version des Maps SDK for iOS verfügbar ist. - Wenn eine neuere Version des SDK gefunden wird, aktualisiere
Podfile
auf diese neue Version. Informationen zum Festlegen einer bestimmten Version inPodfile
finden Sie unter Pod-Versionen angeben. - Führen Sie
pod update
aus. - Nehmen Sie alle erforderlichen Änderungen infolge des Upgrades vor. In den Versionshinweisen finden Sie eine Liste der Änderungen in jedem Release.
- Wählen Sie Product > Clean und dann Product > Build aus, um Ihr Projekt zu bereinigen und neu zu erstellen.
Karthago
Öffnen Sie ein Terminal und rufen Sie das Verzeichnis mit dem
Podfile
auf:cd <path-to-project>
- Führen Sie
carthage outdated
aus, um zu prüfen, ob eine neuere Version des Maps SDK for iOS verfügbar ist. - Wenn eine neuere Version des SDK gefunden wird, aktualisiere
Cartfile
auf diese neue Version. Informationen zum Festlegen einer bestimmten Version inCartfile
finden Sie unter Versionsanforderungen. - Führen Sie
carthage update
aus. - Nehmen Sie alle erforderlichen Änderungen infolge des Upgrades vor. In den Versionshinweisen finden Sie eine Liste der Änderungen in jedem Release.
- Wählen Sie Product > Clean und dann Product > Build aus, um Ihr Projekt zu bereinigen und neu zu erstellen.
Manuell
Rufen Sie den Link zu den neuesten Quelldateien ab, wenn Sie das SDK installieren.
Neben der Abfrage neuerer Versionen erhalten Google Cloud-Projektinhaber E-Mails zu abwärtsinkompatiblen Änderungen, die sich auf ihre Projekte auswirken können. Um proaktive Benachrichtigungen zu abwärtsinkompatiblen Änderungen zu erhalten, weisen Sie die Inhaberrolle mit einer überwachten E-Mail-Adresse für jedes Ihrer Projekte zu.