Pakiet SDK sterownika na iOS

Zespół Google Maps Platform regularnie aktualizuje pakiety SDK o nowe funkcje, poprawki błędów i poprawy wydajności. Na tej stronie znajdziesz wskazówki dotyczące zarządzania zależnościami w przypadku mobilnych pakietów SDK.

  • W przypadku aplikacji o kluczowym znaczeniu podaj najnowszą wersję z kropkami (X.*) i co roku uaktualniać ją 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. Dzięki temu nie wymagają aktualizacji w aplikacji, ponieważ nowe wersje z kropkami są zgodne wstecznie.

    Zalety:

    • Jeśli wykryjesz problemy w pakiecie Driver SDK na iOS, poprawki zostaną udostępnione w wstecznie przez 12 miesięcy od premiery wersji głównej zgodnie z dział pomocy ds. telefonów komórkowych . Nie musisz pilnie przejść na niezgodną wersję pakietu SDK na poprawki.
    • Wdrożenie najnowszych ulepszeń i funkcji jest proste, gdy aplikacja jest już utworzona najnowszą wersję.
    • Coroczne aktualizacje przyrostowe do najnowszej głównej wersji pakietu SDK mogą wymagać mniej pracy adaptacji, przeredagowania i testowania aplikacji, a nie w przypadku braku zgodności wstecznej. zmian wprowadzonych w wielu wersjach głównych.

  • W przypadku niekrytycznych aplikacji podaj link do dowolnej poprawionej wersji. Gdy otrzymujesz informacje o wycofaniu na powiadomienie o naprawionej wersji masz 12 miesięcy na udostępnienie użytkowników.

    Zalety:

    • Rzadsze prace konserwacyjne.
    • Nowe wersje aplikacji w dalszym ciągu obsługują na urządzeniach ze starszymi systemami operacyjnymi mobilnymi systemów uczących się (dopóki nie trzeba będzie uaktualnić pakietu do nowej wersji pakietu SDK).

Właściciele projektu ze monitorowanymi adresami e-mail otrzymują aktywne powiadomienia o zmianach, które na każdy z ich projektów. Zostań aby były na bieżąco z najważniejszymi aktualizacjami, wycofywaniami i innymi zmianami.

Instalacja

Zawsze określaj numer wersji w zależnościach zamiast (~>), ponieważ może to prowadzić do nieprzewidywalnych i gotowe budowle. Pakiet Driver SDK dla systemu iOS jest zgodny z semantycznej obsługi wersji i nowych wersji głównych. uwzględnić zmiany powodujące niezgodność.

Menedżer pakietów Swift

Pakiet Driver SDK można zainstalować za pomocą programu Menedżer pakietów Swift. Aby dodać pakiet SDK, upewnij się, że masz usunięto 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 Xcode project lub workspace i przejdź do File > (Plik >). Dodaj zależności pakietów.
  2. Jako URL wpisz https://github.com/googlemaps/ios-driver-sdk i naciśnij Enter. i pobierz pakiet, a potem kliknij „Dodaj pakiet”.
  3. Aby zainstalować określony element version, w polu Reguła zależności ustaw jedną z z użyciem opcji opartych na wersji. W przypadku nowych projektów zalecamy określenie najnowszej wersji i za pomocą opcji „Dokładna wersja” . Gdy skończysz, kliknij „Dodaj pakiet”.
  4. W oknie Wybierz produkty w pakiecie sprawdź, czy GoogleRidesharingDriver zostanie dodany do wyznaczonej wartości docelowej main. 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ć „Zależności pakietów” w narzędziu „Project Navigator” aby zweryfikować pakiet i jego wersję.

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

  1. W przypadku uaktualnienia z wersji wcześniejszej niż 9.0.0 musisz usunąć te zależności: GoogleMapsBase, GoogleMapsCore oraz GoogleMapsM4B po uaktualnieniu. Nie usuwaj zależności dla GoogleMaps Więcej informacji: Informacje o wersji 9.0.0

    W ustawieniach konfiguracji projektu Xcode znajdź Frameworks, Libraries, i Umieszczone treści. 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” (Plik > >) Pakiety > Zaktualizuj do najnowszych wersji pakietu”.
  3. Aby sprawdzić poprawność instalacji, przejdź do sekcji Zależności pakietów w narzędziu Project Navigator. aby zweryfikować pakiet i jego wersję.
.

Aby usunąć istniejące zależności Driver 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 Kod Xcode workspace, jeśli nie używasz ich do żadnych innych celów niż CocoaPods.

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
    

Konserwacja i uaktualnienie

Aby kompilować z najnowszymi ulepszeniami, regularnie sprawdzaj dostępność nowszych wersji zaktualizować specyfikacje wersji. W przypadku aktualizacji do nowej wersji głównej sprawdź informacje o wersji .

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 Dostępny jest pakiet SDK sterowników na iOS.
  3. Jeśli znajdziemy nowszą wersję pakietu SDK, zaktualizuj ją w Podfile. Zobacz Określanie wersji podów. aby dowiedzieć się, jak ustawić konkretną wersję w: Podfile.
  4. Uruchom pod update.
  5. Wprowadź wszelkie niezbędne zmiany w wyniku uaktualnienia. Zobacz Informacje o wersji, w których znajdziesz listę zmian wprowadzonych w każdej wersji.
  6. Wyczyść i odbuduj projekt, wybierając Produkt > Wyczyść, a potem Produkt > Kompilacja

Ręcznie

Uzyskiwanie linku do najnowszych plików źródłowych podczas instalowania pakietu SDK.

Oprócz odpytywania w poszukiwaniu nowszych wersji Google Cloud projekt właścicieli otrzymują e-maile o niekompatybilnych wstecznie zmianach, które mogą mieć wpływ na ich projekty. Do otrzymywać proaktywne powiadomienia o niekompatybilnych wstecznie zmianach, przypisz rolę właściciela z monitorowanym adresem e-mail każdego z Twoich projektów.