Maps SDK na iOS

Wybierz platformę: Android iOS JavaScript

Zespół Google Maps Platform regularnie aktualizuje pakiety SDK, wprowadzając nowe funkcje, poprawki błędów i ulepszenia wydajności. Na tej stronie znajdziesz wskazówki dotyczące zarządzania zależnościami od mobilnych pakietów SDK.

  • W przypadku aplikacji o krytycznym znaczeniu utwórz link do najnowszej wersji głównej (X.*) i aktualizuj ją co roku do nowej wersji głównej.

    W trakcie roku możesz publikować nowe wersje aplikacji i zacząć używać nowszych wersji pakietu Maps SDK na iOS. Nie będzie to wymagać aktualizacji aplikacji, ponieważ nowe wersje są wstecznie zgodne.

    Korzyści:

    • Jeśli w pakiecie Maps SDK na iOS wykryjemy problemy, przez 12 miesięcy od pierwszej publikacji wersji głównej będziemy udostępniać poprawki w sposób zapewniający zgodność wsteczną, zgodnie z zasadami pomocy dotyczącej urządzeń mobilnych. Aby korzystać z poprawek, nie musisz pilnie przechodzić na niezgodną wersję pakietu SDK.
    • Gdy aplikacja jest już oparta na najnowszej wersji, łatwo jest wdrożyć najnowsze ulepszenia i funkcje.
    • Coroczne aktualizacje do najnowszej głównej wersji pakietu SDK mogą wymagać mniej pracy przy dostosowywaniu, przepisywaniu i testowaniu aplikacji niż obsługa zmian, które nie są wstecznie zgodne i zostały wprowadzone w kilku głównych wersjach.

  • W przypadku aplikacji o mniejszym znaczeniu połącz się z dowolną stałą wersją. Gdy otrzymasz powiadomienie o wycofaniu tej stałej wersji, będziesz mieć 12 miesięcy na udostępnienie użytkownikom zaktualizowanego kodu aplikacji.

    Korzyści:

    • rzadsze prace konserwacyjne,
    • Nowe wersje aplikacji dłużej obsługują urządzenia użytkowników z starszymi mobilnymi systemami operacyjnymi (do momentu, gdy musisz przejść na nową wersję pakietu SDK).

Właściciele projektów z monitorowanymi adresami e-mail otrzymują proaktywne powiadomienia o zmianach, które mają wpływ na poszczególne projekty. Bądź na bieżąco z najważniejszymi aktualizacjami, wycofaniami i innymi zmianami.

Instalacja

Swift Package Manager

Pakiet Maps SDK na iOS można zainstalować za pomocą Swift Package Manager. 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:

  1. Otwórz Xcode project lub workspace, a potem kliknij File > Add Package Dependencies (Plik > Dodaj zależności pakietu).
  2. Wpisz https://github.com/googlemaps/ios-maps-sdk jako adres URL, naciśnij Enter, aby pobrać pakiet, i kliknij „Add Package” (Dodaj pakiet).
  3. Aby zainstalować konkretną version, ustaw w polu Reguła zależności 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”.

Aby zaktualizować package w przypadku istniejącego projektu:

  1. Jeśli uaktualniasz wersję starszą niż 9.0.0, po uaktualnieniu musisz usunąć te zależności: GoogleMapsBase, GoogleMapsCore i GoogleMapsM4B. Nie usuwaj zależności dla GoogleMaps. Więcej informacji znajdziesz w informacjach o wersji 9.0.0.

    W ustawieniach konfiguracji projektu Xcode znajdź Frameworks, Libraries and Embedded Content (Frameworki, biblioteki i treści osadzone). Aby usunąć ten framework, użyj znaku minusa(-):

    • GoogleMapsBase (tylko w przypadku uaktualniania z wersji starszych niż 9.0.0)
    • GoogleMapsCore (tylko w przypadku uaktualniania z wersji starszych niż 9.0.0)
    • GoogleMapsM4B (tylko w przypadku uaktualniania z wersji starszych niż 9.0.0)
  2. W Xcode kliknij „File > Packages > Update To Latest Package Versions” (Plik > Pakiety> Zaktualizuj do najnowszych wersji pakietów).
  3. Aby sprawdzić instalację, otwórz sekcję Zależności pakietu w Nawigatorze projektu, aby sprawdzić pakiet i jego wersję.

Aby usunąć istniejące zależności pakietu Maps SDK na iOS dodane za pomocą polecenia CocoaPods, wykonaj te czynności:

  1. Zamknij obszar roboczy Xcode. Otwórz terminal i uruchom to polecenie: 
    sudo gem install cocoapods-deintegrate cocoapods-clean
pod deintegrate
pod cache clean --all
  2. Usuń Podfile, Podfile.resolved i workspace Xcode, jeśli nie używasz ich do niczego innego niż CocoaPods.

CocoaPods

Zawsze podawaj numer wersji w zależnościach zamiast używać operatora optymistycznego (~>), ponieważ może to prowadzić do nieprzewidywalnych i niepowtarzalnych kompilacji. Pakiet SDK Map na iOS jest zgodny z semantycznym wersjonowaniem, a 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, '16.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GoogleMaps', '10.1.0'
end

Konserwacja i aktualizacja

Aby korzystać z najnowszych ulepszeń, regularnie sprawdzaj, czy są dostępne nowsze wersje, i aktualizuj specyfikacje wersji. Jeśli aktualizujesz pakiet do nowej wersji głównej, zapoznaj się z informacjami o wersji, aby dowiedzieć się o zmianach powodujących niezgodność wsteczną i o tym, jak zaktualizować kod.

Swift Package Manager

Aby zaktualizować package w przypadku istniejącego projektu:

  1. Aby sprawdzić instalację, otwórz sekcję Zależności pakietu w Nawigatorze projektu, aby sprawdzić pakiet i jego wersję.

Cocoapods

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

    cd <path-to-project>
  2. Uruchom polecenie pod outdated, aby sprawdzić, czy jest dostępna nowsza wersja pakietu Maps SDK na iOS.
  3. Jeśli znajdziesz nowszą wersję pakietu SDK, zaktualizuj Podfile do tej nowej wersji. Więcej informacji o ustawianiu konkretnej wersji w pliku Podfile znajdziesz w sekcji Określanie wersji poda.
  4. Uruchom pod update.
  5. Wprowadź niezbędne zmiany w wyniku uaktualnienia. Listę zmian w poszczególnych wersjach znajdziesz w informacjach o wersji.
  6. Wyczyść i ponownie skompiluj projekt, wybierając kolejno Product (Produkt) > Clean (Wyczyść) i Product (Produkt) > Build (Skompiluj).

Instalacja ręczna

Pobierz link do najnowszych plików źródłowych w sekcji Instalowanie pakietu SDK.

Oprócz sprawdzania nowszych wersji właściciele projektów Google Cloud otrzymują e-maile z informacjami o zmianach, które nie są wstecznie kompatybilne i mogą mieć wpływ na ich projekty. Aby otrzymywać proaktywne powiadomienia o zmianach, które nie są wstecznie kompatybilne, przypisz rolę właściciela z monitorowanym adresem e-mail do każdego z projektów.