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.
Którą wersję utworzyć jako link?
-
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ść.
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ż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:
-
Otwórz Xcode
project
lubworkspace
i przejdź do File > (Plik >). Dodaj zależności pakietów. - Jako URL wpisz https://github.com/googlemaps/ios-driver-sdk i naciśnij Enter. i pobierz pakiet, a potem kliknij „Dodaj pakiet”.
-
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”. -
W oknie Wybierz produkty w pakiecie sprawdź, czy
GoogleRidesharingDriver
zostanie dodany do wyznaczonej wartości docelowejmain
. Gdy skończysz, kliknij „Dodaj pakiet”. -
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:
W przypadku uaktualnienia z wersji wcześniejszej niż 9.0.0 musisz usunąć te zależności:
GoogleMapsBase
,GoogleMapsCore
orazGoogleMapsM4B
po uaktualnieniu. Nie usuwaj zależności dlaGoogleMaps
Więcej informacji: Informacje o wersji 9.0.0W 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)
- W Xcode wybierz „File” (Plik > >) Pakiety > Zaktualizuj do najnowszych wersji pakietu”.
- 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:
- Zamknij obszar roboczy Xcode. Otwórz terminal i wykonaj to polecenie:
sudo gem install cocoapods-deintegrate cocoapods-clean pod deintegrate pod cache clean --all
-
Usuń
Podfile
,Podfile.resolved
i Kod Xcodeworkspace
, jeśli nie używasz ich do żadnych innych celów niż CocoaPods.
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
-
Otwórz terminal i przejdź do katalogu zawierającego
Podfile
:cd <path-to-project>
- Uruchom
pod outdated
, aby sprawdzić, czy dostępna jest nowsza wersja Dostępny jest pakiet SDK sterowników na iOS. - 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
. - Uruchom
pod update
. - Wprowadź wszelkie niezbędne zmiany w wyniku uaktualnienia. Zobacz Informacje o wersji, w których znajdziesz listę zmian wprowadzonych w każdej wersji.
- Wyczyść i odbuduj projekt, wybierając Produkt > Wyczyść, a potem Produkt > Kompilacja
Instalacja ręczna
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.