Pakiet SDK sterownika na iOS

Zespół Google Maps Platform regularnie aktualizuje pakiety SDK, dodając do nich nowe funkcje, poprawki błędów i ulepszenia wydajności. Na tej stronie znajdziesz wskazówki dotyczące zarządzania zależnościami w pakietach SDK na urządzenia mobilne.

  • W przypadku aplikacji o krytycznym znaczeniu wskaż najnowszą wersję główną (X.*), której używasz, i co roku aktualizuj ją do nowej wersji głównej.

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

    Zalety:

    • 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 pierwszego wydania wersji głównej zgodnie z zasadami pomocy dotyczącej urządzeń mobilnych. Aby skorzystać z poprawek, nie musisz pilnie przejść na niezgodną wersję pakietu SDK.
    • Najnowsze ulepszenia i funkcje można łatwo wdrożyć, jeśli aplikacja jest już utworzona w najnowszej wersji.
    • Coroczne cząstkowe aktualizacje najnowszej głównej wersji pakietu SDK mogą wymagać mniej pracy w zakresie dostosowania, przepisania i testowania aplikacji niż w przypadku obsługi zmian niezgodnych z poprzednimi wersjami wprowadzonych w wielu głównych wersjach.

  • W przypadku aplikacji o mniejszym znaczeniu podaj link do dowolnej wersji z poprawkami. Gdy otrzymasz powiadomienie o wycofaniu poprawionej wersji, masz 12 miesięcy na udostępnienie zaktualizowanego kodu aplikacji użytkownikom.

    Zalety:

    • Rzadsze prace konserwacyjne.
    • Nowe wersje aplikacji będą dłużej obsługiwać urządzenia użytkowników z starszymi mobilnymi systemami operacyjnymi (do momentu przejścia na nowszą wersję pakietu SDK).

Właściciele projektów ze monitorowanymi adresami e-mail otrzymują aktywne powiadomienia o zmianach, które mają wpływ na każdy z ich projektów. Bądź na bieżąco z informacjami o najważniejszych aktualizacjach, wycofanych funkcjach i innych zmianach.

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 obsługą wersji semantycznych, a nowe główne wersje zawierają zmiany powodujące niezgodność.

CocoaPods

Przykład zależności w pliku Podfile przy użyciu składni Podfile:

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

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

Menedżer pakietów Swift

Pakiet SDK kierowcy można zainstalować za pomocą menedżera pakietów Swift. Aby dodać pakiet SDK, usuń wszystkie istniejące zależności pakietu SDK kierowcy.

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

  1. Otwórz project lub workspace Xcode, a następnie wybierz File > Add Package Dependencies (Plik > Dodaj zależności pakietu).
  2. Jako URL wpisz https://github.com/googlemaps/ios-driver-sdk, naciśnij Enter, aby pobrać pakiet, i kliknij „Dodaj pakiet”.
  3. Aby zainstalować określony element version, w polu Reguła zależności ustaw jedną z opcji zależnych od wersji. W przypadku nowych projektów zalecamy określenie najnowszej wersji i użycie opcji „Dokładna wersja”. Gdy skończysz, kliknij „Dodaj pakiet”.

Aby zaktualizować package w istniejącym projekcie:

  1. Aby sprawdzić instalację, otwórz sekcję Zależność pakietu w Nawigatorze projektu, aby zweryfikować pakiet i jego wersję.

Konserwacja i uaktualnienie

Aby korzystać z najnowszych ulepszeń, regularnie sprawdzaj, czy są dostępne nowsze wersje, i aktualizuj specyfikacje wersji. Jeśli aktualizujesz kod do nowej wersji głównej, zapoznaj się z informacjami o wersji, aby poznać niezgodne wstecznie zmiany i dowiedzieć się, jak zaktualizować kod.

Cocoapody

  1. Otwórz terminal i przejdź do katalogu zawierającego Podfile:

    cd <path-to-project>
  2. Uruchom pod outdated, aby sprawdzić, czy dostępna jest nowsza wersja pakietu Driver SDK na iOS.
  3. Jeśli znajdziemy nowszą wersję pakietu SDK, zaktualizuj ją w Podfile. Aby dowiedzieć się, jak ustawić konkretną wersję w Podfile, zapoznaj się z artykułem Określanie wersji podgrup.
  4. Uruchom pod update.
  5. Wprowadź wszelkie niezbędne zmiany w wyniku uaktualnienia. Listę zmian wprowadzonych w każdej wersji znajdziesz w informacjach o wersji.
  6. Oczyść i ponownie skompiluj projekt, wybierając kolejno Produkt > Oczyść i Produkt > Kompiluj.

Instalacja ręczna

Uzyskaj link do najnowszych plików źródłowych podczas instalowania pakietu SDK.

Właściciele projektu Google Cloud nie tylko przeprowadzają ankiety w poszukiwaniu nowszych wersji, ale też otrzymują e-maile dotyczące niezgodnych wstecznie zmian, które mogą mieć wpływ na ich projekty. Aby otrzymywać z wyprzedzeniem powiadomienia o niezgodnych wstecznie zmianach, przypisz rolę właściciela z monitorowanym adresem e-mail dla każdego ze swoich projektów.