Pakiet SDK Miejsc 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 kluczowym znaczeniu utwórz 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 Places SDK na Androida. Nie będzie to wymagać aktualizacji aplikacji, ponieważ nowe wersje są wstecznie zgodne.

    Korzyści:

    • Jeśli w pakiecie Places SDK na Androida wykryjesz problemy, poprawki będą udostępniane w sposób zapewniający zgodność wsteczną przez 12 miesięcy od pierwszej publikacji wersji głównej, zgodnie z zasadami pomocy dotyczącej urządzeń mobilnych. Aby korzystać z poprawek, nie musisz pilnie przechodzić na niekompatybilną wersję pakietu SDK.
    • Gdy aplikacja jest już oparta na najnowszej wersji, łatwo jest wdrożyć najnowsze ulepszenia i funkcje.
    • Coroczne aktualizacje do najnowszej głównej wersji pakietu SDK mogą wymagać mniej pracy przy dostosowywaniu, przepisywaniu i testowaniu aplikacji niż obsługa zmian, które nie są wstecznie zgodne i zostały wprowadzone w wielu głównych wersjach.

  • W przypadku aplikacji o mniejszym znaczeniu połącz się z dowolną stałą wersją. 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 prefiksu (+) lub latest, ponieważ może to prowadzić do nieprzewidywalnych i niepowtarzalnych kompilacji. Pakiet SDK Miejsc na Androida jest zgodny z semantycznym numerowaniem wersji, a nowe wersje główne mogą zawierać zmiany powodujące niezgodność. Minimalny obsługiwany poziom interfejsu API to 24.

dependencies {

    // Places and Maps SDKs
    implementation("com.google.android.libraries.places:places:4.3.1")
}

Konserwacja i aktualizacja

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 dostępności nowszych wersji właściciele projektó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 powodujących brak zgodności wstecznej, przypisz rolę właściciela z monitorowanym adresem e-mail do każdego z projektów.

Jeśli uaktualniasz pakiet SDK Miejsc na Androida z wersji 3.2.0 lub starszej

Przejście na nowy pakiet SDK nie wymaga migracji. Wystarczy, że:

  1. Włącz Places API (nowość) na kluczu interfejsu API używanym w aplikacji. Więcej informacji znajdziesz w artykule Korzystanie z kluczy interfejsu API.

  2. W sekcji dependencies pliku build.gradle na poziomie modułu zaktualizuj zależność places i dodaj zależność kotlin-bom:

      dependencies {
      implementation(platform("org.jetbrains.kotlin:kotlin-bom:1.8.0"))
      implementation 'com.google.android.libraries.places:places:3.5.0'
  }

    Więcej informacji o zależności kotlin-bom znajdziesz w artykule Używanie najnowszej wersji kotlin-stdlib w zależnościach przechodnich.

  3. Zaktualizuj istniejącą aplikację, aby wywoływała nową metodę Places.initializeWithNewPlacesApiEnabled() w celu zainicjowania aplikacji. Więcej informacji znajdziesz w artykule Inicjowanie klienta interfejsu Places API.

Dotychczasowe aplikacje będą nadal działać bez zmian, ale możesz teraz korzystać ze wszystkich nowych funkcji pakietu SDK.