Maps SDK na Androida

Wybierz platformę: Android iOS JavaScript

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.

  • 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.