Versionen des Maps SDK for iOS

Plattform auswählen: Android iOS JavaScript

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.

  • 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

  1. Öffnen Sie ein Terminal und rufen Sie das Verzeichnis mit dem Podfile auf:

    cd <path-to-project>
  2. Führen Sie pod outdated aus, um zu prüfen, ob eine neuere Version des Maps SDK for iOS verfügbar ist.
  3. Wenn eine neuere Version des SDK gefunden wird, aktualisiere Podfile auf diese neue Version. Informationen zum Festlegen einer bestimmten Version in Podfile finden Sie unter Pod-Versionen angeben.
  4. Führen Sie pod update aus.
  5. Nehmen Sie alle erforderlichen Änderungen infolge des Upgrades vor. In den Versionshinweisen finden Sie eine Liste der Änderungen in jedem Release.
  6. Wählen Sie Product > Clean und dann Product > Build aus, um Ihr Projekt zu bereinigen und neu zu erstellen.

Karthago

  1. Öffnen Sie ein Terminal und rufen Sie das Verzeichnis mit dem Podfile auf:

    cd <path-to-project>
  2. Führen Sie carthage outdated aus, um zu prüfen, ob eine neuere Version des Maps SDK for iOS verfügbar ist.
  3. Wenn eine neuere Version des SDK gefunden wird, aktualisiere Cartfile auf diese neue Version. Informationen zum Festlegen einer bestimmten Version in Cartfile finden Sie unter Versionsanforderungen.
  4. Führen Sie carthage update aus.
  5. Nehmen Sie alle erforderlichen Änderungen infolge des Upgrades vor. In den Versionshinweisen finden Sie eine Liste der Änderungen in jedem Release.
  6. 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.