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 podaj link do najnowszej wersji głównej (X.*) i aktualizuj ją co roku do nowej wersji głównej.

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

    Korzyści:

    • Jeśli w pakiecie Maps SDK na iOS wykryjemy problemy, poprawki będą udostępniane w sposób zapewniający zgodność wsteczną przez 12 miesięcy od pierwszej publikacji wersji głównej 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 wersji głównej pakietu SDK mogą wymagać mniej pracy przy dostosowywaniu, przepisywaniu i testowaniu aplikacji niż radzenie sobie ze zmianami, które nie są wstecznie zgodne i zostały wprowadzone w wielu wersjach głównych.

  • W przypadku aplikacji o mniejszym znaczeniu podaj link do dowolnej stałej wersji. 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 dotychczasowe 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, a następnie 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ę wcześniejszą 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 Xcode workspace, 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 Maps SDK na iOS jest zgodny z semantycznym numerowaniem wersji, a nowe wersje główne zawierają zmiany powodujące niezgodność.

Przykładowa zależność w pliku 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.8.0'
end

Konserwacja i uaktualnianie

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 pod outdated, aby sprawdzić, czy dostępna jest 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 artykule 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 dostępności 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 Twoich projektów.