Pakiet SDK Miejsc na Androida

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 w przypadku mobilnych pakietów SDK.

Którą wersję utworzyć jako link?

• W przypadku aplikacji o krytycznym znaczeniu podaj link do najnowszej wersji głównej (X.*), z której korzystasz, i co roku aktualizuj 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. Nie będzie to wymagać aktualizacji aplikacji, ponieważ nowe wersje dot są wstecznie kompatybilne.

  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. komórek . Nie musisz pilnie przejść na niezgodną wersję pakietu SDK na poprawki.
  • Najnowsze ulepszenia i funkcje są łatwe do wdrożenia, gdy aplikacja jest już skompilowana w najnowszej wersji.
  • Coroczne cząstkowe aktualizacje najnowszej głównej wersji pakietu SDK mogą wymagać mniej pracy w zakresie dostosowania, przepisania i testowania aplikacji niż w przypadku wprowadzania zmian nieobsługiwanych w poprzednich wersjach w ramach kolejnych głównych wersji.

• W przypadku aplikacji o mniejszym znaczeniu podaj link do dowolnej wersji z poprawkami. 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 projektów, którzy mają monitorowane adresy e-mail, otrzymują proaktywne powiadomienia o zmianach wpływających 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 prefiksów (+) lub latest, ponieważ mogą one prowadzić do nieprzewidywalnych i niepowtarzalnych kompilacji. Pakiet SDK Miejsca na Androida jest zgodny z semantycznym numerowaniem wersji, a nowe wersje główne mogą zawierać zmiany powodujące przerwanie działania. Minimalny obsługiwany poziom interfejsu API to 23.

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ć zaległości techniczne, jak najszybciej zaktualizuj środowisko wykonawcze do najnowszej wersji. Jeśli aktualizujesz do nowej głównej wersji, sprawdź informacje o wersji, aby poznać zmiany niezgodne z poprzednimi wersjami i sposób aktualizacji kodu.

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.

Jeśli przechodzisz 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 (Nowy) w przypadku klucza API używanego w aplikacji. Więcej informacji znajdziesz w artykule Korzystanie z kluczy 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 biernych.

3. Zaktualizuj istniejącą 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.