Maps SDK na Androida

Wybierz platformę: Android iOS JavaScript

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 do aplikacji mobilnych.

  • W przypadku aplikacji o kluczowym znaczeniu utwórz link do najnowszej wersji podrzędnej używanej wersji głównej (X.*) i co roku uaktualniaj do nowej wersji głównej.

    W ciągu roku, gdy będziesz publikować nowe wersje aplikacji, możesz zacząć używać nowszych wersji pakietu Maps SDK na Androida. Nie będzie to wymagało aktualizacji aplikacji, ponieważ nowe wersje są zgodne wstecznie.

    Zalety:

    • Jeśli wykryjesz problemy z pakietem Maps SDK na Androida, poprawki będą udostępniane w sposób zgodny wstecznie przez 12 miesięcy od pierwszej wersji głównej, zgodnie z zasadami pomocy dotyczącej urządzeń mobilnych. Nie musisz pilnie przechodzić na niezgodną wersję pakietu SDK, aby korzystać z poprawek.
    • Najnowsze ulepszenia i funkcje można łatwo wdrożyć, gdy aplikacja jest już oparta na najnowszej wersji.
    • Coroczne aktualizacje przyrostowe do najnowszej wersji głównej pakietu SDK mogą wymagać mniej pracy związanej z dostosowywaniem, przepisywaniem i testowaniem aplikacji niż obsługa zmian wprowadzonych w kilku wersjach głównych, które nie są zgodne wstecznie.

  • W przypadku aplikacji niekrytycznych podaj link do dowolnej wersji, w której problem został rozwiązany. Gdy otrzymasz powiadomienie o wycofaniu tej wersji, będziesz mieć 12 miesięcy na udostępnienie użytkownikom zaktualizowanego kodu aplikacji.

    Zalety:

    • Rzadsze prace konserwacyjne.
    • Nowe wersje aplikacji będą dłużej obsługiwać urządzenia użytkowników z wcześniejszymi mobilnymi systemami operacyjnymi (do czasu, 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 ich projekty. Otrzymuj informacje o dużych aktualizacjach, wycofaniach i innych zmianach.

Instalacja

W pliku build.gradle.kts lub build.gradle na poziomie aplikacji zawsze podawaj wersję, a nie zakres prefiksów (+) lub latest, ponieważ może to prowadzić do nieprzewidywalnych i niepowtarzalnych kompilacji. Pakiet Maps SDK na Androida jest zgodny z wersjonowaniem semantycznym, a nowe wersje główne mogą zawierać zmiany powodujące błędy. Minimalny obsługiwany poziom interfejsu API to 23.

Określ zależność Map w usługach Google Play, używając składni Gradle:

dependencies {

    // Maps SDK for Android
    implementation(libs.play.services.maps)
}

Zapoznaj się z dodatkowymi wskazówkami dotyczącymi 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 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 do nowej wersji głównej, sprawdź informacje o wersji, aby dowiedzieć się, jakie zmiany są niezgodne wstecznie i jak zaktualizować kod.

Oprócz sprawdzania, czy są dostępne nowsze wersje, właściciele projektów Google Cloud otrzymują e-maile o zmianach, które nie są zgodne wstecznie i mogą mieć wpływ na ich projekty. Aby otrzymywać proaktywne powiadomienia o zmianach, które mają brak zgodności wstecznej, przypisz rolę właściciela z monitorowanym adresem e-mail do każdego ze swoich projektów.