Zespół Google Maps Platform regularnie aktualizuje pakiety SDK, wprowadzają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 mobilnych pakietów SDK.
Z którą wersją chcesz utworzyć połączenie?
-
W przypadku aplikacji o krytycznym znaczeniu podaj link do najnowszej wersji głównej (X.*) i aktualizuj ją co roku do nowej wersji głównej.
W miarę publikowania nowych wersji aplikacji w ciągu roku możesz zacząć używać nowszych wersji pakietu SDK Map Google na Androida. Nie będzie to wymagać aktualizacji aplikacji, ponieważ nowe wersje są wstecznie kompatybilne.
Korzyści:
- Jeśli w pakiecie Maps SDK na Androida wykryjemy problemy, przez 12 miesięcy od pierwszej publikacji wersji głównej będziemy udostępniać poprawki w sposób zapewniający zgodność wsteczną zgodnie z zasadami pomocy dotyczącej urządzeń mobilnych. Aby korzystać z poprawek, nie musisz pilnie przechodzić na niezgodną wersję pakietu SDK.
- Gdy aplikacja jest już oparta na najnowszej wersji, łatwo jest wdrożyć najnowsze ulepszenia i funkcje.
- Coroczne aktualizacje do najnowszej wersji głównej pakietu SDK mogą wymagać mniej pracy przy dostosowywaniu, przepisywaniu i testowaniu aplikacji niż radzenie sobie ze zmianami, które nie są wstecznie zgodne i zostały wprowadzone w wielu wersjach głównych.
W przypadku aplikacji o mniejszym znaczeniu podaj link do dowolnej stałej wersji. 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 mobilnymi systemami operacyjnymi (do momentu, gdy musisz 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 poszczególne projekty. Bądź na bieżąco z najważniejszymi aktualizacjami, wycofaniami i innymi zmianami.
Instalacja
W pliku build.gradle.kts lub build.gradle na poziomie aplikacji zawsze podawaj wersję zamiast zakresu prefiksów (+) lub latest, ponieważ może to prowadzić do nieprzewidywalnych i niepowtarzalnych kompilacji. Pakiet Maps SDK na Androida jest zgodny z zasadami wersjonowania semantycznego, a nowe wersje główne mogą zawierać zmiany powodujące niezgodność. Minimalny obsługiwany poziom API to 21.
Określanie zależności 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 uaktualnianie
Android Studio automatycznie sprawdza, czy są dostępne nowsze wersje, i wyświetla ostrzeżenie, gdy nowsza wersja zależności jest dostępna. Aby zminimalizować dług techniczny, jak najszybciej zaktualizuj aplikację do najnowszej dostępnej wersji. Jeśli aktualizujesz wersję do nowej wersji głównej, zapoznaj się z informacjami o wersji, aby dowiedzieć się o zmianach, które nie są wstecznie kompatybilne, i o tym, jak zaktualizować kod.
Oprócz sprawdzania, czy są dostępne nowsze wersje, właściciele projektów w Google Cloud otrzymują e-maile z informacjami o zmianach, które nie są wstecznie zgodne i mogą mieć wpływ na ich projekty. Aby otrzymywać proaktywne powiadomienia o zmianach, które nie są wstecznie kompatybilne, przypisz rolę właściciela z monitorowanym adresem e-mail do każdego projektu.