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. Z tej strony dowiesz się, jak zarządzać zależnościami od mobilnych pakietów SDK.

Do której wersji linkować?

• W przypadku aplikacji o kluczowym znaczeniu dodaj link do najnowszej wersji używanej wersji głównej (X.*) i co roku uaktualniaj ją do nowej wersji głównej.

  W trakcie całego roku możesz publikować nowe wersje aplikacji, używając nowszych wersji pakietu Driver SDK na iOS. Nie będzie to wymagać aktualizacji w Twojej aplikacji, ponieważ nowe wersje z kropkami są zgodne wstecznie.

  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 przechodzić na niezgodną wersję pakietu SDK.
  • Najnowsze ulepszenia i funkcje są łatwe do wdrożenia, gdy aplikacja jest już skompilowana w najnowszej wersji.
  • Coroczne aktualizacje przyrostowe do najnowszej głównej wersji pakietu SDK mogą wymagać mniej pracy związanej z adaptacją, przepisywaniem i testowaniem aplikacji niż w przypadku niekompatybilnych wstecznie zmian 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 dłużej będą obsługiwać urządzenia ze starszymi mobilnymi systemami operacyjnymi (dopóki nie trzeba będzie zaktualizować pakietu SDK do nowej wersji).

Właściciele projektów, którzy mają monitorowane adresy e-mail, otrzymują aktywne powiadomienia o zmianach wpływających na ich projekty. Bądź na bieżąco o najważniejszych aktualizacjach, wycofywaniach 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ść.

Uwaga: pakiet SDK kierowcy na iOS nie obsługuje instalacji za pomocą Carthage.

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 Driver SDK możesz zainstalować za pomocą menedżera pakietów Swift. Aby dodać pakiet SDK, usuń wszystkie istniejące zależności pakietu SDK kierowcy.

Ważne: w tych instrukcjach przyjęto założenie, że używany jest Xcode 15 lub nowszy, ale powinno to być podobne w przypadku poprzednich wersji Xcode.

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

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

Ważne: czasami nie można rozwiązać problemu z artefaktami lub mogą wystąpić błędy. W takim przypadku wybierz „Plik > Pakiety > Zresetuj pamięć podręczną pakietu”.

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. Zapoznaj się z sekcją Określanie wersji podów, aby dowiedzieć się, jak ustawić konkretną wersję w narzędziu Podfile.
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ć proaktywne powiadomienia o zmianach niezgodnych ze starszymi wersjami, przypisz rolę właściciela, używając monitorowanego adresu e-mail w każdym z projektów.