Zespół Google Maps Platform regularnie aktualizuje pakiety SDK o nowe funkcje, poprawki błędów i ulepszenia w zakresie wydajności. Na tej stronie znajdziesz wskazówki, jak zarządzać zależnościami od mobilnych pakietów SDK.
Z którą wersją połączyć?
-
W przypadku aplikacji o kluczowym znaczeniu: podaj link do najnowszej wersji z kropką używanej wersji głównej (X.*) i uaktualnij ją co roku do nowej wersji głównej.
W ciągu roku od opublikowania nowych wersji aplikacji możesz zacząć używać nowszych wersji pakietu Maps SDK na iOS. Nie będzie to wymagało aktualizacji aplikacji, ponieważ nowe wersje z kropkami są zgodne wstecznie.
Zalety:
- Jeśli zauważysz problemy w pakiecie SDK Map Google na iOS, poprawki będą udostępniane w sposób zgodny wstecznie przez 12 miesięcy od pierwszej wersji głównej wersji, zgodnie z zasadami pomocy na urządzeniach mobilnych. Aby korzystać z poprawek, nie musisz pilnie przechodzić na incompatible wersję pakietu SDK.
- Najnowsze ulepszenia i funkcje można łatwo wdrożyć, gdy Twoja aplikacja jest już skompilowana w najnowszej wersji.
- Coroczne aktualizacje przyrostowe najnowszej głównej wersji pakietu SDK mogą wymagać mniej pracy przy adaptacji, przeredagowaniu i przetestowaniu aplikacji niż w przypadku wprowadzania niezgodnych wstecznie zmian wprowadzonych w wielu wersjach głównych.
W przypadku niekrytycznych aplikacji podaj link do dowolnej poprawionej wersji. Gdy otrzymasz powiadomienie o wycofaniu poprawionej wersji, będziesz mieć 12 miesięcy na udostępnienie zaktualizowanego kodu aplikacji użytkownikom.
Zalety:
- Rzadsze prace konserwacyjne.
- Nowe wersje Twojej aplikacji przez dłuższy czas obsługują urządzenia użytkowników ze starszymi systemami operacyjnymi na urządzenia mobilne (do momentu uaktualnienia pakietu SDK).
Właściciele projektów z monitorowanymi adresami e-mail otrzymują aktywne powiadomienia o zmianach, które wpływają na ich projekty. Bądź na bieżąco z najważniejszymi aktualizacjami, wycofanymi elementami i innymi zmianami.
Instalacja
Zawsze podawaj w zależnościach numer wersji, zamiast używać operatora optymistycznego (~>
), ponieważ może to prowadzić do nieprzewidywalnych i unikalnych kompilacji. Pakiet SDK Map Google na iOS jest zgodny z semantyczną obsługą wersji. Nowe wersje główne zawierają zmiany powodujące niezgodność.
Przykładowa zależność Podfile z użyciem składni Podfile:
source 'https://github.com/CocoaPods/Specs.git' platform :ios, '14.0' target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GoogleMaps', '8.3.0' end
Konserwacja i uaktualnianie
Aby korzystać z najnowszych ulepszeń, regularnie sprawdzaj dostępność nowszych wersji i aktualizuj specyfikacje. Jeśli aktualizujesz nową wersję główną, sprawdź w informacjach o wersji, czy zmiany nie są zgodne wstecznie, i informacje o tym, jak zaktualizować kod.
Korzystanie z Cocoapods
Otwórz terminal i przejdź do katalogu zawierającego
Podfile
:cd <path-to-project>
- Uruchom
pod outdated
, aby sprawdzić, czy jest dostępna nowsza wersja pakietu SDK Map Google na iOS. - Jeśli zostanie znaleziona nowsza wersja pakietu SDK, zaktualizuj do niej
Podfile
. Zapoznaj się z sekcją Określanie wersji podów, aby dowiedzieć się, jak ustawić konkretną wersję wPodfile
. - Uruchom
pod update
. - Wprowadź wszelkie niezbędne zmiany wynikające z przekształcenia kampanii. Listę zmian wprowadzonych w każdej wersji znajdziesz w informacjach o wersji.
- Wyczyść i odtwórz projekt, wybierając Usługa > Wyczyść, a następnie Usługa > Kompilacja.
Ręczne
Na stronie instalowania pakietu SDK pobierz link do najnowszych plików źródłowych.
Oprócz odpytywania w poszukiwaniu nowszych wersji właściciele projektów Google Cloud otrzymują e-maile o niezgodnych wstecznie zmian, które mogą mieć wpływ na ich projekty. Aby otrzymywać aktywne powiadomienia o niezgodnych wstecznie zmian, przypisz do każdego projektu rolę właściciela monitorowanego adresu e-mail.