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 na urządzenia mobilne.

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

W przypadku aplikacji o krytycznym znaczeniu połącz się z najnowszą wersją główną, której używasz (X.*), i co roku przechodź na nową wersję główną.

W miarę publikowania nowych wersji aplikacji w ciągu roku możesz zacząć używać nowszych wersji pakietu SDK Miejsc na Androida. Nie będzie to wymagać aktualizacji aplikacji, ponieważ nowe wersje są wstecznie zgodne.

Korzyści:
- Jeśli wykryjesz problemy w pakiecie SDK Miejsc na Androida, poprawki będą udostępniane w sposób wstecznie zgodny przez 12 miesięcy od pierwszej wersji głównej zgodnie z zasadami pomocy na urządzeniach mobilnych. Aby skorzystać z poprawek, nie musisz pilnie przechodzić na niezgodną wersję pakietu SDK aby skorzystać z poprawek.
- Najnowsze ulepszenia i funkcje można łatwo wdrożyć, gdy aplikacja jest już oparta na najnowszej wersji.
- Coroczne aktualizacje do najnowszej wersji głównej pakietu SDK mogą wymagać mniej pracy przy dostosowywaniu, przepisywaniu i testowaniu aplikacji niż w przypadku konieczności obsługi zmian niezgodnych wstecznie wprowadzonych w kilku wersjach głównych.
W przypadku aplikacji niekrytycznych połącz się z dowolną stałą wersją. Gdy otrzymasz powiadomienie o wycofaniu tej stałej wersji, będziesz mieć 12 miesięcy na udostępnienie użytkownikom zaktualizowanego kodu aplikacji.

Korzyści:
- Rzadsze prace konserwacyjne.
- Nowe wersje aplikacji dłużej obsługują urządzenia użytkowników z starszymi wersjami mobilnych systemów operacyjnych (do momentu, 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 każdy z ich projektów. Bądź na bieżąco z ważnymi aktualizacjami, wycofywaniem funkcji 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 Miejsc na Androida jest zgodny z semantycznym wersjonowaniem, a nowe wersje główne mogą zawierać zmiany powodujące niezgodność. Minimalny obsługiwany poziom interfejsu API to 24.

dependencies {

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

Konserwacja i aktualizacja

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 aplikację do nowej wersji głównej, sprawdź informacje o wersji aby dowiedzieć się o zmianach powodujących niezgodność wsteczną i o tym, jak zaktualizować kod.

Oprócz sprawdzania nowszych wersji właściciele projektów Google Cloud projektów otrzymują e-maile o zmianach powodujących niezgodność wsteczną, które mogą mieć wpływ na ich projekty. Aby otrzymywać proaktywne powiadomienia o zmianach powodujących niezgodność wsteczną, przypisz rolę właściciela do monitorowanego adresu e-mail w każdym projekcie.

Jeśli aktualizujesz pakiet SDK Miejsc na Androida z wersji 3.2.0 lub starszej

W przypadku przejścia na nowy pakiet SDK nie jest konieczna migracja. Musisz tylko:

Włącz Places API (nowość) w kluczu interfejsu API używanym w aplikacji. Więcej informacji znajdziesz w artykule Używanie kluczy interfejsu API.
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.
Zaktualizuj dotychczasową aplikację, aby wywoływała nową Places.initializeWithNewPlacesApiEnabled() metodę w celu zainicjowania aplikacji. Więcej informacji znajdziesz w artykule Inicjowanie klienta Places API.

Dotychczasowe aplikacje nadal działają bez zmian, ale możesz teraz korzystać ze wszystkich nowych funkcji pakietu SDK.