Pakiet SDK Miejsc na Androida

Zespół Google Maps Platform regularnie aktualizuje pakiety SDK o nowe funkcje, poprawki błędów i poprawy wydajności. Na tej stronie znajdziesz wskazówki dotyczące zarządzania zależnościami w przypadku mobilnych pakietów SDK.

Którą wersję utworzyć jako link?

• W przypadku aplikacji o kluczowym znaczeniu podaj najnowszą wersję z kropkami (X.*) i co roku uaktualniać 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 Places dla Androida. Dzięki temu nie wymagają aktualizacji w aplikacji, ponieważ nowe wersje z kropkami są zgodne wstecznie.

  Zalety:

  • Jeśli wykryjesz problemy w pakiecie SDK Miejsc dla Androida, poprawki zostaną udostępnione w wstecznie przez 12 miesięcy od premiery wersji głównej zgodnie z dział pomocy ds. telefonów komórkowych . Nie musisz pilnie przejść na niezgodną wersję pakietu SDK na poprawki.
  • Wdrożenie najnowszych ulepszeń i funkcji jest proste, gdy aplikacja jest już utworzona najnowszą wersję.
  • Coroczne aktualizacje przyrostowe do najnowszej głównej wersji pakietu SDK mogą wymagać mniej pracy adaptacji, przeredagowania i testowania aplikacji, a nie w przypadku braku zgodności wstecznej. zmian wprowadzonych w wielu wersjach głównych.

• W przypadku niekrytycznych aplikacji podaj link do dowolnej poprawionej wersji. Gdy otrzymujesz informacje o wycofaniu na powiadomienie o naprawionej wersji masz 12 miesięcy na udostępnienie użytkowników.

  Zalety:

  • Rzadsze prace konserwacyjne.
  • Nowe wersje aplikacji w dalszym ciągu obsługują na urządzeniach ze starszymi systemami operacyjnymi mobilnymi systemów uczących się (dopóki nie trzeba będzie uaktualnić pakietu do nowej wersji pakietu SDK).

Właściciele projektu ze monitorowanymi adresami e-mail otrzymują aktywne powiadomienia o zmianach, które na każdy z ich projektów. Zostań aby były na bieżąco z najważniejszymi aktualizacjami, wycofywaniami i innymi zmianami.

Instalacja

W pliku build.gradle.kts lub build.gradle na poziomie aplikacji zawsze określaj wersję zamiast zakresu prefiksu (+) lub latest, ponieważ mogą one prowadzić po unikalne i nieprzewidywalne budowle. Pakiet SDK Miejsc dla systemu Android jest zgodny z semantycznej obsługi wersji oraz nowych funkcji. wersje główne 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 uaktualnienie

Android Studio automatycznie sprawdza dostępność nowszych wersji i wyświetla ostrzeżenie, dostępna jest nowsza wersja zależności. Aby zminimalizować dług technologiczny, zaktualizuj aplikację do najnowszej wersji jak najszybciej. W przypadku aktualizacji do nowej wersji głównej zapoznaj się z informacjami o wersji .

Oprócz odpytywania w poszukiwaniu nowszych wersji Google Cloud projekt właścicieli witryn otrzymują e-maile o niekompatybilnych wstecznie zmianach, które mogą co ma wpływ na ich projekty. Aby otrzymywać proaktywne powiadomienia o braku zgodności wstecznej zmiany, przypisz rolę właściciela z monitorowanym adresem e-mail każdego z Twoich projektów.

W przypadku aktualizacji z pakietu SDK Miejsc na Androida w wersji 3.2.0 lub starszej

Przy przejściu na nowy pakiet SDK nie jest wymagana migracja. Wystarczy, że:

1. Włącz Places API (nowość) w kluczu interfejsu API używanym w aplikacji. Aby dowiedzieć się więcej, zapoznaj się z informacjami o używaniu kluczy interfejsu API (w języku angielskim).

2. W sekcji dependencies na poziomie modułu build.gradle, 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 tutaj Wykorzystanie najnowszej wersji kotlin-stdlib w zależnościach pośrednich.

3. Zaktualizuj dotychczasową aplikację, aby wywoływała nową Places.initializeWithNewPlacesApiEnabled() zainicjuj aplikację. Więcej informacji: Zainicjuj klienta Places API.

Dotychczasowe aplikacje będą nadal działać bez zmian, ale teraz możesz wykorzystać wszystkie nowe funkcje pakietu SDK.