Maps SDK na iOS

Wybierz platformę: Android iOS JavaScript

Zespół Google Maps Platform regularnie aktualizuje pakiety SDK, dodają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 pakietów SDK do aplikacji mobilnych.

  • W przypadku aplikacji o kluczowym znaczeniu utwórz link do najnowszej wersji podrzędnej używanej wersji głównej (X.*) i co roku uaktualniaj do nowej wersji głównej.

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

    Zalety:

    • Jeśli wykryjesz problemy z pakietem Maps SDK na iOS, poprawki będą udostępniane w sposób zgodny wstecznie przez 12 miesięcy od pierwszej wersji głównej, zgodnie z zasadami pomocy dotyczącej urządzeń mobilnych. Nie musisz pilnie przechodzić na niezgodną wersję pakietu SDK, aby korzystać z poprawek.
    • Najnowsze ulepszenia i funkcje można łatwo wdrożyć, gdy aplikacja jest już oparta na najnowszej wersji.
    • Coroczne aktualizacje przyrostowe do najnowszej wersji głównej pakietu SDK mogą wymagać mniej pracy związanej z dostosowywaniem, przepisywaniem i testowaniem aplikacji niż obsługa zmian wprowadzonych w kilku wersjach głównych, które nie są zgodne wstecznie.

  • W przypadku aplikacji niekrytycznych podaj link do dowolnej wersji, w której problem został rozwiązany. Gdy otrzymasz powiadomienie o wycofaniu tej wersji, będziesz mieć 12 miesięcy na udostępnienie użytkownikom zaktualizowanego kodu aplikacji.

    Zalety:

    • Rzadsze prace konserwacyjne.
    • Nowe wersje aplikacji będą dłużej obsługiwać urządzenia użytkowników z wcześniejszymi mobilnymi systemami operacyjnymi (do czasu, gdy trzeba będzie 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 ich projekty. Otrzymuj informacje o dużych aktualizacjach, wycofaniach i innych zmianach.

Instalacja

Swift Package Manager

Pakiet Maps SDK na iOS można zainstalować za pomocą Swift Package Managera. Aby dodać pakiet SDK, usuń wszystkie istniejące zależności Maps SDK na iOS.

Aby dodać pakiet SDK do nowego lub istniejącego projektu, wykonaj te czynności:

  1. Otwórz plik project lub workspace w Xcode, a następnie 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ą wersję version, ustaw pole Reguła zależności na 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 Choose Package Products (Wybierz produkty pakietu) sprawdź, czy GoogleMaps (w przypadku wersji starszych niż 9.0.0 sprawdź, czy GoogleMaps, GoogleMapsBase i GoogleMapsCore) zostaną dodane do wyznaczonego celu main. Gdy skończysz, kliknij „Dodaj pakiet”.
  5. Aby sprawdzić instalację, otwórz panel General (Ogólne) celu. Zainstalowane pakiety powinny być widoczne w sekcji Frameworks, Libraries, and Embedded Content (Platformy, biblioteki i treści umieszczone). Możesz też sprawdzić sekcję „Package Dependencies” (Zależności pakietu) w „Project Navigator” (Nawigator projektu), aby zweryfikować pakiet i jego wersję.

Aby zaktualizować package w istniejącym projekcie, wykonaj te czynności:

  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 (Platformy, biblioteki i umieszczone treści). Użyj znaku minus(-), aby usunąć te platformy:

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

Aby usunąć istniejące 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 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 do nowej wersji głównej, sprawdź w informacjach o wersji, czy nie ma zmian, które nie są zgodne wstecznie, i dowiedz się, jak zaktualizować kod.

Swift Package Manager




To update the package for an existing project, follow these steps:


  
    
    
    
    
  1. 
      To verify your installation, go to the Package Dependencies section of Project Navigator
      to verify the package and its version.
    
    2.

Instalacja ręczna

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

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