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 w zakresie wydajności. Na tej stronie znajdziesz wskazówki, jak zarządzać zależnościami od mobilnych pakietów SDK.

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

    W ciągu roku od opublikowania nowych wersji aplikacji możesz zacząć używać nowszych wersji pakietu SDK Map Google na Androida. Nie będzie to wymagało aktualizacji aplikacji, ponieważ nowe wersje z kropkami są zgodne wstecznie.

    Zalety:

    • Jeśli wykryjemy problemy w pakiecie SDK Map Google na Androida, poprawki będą udostępniane w sposób zgodny wstecznie przez 12 miesięcy od pierwszej wersji głównej wersji, zgodnie z zasadami pomocy dotyczącej urządzeń mobilnych. Aby korzystać z poprawek, nie musisz pilnie przechodzić na incompatible wersję pakietu SDK.
    • Najnowsze ulepszenia i funkcje można łatwo wdrożyć, gdy Twoja aplikacja jest już skompilowana w najnowszej wersji.
    • Coroczne aktualizacje przyrostowe najnowszej głównej wersji pakietu SDK mogą wymagać mniej pracy przy adaptacji, przeredagowaniu i przetestowaniu aplikacji niż w przypadku wprowadzania niezgodnych wstecznie zmian wprowadzonych w wielu wersjach głównych.

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

    Zalety:

    • Rzadsze prace konserwacyjne.
    • Nowe wersje Twojej aplikacji przez dłuższy czas obsługują urządzenia użytkowników ze starszymi systemami operacyjnymi na urządzenia mobilne (do momentu uaktualnienia pakietu SDK).

Właściciele projektów z monitorowanymi adresami e-mail otrzymują aktywne powiadomienia o zmianach, które wpływają na ich projekty. Bądź na bieżąco z najważniejszymi aktualizacjami, wycofanymi elementami i innymi zmianami.

Instalacja

W pliku build.gradle na poziomie aplikacji zawsze podawaj wersję zamiast zakresu prefiksu (+) lub latest, ponieważ może to prowadzić do nieprzewidywalnych i unikalnych kompilacji. Pakiet SDK Map Google 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 19.

określać zależność Map w usługach Google Play za pomocą składni Gradle,

dependencies {

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

Więcej informacji znajdziesz w artykule o zarządzaniu obsługą wersji usług Google Play.

Konserwacja i uaktualnianie

Android Studio automatycznie sprawdza dostępność nowszych wersji i wyświetla ostrzeżenie, gdy dostępna jest nowsza wersja zależności. Aby zminimalizować dług technologiczny, jak najszybciej zaktualizuj aplikację do najnowszej dostępnej wersji. Jeśli aktualizujesz nową wersję główną, zapoznaj się z informacjami o wersji i sprawdź, czy nie ma w nich niezgodnych wstecznie zmian oraz sposobu aktualizowania kodu.

Oprócz sondowania w poszukiwaniu nowszych wersji właściciele projektów Google Cloud otrzymują e-maile o niezgodnych wstecznie zmian, które mogą mieć wpływ na ich projekty. Aby otrzymywać z wyprzedzeniem powiadomienia o niezgodnych wstecznie zmian, przypisz do każdego projektu rolę właściciela monitorowanego adresu e-mail.