Pakiet SDK Miejsc 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 Places SDK for Android. Nie będzie to wymagało aktualizacji aplikacji, ponieważ nowe wersje są zgodne wstecznie.

    Zalety:

    • Jeśli wykryjesz problemy z pakietem Places SDK for Android, poprawki będą udostępniane w sposób zgodny wstecznie przez 12 miesięcy od początkowej 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 Places SDK for Android jest zgodny z wersjonowaniem semantycznym, a nowe wersje główne mogą zawierać zmiany powodujące błędy. Minimalny obsługiwany poziom interfejsu API to 24.

dependencies {

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

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.

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ść) w kluczu interfejsu API używanym w aplikacji. Więcej informacji znajdziesz w artykule Używanie 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 Places API.

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