Zasady dotyczące obsługi wersji mobilnych systemów operacyjnych
W miarę rozwoju mobilnych systemów operacyjnych oraz wprowadzania przez nas funkcji i aktualizacji Google Maps Platform przestajemy obsługiwać starsze wersje mobilnych systemów operacyjnych.
Wstrzymanie obsługi wersji pakietu SDK Google Maps Platform w przypadku określonych wersji Androida i iOS pomaga Google w testowaniu pakietu SDK i jego skalowaniu.
W tej sekcji opisujemy zasady pomocy Google Maps Platform dotyczące platform mobilnych. Te zasady obejmują tylko produkty ogólnie dostępne.
Wstrzymanie obsługi systemu operacyjnego nie jest objęte 12-miesięcznym okresem wypowiedzenia w przypadku wycofania usług, zgodnie z Warunkami korzystania z Google Maps Platform.
Właściciele projektów 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 usług i innymi zmianami.
Terminologia
Podsumowanie tabeli obsługi minimalnej wersji systemu operacyjnego Android
| Najnowsza wersja pakietu SDK, która jest kompilowana z tą wersją systemu operacyjnego (data wydania) | ||||||
|---|---|---|---|---|---|---|
| Wersja Androida | Maps SDK (biblioteka klienta) | Nav SDK | Places SDK | Driver SDK | Consumer SDK | |
| Android Nougat – poziom interfejsu API 24 (2016) | Najnowsze | Najnowsze | Najnowsze | Najnowsze | Najnowsze | |
| Android Marshmallow – poziom interfejsu API 23 (2015) | Najnowsze | 6.3 (18.06.2025) | 4.4.1 (6.07.2025) | 6.2 (18.06.2025) | Najnowsze | |
| Android Lollipop – poziom interfejsu API 21 (2014) | 19.2.0 (14.04.2025) | 4.99 (6.07.2023) | 3.5.0 (28.05.2024) | 4.99 (9.08.2023) | 1.99.1 (31.08.2023) | |
| Android KitKat – poziom interfejsu API 19 (2013) | 18.2 (18.10.2023) | 3.2 (7.10.2021) | 2.7.0 (1.11.2021) | 3.0.4 (28.07.2021) | 0.9.28 (18.05.2021) | |
Podsumowanie tabeli obsługi minimalnej wersji systemu operacyjnego iOS
| Najnowsza wersja pakietu SDK, która jest kompilowana z tą wersją systemu operacyjnego (data wydania) | ||||
|---|---|---|---|---|
| Wersja iOS | Maps &Nav SDK | Places SDK | Consumer and Driver SDK | |
| 16 (2022) i nowsze | Najnowsze | Najnowsze | Najnowsze | |
| 15 (2021) | 9.4 (18.03.2025) | 9.4 (10.03.2025) | 9.2.1 (28.03.2025) | |
| 14 (2020) | 8.5 (1.04.2024) | 8.5 (1.04.2024) | 3.3.0 (6.03.2024) | |
| 13 (2019) | 7.4 (27.02.2023) | 7.4 (27.02.2023) | 2.2.1 (17.04.2023) | |
| 12 (2018) | 6.2 (25.04.2022) | 6.2 (25.04.2022) | ||
Zasady dotyczące obsługi systemu operacyjnego Android
Nowe wersje pakietów SDK Google Maps Platform na Androida obsługują wersję systemu operacyjnego Android (poziom interfejsu API np. 29 i 30) przez co najmniej 6 lat od początkowego wydania tej wersji systemu operacyjnego. Wstrzymanie obsługi systemu operacyjnego można wprowadzić bez zwiększania numeru wersji głównej.
Na przykład w przypadku wersji Androida wydanej w 2020 roku nowe wersje pakietu Places SDK na Androida będą obsługiwać tę wersję co najmniej do 2026 roku.
Co jakiś czas, gdy korzystanie z systemu operacyjnego Android w wersji co najmniej 6-letniej wystarczająco się zmniejszy:
-
Google wstrzyma obsługę tej wersji Androida, co spowoduje, że w nowych wersjach pakietów SDK na Androida minimalną obsługiwaną wersją systemu operacyjnego będzie wersja o 1 wyższa.
-
W konsekwencji musisz zdecydować, czy:
- zastosować najnowszą wersję pakietu SDK i zwiększyć minimalną obsługiwaną wersję systemu operacyjnego w nowych wersjach aplikacji oraz odpowiednio określić wersje zależności kompilacji;
- czy pozostać przy poprzedniej wersji pakietu SDK, co może ograniczyć możliwość otrzymywania poprawek błędów w sposób zgodny wstecznie zgodnie z sekcją Obsługa pakietu SDK.
Na przykład Google może wstrzymać obsługę Androida 7 (poziom interfejsu API 25, wydany w 2016 roku), co spowoduje, że Android 8 (poziom interfejsu API 26) będzie minimalną obsługiwaną wersją systemu operacyjnego w nowych wersjach pakietów SDK Google Maps Platform na Androida. Wersje aplikacji utworzone za pomocą wcześniejszych wersji pakietu SDK będą nadal działać na urządzeniach z Androidem 7, a wersje aplikacji utworzone za pomocą wersji pakietu SDK wydanych po tym momencie nie będą mogły działać na urządzeniach z Androidem 7.
Wyjątkiem od harmonogramu wstrzymania obsługi wersji systemu operacyjnego jest Maps SDK na Androida, który jest dostarczany w ramach Usług Google Play.
Maps SDK na Androida
Maps SDK na Androida nie jest objęty tymi zasadami dotyczącymi obsługi wersji systemu operacyjnego. Środowisko wykonawcze Maps SDK na Androida jest częścią Usług Google Play (znanych też jako "Usługi mobilne Google" lub "GMS Core"), które są wymagane do uruchamiania aplikacji Google na urządzeniach z Androidem. Ponieważ Usługi Google Play mają własny harmonogram obsługi poziomu interfejsu API Androida (co ilustruje to ogłoszenie), harmonogram obsługi Maps SDK na Androida zależy od obsługi systemu operacyjnego przez Usługi Google Play. Informacje o tym, na których wersjach interfejsu API Androida działają Usługi Google Play, znajdziesz w artykule Konfigurowanie Usług Google Play.
Biblioteka klienta Maps SDK na Androida (fasada interfejsu API), która współpracuje z środowiskiem wykonawczym map w Usługach Google Play, jest jednak wersjonowana i obsługiwana na określonych poziomach interfejsu API Androida zgodnie z zasadami dotyczącymi obsługi systemu operacyjnego Android. Podczas tworzenia aplikacji za pomocą Maps SDK na Androida deweloperzy ustawiają wersję biblioteki klienta jako zależność.
Jeśli aplikacja używa nowszej wersji biblioteki klienta, ale jest uruchamiana na urządzeniu ze starszą wersją Usług Google Play, żadne nowsze funkcje nie będą działać na tych urządzeniach. Nie występują żadne awarie ani wyjątki aplikacji.
Co jakiś czas Usługi Google Play mogą ograniczyć udostępnianie aplikacji utworzonych za pomocą starszych wersji biblioteki klienta (fasady interfejsu API). W takim przypadku podczas publikowania aplikacji w Sklepie Play otrzymasz ostrzeżenie i możesz zostać zablokowany przed publikowaniem kolejnych wersji, dopóki nie zaktualizujesz biblioteki. Więcej informacji znajdziesz w Centrum pomocy Konsoli Play.
Więcej informacji o wersjach Androida znajdziesz w artykule Wersje platformy Android SDK.
Zasady dotyczące obsługi iOS
Nowe wersje pakietów SDK Google Maps Platform na iOS obsługują wersję iOS przez co najmniej 3 lata od początkowego wydania tej wersji systemu operacyjnego. Wstrzymanie obsługi systemu operacyjnego można wprowadzić bez zwiększania numeru wersji głównej. Przykłady znajdziesz w zasadach dotyczących obsługi systemu operacyjnego Android.
Obsługa pakietu SDK
Gdy Google opublikuje nową wersję pakietu SDK Google Maps Platform na urządzenia mobilne:
- Google przetestowało tę wersję na wersjach systemu operacyjnego aż do podanej minimalnej obsługiwanej wersji systemu operacyjnego.
- Przyszłe poprawki pakietu SDK w ciągu 12 miesięcy od początkowego wydania tej wersji głównej będą zgodne wstecznie* z tą wersją.
- * Z wyłączeniem 1. Niezgodności wsteczne, które mogą być spowodowane zależnościami pakietu SDK, np. Kotlin; oraz 2. Niezgodności wsteczne spowodowane minimalną obsługiwaną wersją systemu operacyjnego. Te zmiany można wprowadzić bez zwiększania numeru wersji głównej.
- Po upływie 12 miesięcy od początkowej daty wydania tej wersji głównej poprawki pakietu SDK mogą nie być zgodne wstecznie z tą wersją.
- Google będzie naprawiać problemy z backendem spowodowane usługami Google Maps Platform do momentu wycofania wersji pakietu SDK.
Obsługa IDE
Pakiety SDK Google Maps Platform na iOS są zgodne z tworzeniem aplikacji na iOS w zintegrowanym środowisku programistycznym Xcode firmy Apple. Różne wersje Xcode zawierają różne wersje języka programowania Swift oraz pakiety SDK dla różnych wersji systemów operacyjnych Apple.
Google okresowo podnosi minimalną wersję Xcode obsługiwaną w nowych wersjach głównych pakietów SDK Google Maps Platform na iOS. Aby sprawdzić minimalną obsługiwaną wersję Xcode w przypadku wersji pakietu SDK, z której chcesz korzystać, zapoznaj się z informacjami o wersji i tematami dotyczącymi obsługiwanego oprogramowania.
Obsługa przeglądarek
Interfejs Maps JavaScript API i Maps Embed API obsługują te przeglądarki:
Komputery- Aktualna wersja Microsoft Edge (Windows), z wyłączeniem trybu IE.
- 2 najnowsze główne stabilne wersje Firefoxa (Windows, macOS, Linux).
- 2 najnowsze główne stabilne wersje Chrome (Windows, macOS, Linux).
- 2 najnowsze główne stabilne wersje Safari (macOS).
- Aktualna wersja Chrome na Androidzie 4.1 lub nowszym.
- Chrome WebView na Androidzie 4.4 lub nowszym.
- Mobile Safari w aktualnej i poprzedniej głównej wersji iOS.
- UIWebView i WKWebView w aktualnej i poprzedniej głównej wersji iOS.
- Aktualna wersja Chrome na iOS.