Maps SDK na Androida

Wybierz platformę: Android iOS JavaScript

Zespół Google Maps Platform regularnie aktualizuje pakiety SDK o nowe funkcje, poprawki błędów i ulepszenia wydajności. Z tej strony dowiesz się, jak zarządzać zależnościami od mobilnych pakietów SDK.

  • W przypadku aplikacji o kluczowym znaczeniu dodaj link do najnowszej wersji używanej wersji głównej (X.*) i co roku uaktualniaj ją do nowej wersji głównej.

    W miarę publikowania nowych wersji aplikacji w ciągu roku możesz zacząć korzystać z nowszych wersji pakietu SDK Maps na Androida. Nie będzie to wymagało aktualizacji Twojej aplikacji, ponieważ nowe wersje z kropkami są zgodne wstecznie.

    Zalety:

    • Jeśli odkryjesz problemy w pakiecie Maps SDK na Androida, poprawki będą udostępniane w sposób zapewniający zgodność wsteczną przez 12 miesięcy od pierwszego wydania wersji głównej, zgodnie z zasadami pomocy dotyczącej urządzeń mobilnych. Aby skorzystać z poprawek, nie musisz pilnie przejść na incompatible wersję pakietu SDK.
    • Najnowsze ulepszenia i funkcje można łatwo wdrożyć, jeśli aplikacja jest już utworzona w najnowszej wersji.
    • Coroczne aktualizacje przyrostowe do najnowszej głównej wersji pakietu SDK mogą wymagać mniej pracy związanej z adaptacją, przepisywaniem i testowaniem aplikacji niż w przypadku niekompatybilnych wstecznie zmian wprowadzonych w wielu głównych wersjach.

  • W przypadku niekrytycznych aplikacji podaj link do dowolnej poprawionej wersji. Gdy otrzymasz powiadomienie o wycofaniu poprawionej wersji, masz 12 miesięcy na udostępnienie zaktualizowanego kodu aplikacji użytkownikom.

    Zalety:

    • Rzadsze prace konserwacyjne.
    • Nowe wersje aplikacji dłużej będą obsługiwać urządzenia użytkowników ze starszymi mobilnymi systemami operacyjnymi (dopóki nie trzeba będzie zaktualizować pakietu SDK do nowej wersji).

Właściciele projektów ze monitorowanymi adresami e-mail otrzymują aktywne powiadomienia o zmianach, które mają wpływ na każdy z ich projektów. Bądź na bieżąco o najważniejszych aktualizacjach, wycofywaniach i innych zmianach.

Instalacja

W pliku build.gradle na poziomie aplikacji zawsze określaj 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 semantyczną obsługą wersji, a nowe główne wersje mogą zawierać zmiany powodujące niezgodność. Minimalny obsługiwany poziom interfejsu API to 21.

Określ zależność Map w Usługach Google Play przy użyciu składni Gradle.

dependencies {

    // Maps SDK for Android
    implementation 'com.google.android.gms:play-services-maps:19.0.0'
}

Zapoznaj się z dodatkowymi wskazówkami dotyczącymi zarządzania wersjami usług Google Play.

Konserwacja i uaktualnienie

Android Studio automatycznie sprawdza dostępność nowszych wersji i wyświetla ostrzeżenie, gdy dostępna jest nowsza wersja zależności. Aby zminimalizować braki techniczne, jak najszybciej zaktualizuj je do najnowszej dostępnej wersji. Jeśli aktualizujesz wersję główną do nowej wersji głównej, zapoznaj się z informacjami o wersji, aby poznać niezgodne wstecznie zmiany i dowiedzieć się, jak zaktualizować kod.

Właściciele projektu Google Cloud nie tylko przeprowadzają ankiety w poszukiwaniu nowszych wersji, ale też otrzymują e-maile dotyczące niezgodnych wstecznie zmian, które mogą mieć wpływ na ich projekty. Aby otrzymywać proaktywne powiadomienia o niezgodnych wstecznie zmianach, przypisz rolę właściciela z monitorowanym adresem e-mail dla każdego ze swoich projektów.