Pakiet SDK Miejsc na Androida

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

Którą wersję chcesz połączyć?

• W przypadku aplikacji o kluczowym znaczeniu podaj link do najnowszej wersji z kropką używanej 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 w aplikacji, ponieważ nowe wersje z kropką są zgodne wstecznie.

  Zalety:

  • Jeśli zauważysz problemy w pakiecie SDK Miejsc na Androida, poprawki zostaną udostępnione w sposób zgodny wstecznie przez 12 miesięcy od pierwszego wydania wersji głównej, zgodnie z zasadami pomocy dotyczącej urządzeń mobilnych. Nie musisz pilnie przechodzić na incompatible wersję pakietu SDK, aby korzystać z poprawek.
  • Najnowsze ulepszenia i funkcje można łatwo wdrożyć, jeśli Twoja aplikacja zawiera już najnowszą wersję.
  • Coroczne aktualizacje przyrostowe najnowszej głównej wersji pakietu SDK mogą wymagać mniej pracy przy dostosowywaniu, przeredagowaniu i testowaniu aplikacji niż w przypadku obsługi niekompatybilnych 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 użytkownikom zaktualizowanego kodu aplikacji.

  Zalety:

  • Rzadsze prace konserwacyjne.
  • Nowe wersje Twojej aplikacji przez dłuższy czas umożliwiają obsługę urządzeń ze starszymi systemami operacyjnymi na urządzenia mobilne (aż do momentu uaktualnienia pakietu SDK).

Właściciele projektów, którzy mają monitorowane adresy e-mail, otrzymują aktywne powiadomienia o zmianach, które wpływają na ich projekty. Bądź na bieżąco z głównymi aktualizacjami, wycofywaniami i innymi zmianami.

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 SDK Miejsc 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.

dependencies {
    // If updating kotlin-bom version number above, also edit project-level build.gradle definition of $kotlin_version variable
    implementation(platform("org.jetbrains.kotlin:kotlin-bom:$kotlin_version"))
    implementation 'com.google.android.libraries.places:places:3.3.0'
}

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 dostęp do najnowszej wersji. Jeśli aktualizujesz nową wersję główną, sprawdź informacje o wersji, by dowiedzieć się, czy zmiany są niezgodne wstecznie, i jak zaktualizować kod.

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ć aktywne powiadomienia o niezgodnych wstecznie zmian, przypisz rolę właściciela z monitorowanym adresem e-mail na potrzeby każdego projektu.

Jeśli aktualizujesz pakiet Places SDK na Androida w wersji 3.2.0 lub starszej

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

1. Włącz interfejs Places API (nowość) w kluczu interfejsu API używanym w Twojej aplikacji. Więcej informacji znajdziesz w artykule o używaniu 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.3.0'
     }

   Więcej informacji na temat zależności kotlin-bom znajdziesz w artykule o używaniu 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.

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