Pakiet SDK sterownika na iOS

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 na urządzenia mobilne.

Którą wersję połączyć?

• W przypadku aplikacji o krytycznym znaczeniu połącz się z najnowszą wersją główną, której używasz (X.*), i co roku przechodź na nową wersję główną.

  W miarę publikowania nowych wersji aplikacji w ciągu roku możesz zacząć używać nowszych wersji pakietu Driver SDK na iOS. Nie będzie to wymagać aktualizacji aplikacji, ponieważ nowe wersje są wstecznie zgodne.

  Korzyści:

  • Jeśli wykryjesz problemy w pakiecie Driver SDK na iOS, poprawki będą udostępniane w sposób wstecznie zgodny przez 12 miesięcy od pierwszej wersji głównej zgodnie z zasadami pomocy na urządzeniach mobilnych. Aby korzystać z poprawek, nie musisz pilnie przechodzić na niezgodną wersję pakietu SDK aby korzystać z poprawek.
  • Najnowsze ulepszenia i funkcje można łatwo wdrożyć, jeśli aplikacja jest już oparta na najnowszej wersji.
  • Coroczne aktualizacje do najnowszej wersji głównej pakietu SDK mogą wymagać mniej pracy przy dostosowywaniu, przepisywaniu i testowaniu aplikacji niż konieczność radzenia sobie ze zmianami, które nie są wstecznie zgodne i zostały wprowadzone w kilku wersjach głównych.

• 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 wersjami mobilnych systemów operacyjnych (do momentu, gdy trzeba będzie przejść na nową wersję pakietu SDK).

Właściciele projektów, którzy mają monitorowane adresy e-mail, otrzymują proaktywne powiadomienia o zmianach wpływających na każdy z ich projektów. Bądź na bieżąco z najważniejszymi aktualizacjami, wycofywaniem funkcji i innymi zmianami.

Instalacja

Zawsze określaj numer wersji w zależnościach zamiast używać operatora optymistycznego (~>), ponieważ może to prowadzić do nieprzewidywalnych i niepowtarzalnych kompilacji. Pakiet Driver SDK na iOS jest zgodny z wersjonowaniem semantycznym, a nowe wersje główne zawierają zmiany powodujące niezgodność.

**Uwaga:** pakiet Driver SDK na iOS nie obsługuje instalacji za pomocą narzędzia Carthage.

CocoaPods

Przykład zależności Podfile używającej składni Podfile:

      source "https://github.com/CocoaPods/Specs.git"

      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver', '2.0.0'
      end
    

Swift Package Manager

Pakiet Driver SDK można zainstalować za pomocą narzędzia Swift Package Manager. Aby dodać pakiet SDK, upewnij się, że usunięto wszystkie dotychczasowe zależności pakietu Driver SDK.

Aby dodać pakiet SDK do nowego lub istniejącego projektu:

1. Otwórz project lub workspace Xcode, a następnie kliknij File > Add Package Dependencies.
2. Wpisz https://github.com/googlemaps/ios-driver-sdk jako adres URL, naciśnij Enter , aby pobrać pakiet, a następnie kliknij „Add Package” (Dodaj pakiet).
3. Aby zainstalować konkretną version, ustaw pole Dependency Rule na jedną z opcji opartych na wersji. W przypadku nowych projektów zalecamy określenie najnowszej wersji i użycie opcji „Exact Version” (Dokładna wersja). Gdy skończysz, kliknij „Add Package” (Dodaj pakiet).

Aby zaktualizować package w istniejącym projekcie:

1. Aby sprawdzić instalację, otwórz sekcję Package Dependencies (Zależności pakietu) w Project Navigator (Nawigator projektu) i sprawdź pakiet oraz jego wersję.

Ważne: czasami nie można rozwiązać artefaktów lub mogą wystąpić błędy. W takim przypadku wybierz „File > Packages > Reset Package Cache” (Plik > Pakiety > Zresetuj pamięć podręczną pakietu).

Konserwacja i aktualizacja

Aby korzystać z najnowszych ulepszeń, regularnie sprawdzaj dostępność nowszych wersji i aktualizuj specyfikacje wersji. Jeśli przechodzisz na nową wersję główną, sprawdź informacje o wersji aby dowiedzieć się, jakie zmiany powodują niezgodność i jak zaktualizować kod.

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 Driver SDK na iOS.
3. Jeśli znajdziesz nowszą wersję pakietu SDK, zaktualizuj plik Podfile do tej nowej wersji. Więcej informacji o tym, jak ustawić konkretną wersję w pliku Podfile, znajdziesz w artykule Określanie wersji podów.
4. Uruchom polecenie pod update.
5. Wprowadź wszelkie niezbędne zmiany wynikające z aktualizacji. Listę zmian w każdej wersji znajdziesz w informacjach o wersji.
6. Wyczyść i ponownie skompiluj projekt, klikając kolejno Product > Clean i następnie Product > Build.

Instalacja ręczna

Link do najnowszych plików źródłowych znajdziesz w artykule Instalowanie pakietu SDK.

Oprócz sprawdzania dostępności nowszych wersji właściciele projektów Google Cloud projektów otrzymują e-maile o zmianach powodujących niezgodność, które mogą mieć wpływ na ich projekty. Aby otrzymywać proaktywne powiadomienia o zmianach powodujących niezgodność, przypisz rolę właściciela do monitorowanego adresu e-mail w każdym projekcie.