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

    W miarę publikowania nowych wersji aplikacji w ciągu roku możesz 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 niekompatybilną 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ż obsługa zmian, które nie są wstecznie zgodne i zostały wprowadzone w kilku wersjach głównych.

  • W przypadku aplikacji o mniejszym znaczeniu podaj link do dowolnej poprawionej 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 SDK Map 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, 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”.
  4. W oknie Wybierz produkty pakietu sprawdź, czy do wybranego miejsca docelowego main zostanie dodany element GoogleMaps (w przypadku wersji starszych niż 9.0.0 sprawdź, czy zostaną dodane elementy GoogleMaps, GoogleMapsBase i GoogleMapsCore). Gdy skończysz, kliknij „Dodaj pakiet”.
  5. Aby sprawdzić instalację, otwórz panel Ogólne w przypadku wybranego urządzenia. W sekcji Frameworks, Libraries, and Embedded Content (Frameworki, biblioteki i treści osadzone) powinny być widoczne zainstalowane pakiety. Możesz też sprawdzić pakiet i jego wersję w sekcji „Zależności pakietu” w „Nawigatorze projektu”.

Aby zaktualizować package w przypadku istniejącego projektu:

  1. Jeśli aktualizujesz wersję starszą niż 9.0.0, po aktualizacji 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.

Konserwacja i uaktualnianie

Aby korzystać z najnowszych ulepszeń, regularnie sprawdzaj dostępność nowszych wersji 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ę.

Instalacja ręczna

Link do najnowszych plików źródłowych znajdziesz 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 zgodne i mogą mieć wpływ na ich projekty. Aby otrzymywać proaktywne powiadomienia o zmianach powodujących brak zgodności wstecznej, przypisz rolę właściciela z monitorowanym adresem e-mail do każdego z Twoich projektów.