Pakiet SDK sterownika na iOS

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

Zawsze podawaj 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ść.

CocoaPods

Przykładowa zależność w pliku Podfile z użyciem 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ą menedżera pakietów Swift. Aby dodać pakiet SDK, usuń wszystkie dotychczasowe zależności pakietu Driver SDK.

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-driver-sdk jako adres URL, naciśnij Enter, aby pobrać pakiet, i 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 w pakiecie sprawdź, czy GoogleRidesharingDriver zostanie dodany do wybranego main miejsca docelowego. 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. W Xcode kliknij File > Packages > Update To Latest Package Versions (Plik > Pakiety > Zaktualizuj do najnowszych wersji pakietów).
  2. Aby sprawdzić instalację, otwórz sekcję Zależności pakietu w Nawigatorze projektu, aby sprawdzić pakiet i jego wersję.

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.

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 dostępna jest nowsza wersja pakietu Driver 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 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 > Clean (Produkt > Wyczyść) i Product > Build (Produkt > Skompiluj).

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.