Pakiet SDK sterownika na iOS

Zespół Google Maps Platform regularnie aktualizuje pakiety SDK o 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.

  • 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 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ło aktualizacji 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 przejść na incompatible wersję pakietu SDK.
    • Najnowsze ulepszenia i funkcje można łatwo wdrożyć, jeśli aplikacja jest już utworzona 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 niekrytycznych aplikacji podaj link do dowolnej poprawionej wersji. 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 użytkowników ze starszymi mobilnymi systemami operacyjnymi (dopóki nie trzeba będzie zaktualizować pakietu SDK do nowej wersji).

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

CocoaPods

Przykładowa zależność Podfile wykorzystująca 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, musisz usunąć wszystkie zależności od pakietu Driver SDK.

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”.
  4. W oknie Wybierz produkty w pakiecie sprawdź, czy GoogleRidesharingDriver zostanie dodany do wyznaczonego main celu. Gdy skończysz, kliknij „Dodaj pakiet”.
  5. Aby sprawdzić instalację, przejdź do panelu General środowiska docelowego. W obszarze Frameworks, biblioteki i umieszczona treść powinny być widoczne zainstalowane pakiety. Możesz też wyświetlić sekcję „Zależności pakietów” w „Nawigatorze projektu”, aby sprawdzić pakiet i jego wersję.

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

  1. Jeśli uaktualniasz aplikację z wersji wcześniejszej 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, biblioteki i Embedded Content. Aby usunąć strukturę, użyj znaku minusa(-):

    • 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 wybierz „File > Packages > Update to Latest Package Versions” (Plik > Pakiety> Aktualizuj do najnowszych wersji pakietu).
  3. Aby sprawdzić instalację, przejdź do sekcji Zależności pakietów w narzędziu Project Navigator i sprawdź pakiet i jego wersję.

Aby usunąć istniejące zależności Drive SDK dodane za pomocą CocoaPods, wykonaj te czynności:

  1. Zamknij obszar roboczy Xcode. Otwórz terminal i wykonaj 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 uaktualnienie

Aby kompilować z wykorzystaniem najnowszych ulepszeń, regularnie sprawdzaj dostępność nowszych wersji 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 jest dostępna nowsza wersja pakietu Driver SDK na iOS.
  3. Jeśli zostanie znaleziona nowsza wersja pakietu SDK, zaktualizuj do niej 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. Wyczyść i odbuduj projekt, wybierając Product > Clean (Produkt > Wyczyść), a następnie Product > Build (Produkt > Kompilacja).

Instalacja ręczna

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

Właściciele projektów Google Cloud nie tylko przeprowadzają ankiety, 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.