Maps SDK na iOS

Wybierz platformę: Android iOS JavaScript

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.

  • 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.