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 neue Versionen Ihrer Anwendung veröffentlichen im Laufe des Jahres können Sie neuere Zwischenversionen des Maps SDK for iOS verwenden. Hierfür müssen Sie Ihre App nicht aktualisieren, da neue Zwischenversionen abwärtskompatibel sind.
Vorteile:
- Probleme mit dem Maps SDK for iOS werden in einer abwärtskompatibel für 12 Monate nach der Erstveröffentlichung der Hauptversion, den Support für Mobilgeräte . 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 verursachen unter Umständen weniger Aufwand beim Anpassen, Umschreiben und Testen Ihrer Anwendung als abwärtsinkompatible Änderungen, die über mehrere Hauptversionen hinweg vorgenommen werden.
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).
Project Owner mit erreichbaren E-Mail-Adressen erhalten proaktive Benachrichtigungen über Änderungen, die sich auf ihre Projekte auswirken. Weitere Informationen zu wichtigen Updates, zu Einstellungen und zu anderen Änderungen finden Sie hier.
Installation
Swift-Paketmanager
Das Maps SDK for iOS kann über installiert werden. Swift Package Manager Um das SDK hinzuzufügen, müssen Sie alle vorhandenen Abhängigkeiten des Maps SDK for iOS entfernt.
So fügen Sie das SDK einem neuen oder vorhandenen Projekt hinzu:
-
Öffne deinen Xcode
project
oderworkspace
und klicke auf Datei > Paketabhängigkeiten hinzufügen. - Geben Sie https://github.com/googlemaps/ios-maps-sdk als URL ein und drücken Sie die Eingabetaste. um das Paket zu laden, und klicke auf „Paket hinzufügen“.
-
Wenn Sie eine bestimmte
version
installieren möchten, legen Sie das Feld Abhängigkeitsregel auf eine der folgenden Optionen fest: zu den versionsbasierten Optionen. Für neue Projekte empfehlen wir, die neueste Version und mit der Spalte „Exakte Version“ Option. Klicke anschließend auf „Paket hinzufügen“. -
Bestätige im Fenster Paketprodukte auswählen die Option
GoogleMaps
(für Versionen vor 9.0.0:GoogleMaps
,GoogleMapsBase
undGoogleMapsCore
) werden zu Ihr festgelegtesmain
-Ziel. Klicke anschließend auf „Paket hinzufügen“. -
Um die Installation zu überprüfen, navigiere zum Bereich
General
deines Ziels. Die installierten Pakete sollten nun unter Frameworks, Bibliotheken und eingebettete Inhalte zu sehen sein. Sie können auch die „Paketabhängigkeiten“ von Projektnavigator um das Paket und seine Version zu überprüfen.
So aktualisieren Sie package
für ein vorhandenes Projekt:
Wenn Sie ein Upgrade von einer früheren Version als 9.0.0 durchführen,müssen Sie die folgenden Abhängigkeiten:
GoogleMapsBase
,GoogleMapsCore
undGoogleMapsM4B
nach dem Upgrade. Entfernen Sie nicht die Abhängigkeit fürGoogleMaps
Weitere Informationen finden Sie in der Versionshinweise zu Version 9.0.0Gehen Sie in den Konfigurationseinstellungen des Xcode-Projekts zu Frameworks, Libraries, und eingebettete Inhalte. Verwenden Sie das Minuszeichen(-), um das folgende Framework zu entfernen:
GoogleMapsBase
(nur für Upgrades von Versionen vor 9.0.0)GoogleMapsCore
(nur für Upgrades von Versionen vor 9.0.0)GoogleMapsM4B
(nur für Upgrades von Versionen vor 9.0.0)
- Gehen Sie in Xcode zu „File > Pakete > Auf neueste Paketversionen aktualisieren“.
- Um die Installation zu überprüfen, gehen Sie in der Projektnavigation zum Abschnitt Paketabhängigkeiten. um das Paket und seine Version zu überprüfen.
Vorhandene Maps SDK for iOS-Abhängigkeiten entfernen, die mithilfe von
CocoaPods
, gehen Sie so vor:
- Schließen Sie den Xcode-Arbeitsbereich. Öffnen Sie das Terminal und führen Sie den folgenden Befehl aus:
sudo gem install cocoapods-deintegrate cocoapods-clean pod deintegrate pod cache clean --all
-
Entfernen Sie
Podfile
,Podfile.resolved
und den Xcodeworkspace
, wenn du sie ausschließlich für CocoaPods verwendest.
CocoaPods
Geben Sie in Ihren Abhängigkeiten immer eine Versionsnummer an, anstatt einen optimistischen Operator zu verwenden
(~>
), da dies zu unvorhersehbaren und nicht wiederholbaren Builds führen kann. Die
Das Maps SDK for iOS hält die semantische Versionsverwaltung ein.
und neue Hauptversionen enthalten
funktionsgefährdende Änderungen.
Beispiel für eine Podfile-Abhängigkeit mit Podfile-Syntax:
source 'https://github.com/CocoaPods/Specs.git' platform :ios, '15.0' target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GoogleMaps', '8.4.0' end
Wartung und Upgrade
Um die neuesten Verbesserungen zu nutzen, suchen Sie regelmäßig nach neueren Versionen und aktualisieren Sie Ihre Version Spezifikationen. Wenn Sie auf eine neue Hauptversion aktualisieren, aktivieren Sie die Versionshinweise zu nicht abwärtskompatiblen Änderungen und zur Aktualisierung des Codes.
Swift-Paketmanager
So aktualisieren Sie package
für ein vorhandenes Projekt:
Wenn Sie ein Upgrade von einer früheren Version als 9.0.0 durchführen,müssen Sie die folgenden Abhängigkeiten:
GoogleMapsBase
,GoogleMapsCore
undGoogleMapsM4B
nach dem Upgrade. Entfernen Sie nicht die Abhängigkeit fürGoogleMaps
Weitere Informationen finden Sie in der Versionshinweise zu Version 9.0.0Gehen Sie in den Konfigurationseinstellungen des Xcode-Projekts zu Frameworks, Libraries, und eingebettete Inhalte. Verwenden Sie das Minuszeichen(-), um das folgende Framework zu entfernen:
GoogleMapsBase
(nur für Upgrades von Versionen vor 9.0.0)GoogleMapsCore
(nur für Upgrades von Versionen vor 9.0.0)GoogleMapsM4B
(nur für Upgrades von Versionen vor 9.0.0)
- Gehen Sie in Xcode zu „File > Pakete > Auf neueste Paketversionen aktualisieren“.
- Um die Installation zu überprüfen, gehen Sie in der Projektnavigation zum Abschnitt Paketabhängigkeiten. um das Paket und seine Version zu überprüfen.
CocoaPods
Öffnen Sie ein Terminal und wechseln Sie zum Verzeichnis mit der Datei
Podfile
:cd <path-to-project>
- Führen Sie
pod outdated
aus, um zu sehen, ob eine neuere Version des Maps SDK for iOS verfügbar ist verfügbar ist. - Wenn eine neuere Version des SDK gefunden wird, aktualisiere dein
Podfile
mit dieser neuen Version. Siehe Pod-Versionen angeben finden Sie weitere Informationen dazu, wie Sie eine bestimmte Version in IhremPodfile
festlegen. - Führen Sie
pod update
aus. - Nehmen Sie alle notwendigen Änderungen infolge des Upgrades vor. Weitere Informationen finden Sie in der Versionshinweise: Eine Liste der Änderungen in den einzelnen Releases.
- Bereinigen Sie Ihr Projekt und erstellen Sie es neu. Wählen Sie dazu Produkt > Bereinigen und dann Produkt > Erstellen
Manuelle Installation
Link zu den neuesten Quelldateien abrufen unter SDK installieren.
Neben der Abfrage neuerer Versionen kann Google Cloud Projekt Inhaber erhalten E-Mails zu abwärtsinkompatiblen Änderungen, die sich auf ihre Projekte auswirken können. Bis proaktiv über nicht abwärtskompatible Änderungen informiert werden, zuweisen Inhaberrolle mit einer überwachten E-Mail-Adresse für jedes Ihrer Projekte.