Zespół Google Maps Platform regularnie aktualizuje pakiety SDK, dodając nowe funkcje, poprawki błędów i ulepszenia wydajności. Na tej stronie znajdziesz wskazówki dotyczące zarządzania zależnościami od pakietów SDK na urządzenia mobilne.
Którą wersję połączyć?
-
W przypadku aplikacji o krytycznym znaczeniu połącz się z najnowszą wersją pomocniczą używanej wersji głównej (X.*) i co roku aktualizuj ją do nowej wersji głównej.
W miarę publikowania nowych wersji aplikacji w ciągu roku możesz zacząć używać nowszych wersji pomocniczych pakietu Maps SDK na Androida. Nie będzie to wymagać aktualizacji aplikacji, ponieważ nowe wersje pomocnicze są wstecznie zgodne.
Korzyści:
- Jeśli wykryjesz problemy w pakiecie Maps SDK na Androida, poprawki będą udostępniane w sposób wstecznie zgodny przez 12 miesięcy od pierwszej wersji głównej zgodnie z zasadami pomocy na urządzeniach mobilnych. Aby korzystać z poprawek, nie musisz pilnie aktualizować pakietu SDK do niezgodnej wersji.
- Najnowsze ulepszenia i funkcje można łatwo wdrożyć, gdy aplikacja jest już oparta na najnowszej wersji.
- Coroczne aktualizacje do najnowszej wersji głównej pakietu SDK mogą wymagać mniej pracy przy dostosowywaniu, przepisywaniu i testowaniu aplikacji niż konieczność radzenia sobie ze zmianami, które nie są wstecznie zgodne i zostały wprowadzone w kilku wersjach głównych.
W przypadku aplikacji o mniejszym znaczeniu, połącz się z dowolną stałą wersją. Gdy otrzymasz powiadomienie o wycofaniu tej stałej wersji, będziesz mieć 12 miesięcy na udostępnienie użytkownikom zaktualizowanego kodu aplikacji.
Korzyści:
- Rzadsze prace konserwacyjne.
- Nowe wersje aplikacji dłużej obsługują urządzenia użytkowników z starszymi wersjami mobilnych systemów operacyjnych (do momentu, gdy trzeba będzie przejść na nową wersję pakietu SDK).
Właściciele projektów z monitorowanymi adresami e-mail otrzymują proaktywne powiadomienia o zmianach, które mają wpływ na każdy z ich projektów. Bądź na bieżąco z najważniejszymi aktualizacjami, wycofywaniem funkcji i innymi zmianami.
Instalacja
W pliku build.gradle.kts lub build.gradle na poziomie aplikacji zawsze określaj
wersję zamiast zakresu prefiksów (+) lub latest, ponieważ mogą one prowadzić
do nieprzewidywalnych i niepowtarzalnych kompilacji. Pakiet Maps SDK na Androida jest zgodny z
semantycznym wersjonowaniem, a nowe
wersje główne mogą zawierać zmiany powodujące niezgodność. Minimalny obsługiwany poziom API to 23.
Określanie zależności od Map w Usługach Google Play za pomocą składni Gradle.
dependencies { // Maps SDK for Android implementation(libs.play.services.maps) }
Dodatkowe wskazówki dotyczące zarządzania wersjami usług Google Play.
Konserwacja i aktualizacja
Android Studio automatycznie sprawdza, czy są dostępne nowsze wersje, i wyświetla ostrzeżenie, gdy dostępna jest nowsza wersja zależności. Aby zminimalizować dług techniczny, jak najszybciej zaktualizuj aplikację do najnowszej dostępnej wersji. Jeśli aktualizujesz aplikację do nowej wersji głównej, zapoznaj się z informacjami o wersji aby dowiedzieć się o zmianach powodujących niezgodność i o tym, jak zaktualizować kod.
Oprócz sprawdzania dostępności nowszych wersji właściciele projektów Google Cloud projektów otrzymują e-maile o zmianach powodujących niezgodność wsteczną, które mogą mieć wpływ na ich projekty. Aby otrzymywać proaktywne powiadomienia o zmianach powodujących niezgodność wsteczną, przypisz rolę właściciela do monitorowanego adresu e-mail w każdym ze swoich projektów.