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:
- Włącz Places API (Nowy) w przypadku klucza API używanego w aplikacji. Więcej informacji znajdziesz w artykule Korzystanie z kluczy API.
W sekcji
dependencies
plikubuild.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.- 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.