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 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 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:

  1. Otwórz plik Xcode project lub workspace i kliknij Plik > Dodaj zależności pakietów.
  2. Wpisz URL https://github.com/googlemaps/ios-maps-sdk, naciśnij Enter, by pobrać pakiet, a następnie kliknij „Dodaj pakiet”.
  3. 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”.
  4. W oknie Wybierz produkty w pakiecie sprawdź, czy GoogleMaps, GoogleMapsBase i GoogleMapsCore zostaną dodane do wyznaczonego miejsca docelowego main. Gdy skończysz, kliknij „Dodaj pakiet”.
  5. 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:

  1. W Xcode wybierz kolejno „File” (Plik) > Packages (Pakiety) > Update To Last Package Versions (Aktualizuj do najnowszych wersji pakietów).
  2. 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:

  1. Zamknij obszar roboczy Xcode. Otwórz terminal i wykonaj 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 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, '14.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:

  1. W Xcode wybierz kolejno „File” (Plik) > Packages (Pakiety) > Update To Last Package Versions (Aktualizuj do najnowszych wersji pakietów).
  2. Aby sprawdzić instalację, przejdź do sekcji Zależności pakietów w Project Navigator i sprawdź pakiet i jego wersję.

Kocoapody

  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 znajdziemy nowszą wersję pakietu SDK, zaktualizuj ją do Podfile. W sekcji Określanie wersji podów dowiesz się, jak ustawić konkretną wersję w Podfile.
  4. Uruchom pod update.
  5. 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.
  6. Wyczyść i utwórz projekt ponownie. W tym celu wybierz Usługa > Wyczyść, a następnie Usługa > Kompilacja

Ręczne

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.