Maps SDK na iOS

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

1. Otwórz terminal i przejdź do katalogu zawierającego Podfile:

   cd <path-to-project>

2. Uruchom pod outdated, aby sprawdzić, czy jest dostępna nowsza wersja pakietu SDK Map Google na iOS.
3. 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ę w Podfile.
4. Uruchom pod update.
5. Wprowadź wszelkie niezbędne zmiany wynikające z przekształcenia kampanii. Listę zmian wprowadzonych w każdej wersji znajdziesz w informacjach o wersji.
6. 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.