Zespół Google Maps Platform regularnie aktualizuje pakiety SDK o nowe funkcje, poprawki błędów i ulepszenia wydajności. Na tej stronie znajdziesz wskazówki, jak zarządzać zależnościami od mobilnych pakietów SDK.
Którą wersję chcesz połączyć?
-
W przypadku aplikacji o kluczowym znaczeniu podaj link do najnowszej wersji z kropką używanej wersji głównej (X.*) i aktualizuj ją co roku do nowej wersji głównej.
W ciągu roku udostępniasz nowe wersje swojej aplikacji, w miarę co możesz zacząć korzystać z nowszych wersji pakietu SDK Map Google na iOS w wersji z kropkami. Nie będzie to wymagać aktualizacji w aplikacji, ponieważ nowe wersje z kropką 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 pierwszego wydania wersji głównej, zgodnie z zasadami dotyczącymi pomocy na urządzeniach mobilnych. Nie musisz pilnie przechodzić na incompatible wersję pakietu SDK, aby korzystać z poprawek.
- Najnowsze ulepszenia i funkcje można łatwo wdrożyć, jeśli Twoja aplikacja zawiera już najnowszą wersję.
- Coroczne aktualizacje przyrostowe najnowszej głównej wersji pakietu SDK mogą wymagać mniej pracy przy dostosowywaniu, przeredagowaniu i testowaniu aplikacji niż w przypadku obsługi niekompatybilnych 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 użytkownikom zaktualizowanego kodu aplikacji.
Zalety:
- Rzadsze prace konserwacyjne.
- Nowe wersje Twojej aplikacji przez dłuższy czas umożliwiają obsługę urządzeń ze starszymi systemami operacyjnymi na urządzenia mobilne (aż do momentu uaktualnienia pakietu SDK).
Właściciele projektów, którzy mają monitorowane adresy e-mail, otrzymują aktywne powiadomienia o zmianach, które wpływają na ich projekty. Bądź na bieżąco z głównymi aktualizacjami, wycofywaniami i innymi zmianami.
Instalacja
Menedżer pakietów Swift
Pakiet SDK Map Google na iOS można zainstalować za pomocą menedżera pakietów Swift. Aby dodać pakiet SDK, usuń wszystkie istniejące zależności pakietu Maps SDK na iOS.
Aby dodać pakiet SDK do nowego lub istniejącego projektu, wykonaj te czynności:
-
Otwórz plik Xcode
projectlubworkspacei kliknij Plik > Dodaj zależności pakietów. - Wpisz adres URL https://github.com/googlemaps/ios-maps-sdk, naciśnij Enter, by pobrać pakiet, a następnie kliknij „Dodaj pakiet”.
-
Aby zainstalować określony
version, w polu Reguła zależności ustaw jedną z opcji opartych na wersji. W przypadku nowych projektów zalecamy określenie najnowszej wersji i użycie opcji „Dokładna wersja”. Gdy skończysz, kliknij „Dodaj pakiet”. -
W oknie Wybierz produkty w pakiecie sprawdź, czy
GoogleMaps,GoogleMapsBaseiGoogleMapsCorezostaną dodane do wyznaczonego miejsca docelowegomain. Gdy skończysz, kliknij „Dodaj pakiet”. -
Aby sprawdzić instalację, przejdź do panelu
Generalśrodowiska docelowego. Zainstalowane pakiety powinny być widoczne w sekcji Frameworks, Biblioteki i Umieszczone treści. Możesz też wyświetlić sekcję „Zależności pakietów” w aplikacji „Project Navigator”, aby sprawdzić pakiet i jego wersję.
Aby zaktualizować package w istniejącym projekcie, wykonaj te czynności:
- W Xcode wybierz kolejno „File” (Plik) > Packages (Pakiety) > Update To Last Package Versions (Aktualizuj do najnowszych wersji pakietów).
- Aby sprawdzić instalację, przejdź do sekcji Zależności pakietów w Project Navigator i sprawdź pakiet i jego wersję.
Aby usunąć zależności pakietu Maps SDK na iOS dodane za pomocą CocoaPods, wykonaj te czynności:
- Zamknij obszar roboczy Xcode. Otwórz terminal i wykonaj to polecenie:
sudo gem install cocoapods-deintegrate cocoapods-clean pod deintegrate pod cache clean --all
-
Usuń
Podfile,Podfile.resolvedi Xcodeworkspace, jeśli nie używasz ich do niczego innego niż CocoaPods.
CocoaPods
Zawsze określaj w zależnościach numer wersji, zamiast używać operatora optymistycznego (~>), ponieważ może to prowadzić do nieprzewidywalnych i niepowtarzalnych kompilacji. Pakiet SDK Map Google na iOS jest zgodny z obsługą wersji semantycznej, a nowe wersje główne zawierają zmiany powodujące niezgodność.
Przykładowa zależność z plikiem Podfile ze składnią Podfile:
source 'https://github.com/CocoaPods/Specs.git' platform :ios, '15.0' target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GoogleMaps', '8.4.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 są niezgodne wstecznie, i jak zaktualizować kod.
Menedżer pakietów Swift
Aby zaktualizować package w istniejącym projekcie, wykonaj te czynności:
- W Xcode wybierz kolejno „File” (Plik) > Packages (Pakiety) > Update To Last Package Versions (Aktualizuj do najnowszych wersji pakietów).
- Aby sprawdzić instalację, przejdź do sekcji Zależności pakietów w Project Navigator i sprawdź pakiet i jego wersję.
Kocoapody
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 znajdziemy nowszą wersję pakietu SDK, zaktualizuj ją do
Podfile. W sekcji Określanie wersji podów dowiesz się, jak ustawić konkretną wersję wPodfile. - Uruchom
pod update. - Wprowadź niezbędne zmiany w związku z przejściem na nową wersję. Listę zmian wprowadzonych w poszczególnych wersjach znajdziesz w informacjach o wersji.
- Wyczyść i utwórz projekt ponownie. W tym celu wybierz Usługa > Wyczyść, a następnie Usługa > Kompilacja
Instalacja ręczna
Podczas instalowania pakietu SDK pobierz link do najnowszych plików źródłowych.
Oprócz sondowania pod kątem 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 rolę właściciela z monitorowanym adresem e-mail na potrzeby każdego projektu.