Chính sách hỗ trợ phiên bản hệ điều hành di động
Khi hệ điều hành di động phát triển và khi chúng tôi ra mắt các tính năng và bản cập nhật của Google Maps Platform, chúng tôi sẽ ngừng hỗ trợ các phiên bản hệ điều hành di động cũ.
Việc ngừng hỗ trợ phiên bản SDK của Google Maps Platform cho các phiên bản Android và iOS cụ thể giúp Google xác định phạm vi và mở rộng quy mô kiểm thử SDK.
Phần này mô tả chính sách hỗ trợ của Google Maps Platform đối với các nền tảng di động. Chính sách này chỉ áp dụng cho các sản phẩm được phát hành rộng rãi (GA).
Thời gian thông báo 12 tháng về việc Ngừng cung cấp Dịch vụ không áp dụng cho việc ngừng hỗ trợ hệ điều hành, theo định nghĩa trong Điều khoản dịch vụ của Google Maps Platform.
Chủ sở hữu dự án sẽ nhận được thông báo chủ động về những thay đổi ảnh hưởng đến từng dự án của họ. Luôn nắm bắt thông tin về các bản cập nhật lớn, việc ngừng cung cấp và những thay đổi khác.
Thuật ngữ
Bảng tóm tắt về phiên bản hệ điều hành tối thiểu mà Android hỗ trợ
| Phiên bản SDK mới nhất biên dịch với phiên bản hệ điều hành này (ngày phát hành) | ||||||
|---|---|---|---|---|---|---|
| Phiên bản Android | Maps SDK (thư viện ứng dụng) | Nav SDK | Places SDK | Driver SDK | Consumer SDK | |
| Android Nougat – API cấp 24 (2016) | Mới nhất | Mới nhất | Mới nhất | Mới nhất | Mới nhất | |
| Android Marshmallow – API cấp 23 (2015) | Mới nhất | 6.3 (18/6/25) | 4.4.1 (7/6/2025) | 6.2 (18/6/2025) | Mới nhất | |
| Android Lollipop – API cấp 21 (2014) | 19.2.0 (14/4/2025) | 4,99 (06/07/2023) | 3.5.0 (28/5/2024) | 4,99 (8/9/ 2023) | 1.99.1 (31/ 8/ 2023) | |
| Android KitKat – API cấp 19 (2013) | 18.2(18/10/2023) | 3.2(10/07/2021) | 2.7.0(11/01/2021) | 3.0.4 (28/7/2021) | 0.9.28 (18/5/ 2021) | |
Bảng tóm tắt về phiên bản hệ điều hành tối thiểu được iOS hỗ trợ
| Phiên bản SDK mới nhất biên dịch với phiên bản hệ điều hành này (ngày phát hành) | ||||
|---|---|---|---|---|
| Phiên bản iOS | SDK Maps và SDK Nav | Places SDK | Consumer SDK và Driver SDK | |
| 16 (2022) trở lên | Mới nhất | Mới nhất | Mới nhất | |
| 15 (2021) | 9.4 (18/3/2025) | 9.4 (3/10/2025) | 9.2.1 (28/3/2025) | |
| 14 (2020) | 8.5 (1/4/2024) | 8.5 (1/4/2024) | 3.3.0 (3/6/2024) | |
| 13 (2019) | 7.4 (27/2/2023) | 7.4 (27/2/2023) | 2.2.1 (17/4/2023) | |
| 12 (2018) | 6.2 (25/4/2022) | 6.2 (25/4/2022) | ||
Chính sách hỗ trợ hệ điều hành Android
Các bản phát hành mới của Google Maps Platform SDK cho Android hỗ trợ một phiên bản Android OS (Cấp độ API, chẳng hạn như 29 và 30) trong ít nhất 6 năm sau khi phát hành phiên bản OS đó lần đầu. Bạn có thể giới thiệu các tính năng đóng băng hệ điều hành mà không cần tăng số phiên bản lớn.
Ví dụ: đối với một phiên bản Android được phát hành vào năm 2020, các bản phát hành mới của Places SDK cho Android sẽ hỗ trợ phiên bản đó cho đến ít nhất là năm 2026.
Đôi khi, khi mức sử dụng một hệ điều hành Android đã có ít nhất 6 năm tuổi giảm xuống mức đủ thấp:
-
Google sẽ ngừng hỗ trợ phiên bản hệ điều hành Android đó, khiến phiên bản cao hơn một bậc trở thành phiên bản hệ điều hành được hỗ trợ tối thiểu trong các bản phát hành SDK mới cho Android.
-
Do đó, bạn sẽ cần quyết định xem có nên:
- Áp dụng phiên bản SDK mới nhất, tăng hệ điều hành tối thiểu được hỗ trợ cho các phiên bản mới của ứng dụng và chỉ định các phiên bản phần phụ thuộc bản dựng cho phù hợp.
- Hoặc bạn có thể tiếp tục sử dụng phiên bản SDK trước đó. Tuy nhiên, điều này có thể hạn chế khả năng nhận bản sửa lỗi theo cách tương thích ngược theo phần Hỗ trợ SDK.
Ví dụ: Google có thể ngừng hỗ trợ Android 7 (API cấp 25, phát hành năm 2016), khiến Android 8 (API cấp 26) trở thành hệ điều hành tối thiểu được hỗ trợ trong các phiên bản mới của Google Maps Platform SDK cho Android. Các phiên bản ứng dụng được tạo bằng các phiên bản cũ của SDK sẽ tiếp tục chạy trên các thiết bị chạy Android 7, còn các phiên bản ứng dụng được tạo bằng các phiên bản SDK phát hành sau thời điểm này sẽ không chạy được trên các thiết bị chạy Android 7.
Maps SDK cho Android là trường hợp ngoại lệ đối với lịch trình ngừng hỗ trợ phiên bản hệ điều hành. SDK này được phân phối trong Dịch vụ Google Play.
SDK Maps dành cho Android
Maps SDK cho Android không thuộc phạm vi của chính sách hỗ trợ phiên bản hệ điều hành này. Thời gian chạy Maps SDK cho Android được đưa vào làm một phần của Dịch vụ Google Play (còn được gọi là "Các dịch vụ của Google dành cho thiết bị di động" hoặc "GMS Core"). Đây là yêu cầu bắt buộc để chạy các ứng dụng của Google trên thiết bị Android. Vì Dịch vụ Google Play tuân theo lịch hỗ trợ Cấp độ API Android riêng (như minh hoạ trong thông báo này), nên lịch hỗ trợ của Maps SDK cho Android phụ thuộc vào khả năng hỗ trợ hệ điều hành của Dịch vụ Google Play. Để biết thông tin về phiên bản API Android mà Dịch vụ Google Play chạy, hãy xem phần Thiết lập Dịch vụ Google Play.
Tuy nhiên, thư viện ứng dụng Maps SDK cho Android (thành phần tượng trưng API) hoạt động với thời gian chạy bản đồ trên Dịch vụ Google Play được phân phiên bản và hỗ trợ trên các cấp độ API Android cụ thể theo chính sách hỗ trợ Hệ điều hành Android. Khi tạo ứng dụng bằng Maps SDK cho Android, nhà phát triển đặt phiên bản thư viện ứng dụng làm phần phụ thuộc.
Nếu một ứng dụng đang dùng phiên bản mới hơn của thư viện ứng dụng nhưng đang chạy trên một thiết bị có phiên bản cũ hơn của Dịch vụ Google Play, thì mọi tính năng mới hơn được gọi sẽ không hoạt động trên những thiết bị đó. Không có lỗi hoặc trường hợp ngoại lệ nào xảy ra đối với ứng dụng.
Đôi khi, Dịch vụ Google Play có thể hạn chế việc phát hành các ứng dụng được tạo bằng các phiên bản thư viện ứng dụng cũ (lớp trừu tượng API). Khi điều này xảy ra, bạn sẽ nhận được cảnh báo khi xuất bản ứng dụng của mình trong Cửa hàng Play và có thể bị chặn phát hành thêm cho đến khi thư viện được cập nhật. Tìm hiểu thêm trong Trung tâm trợ giúp của Play Console.
Để biết thêm thông tin về các bản phát hành Android, hãy xem các bản phát hành nền tảng SDK Android.
Chính sách hỗ trợ iOS
Các bản phát hành mới của SDK Google Maps Platform cho iOS hỗ trợ một phiên bản iOS trong ít nhất 3 năm sau khi phiên bản hệ điều hành đó được phát hành lần đầu. Bạn có thể giới thiệu các tính năng đóng băng hệ điều hành mà không cần tăng số phiên bản lớn. Hãy xem Chính sách hỗ trợ hệ điều hành Android để biết ví dụ.
Hỗ trợ SDK
Khi Google phát hành một phiên bản mới của SDK di động Google Maps Platform:
- Google đã kiểm thử phiên bản này trên các phiên bản hệ điều hành từ phiên bản hệ điều hành tối thiểu được hỗ trợ đã nêu trở về trước.
- Các bản sửa lỗi SDK trong tương lai trong vòng 12 tháng sau lần phát hành chính ban đầu của phiên bản này sẽ tương thích ngược* với phiên bản này.
- * Loại trừ 1. Sự không tương thích ngược có thể do các phần phụ thuộc SDK gây ra, chẳng hạn như Kotlin; và 2. Không tương thích ngược do phiên bản hệ điều hành tối thiểu được hỗ trợ. Những thay đổi này có thể được giới thiệu mà không làm tăng số phiên bản lớn.
- Sau 12 tháng kể từ ngày phát hành chính ban đầu của phiên bản này, các bản sửa lỗi SDK có thể không tương thích ngược với phiên bản này.
- Google sẽ khắc phục các vấn đề về phụ trợ do các dịch vụ của Google Maps Platform gây ra cho đến khi phiên bản SDK ngừng hoạt động.
Hỗ trợ IDE
Các SDK của Google Maps Platform dành cho iOS tương thích với hoạt động phát triển cho iOS trong môi trường phát triển tích hợp Xcode của Apple. Các phiên bản Xcode khác nhau sẽ có các phiên bản khác nhau của ngôn ngữ lập trình Swift cũng như SDK cho các phiên bản khác nhau của hệ điều hành Apple.
Google định kỳ nâng cấp phiên bản tối thiểu của Xcode được hỗ trợ trong các phiên bản chính mới của SDK Google Maps Platform cho iOS. Xem ghi chú phát hành và các chủ đề về phần mềm được hỗ trợ để biết phiên bản Xcode tối thiểu được hỗ trợ cho phiên bản SDK mà bạn muốn tạo.
Hỗ trợ trình duyệt
Maps JavaScript API và Maps Embed API hỗ trợ các trình duyệt web sau:
Máy tính- Phiên bản hiện tại của Microsoft Edge (Windows), ngoại trừ chế độ IE.
- Hai phiên bản chính ổn định mới nhất của Firefox (Windows, macOS, Linux).
- Hai phiên bản ổn định chính mới nhất của Chrome (Windows, macOS, Linux).
- Hai phiên bản chính ổn định mới nhất của Safari (macOS).
- Phiên bản Chrome hiện tại trên Android 4.1 trở lên.
- Chrome WebView trên Android 4.4 trở lên.
- Mobile Safari trên các phiên bản chính hiện tại và trước đó của iOS.
- UIWebView và WKWebView trên các phiên bản chính hiện tại và trước đó của iOS.
- Phiên bản Chrome hiện tại dành cho iOS.