Ghi chú phát hành của SDK trình điều khiển cho Android

Phần này chứa các ghi chú phát hành cho SDK trình điều khiển dành cho Android.

Phiên bản 5.0.0 (ngày 12 tháng 9 năm 2023)

Các thay đổi về cấu hình và phần phụ thuộc

  • Cập nhật SDK điều hướng lên phiên bản 5.x.
  • Nâng cấp minSdkVersion lên API 23.
  • Nâng cấp phiên bản Kotlin lên 1.9.0.
  • Thêm phần phụ thuộc trên Room.
  • Các ứng dụng sử dụng SDK trình điều khiển hiện phải có targetSdkVersion API 31 trở lên.
  • Các ứng dụng sử dụng SDK Trình điều khiển giờ đây phải bật tính năng hỗ trợ thư viện Java 8. Hãy tham khảo tại https://developer.android.com/studio/write/java8-support để biết hướng dẫn cập nhật.
  • Các ứng dụng sử dụng Proguard hoặc Dexguard phải di chuyển sang R8. Hãy tham khảo tại https://developer.android.com/build/shrink-code để biết thêm thông tin.
  • Các ứng dụng dùng SDK Trình điều khiển phải bật tính năng đơn giản hoá. Hãy tham khảo tại https://developer.android.com/studio/write/java8-support#library-desugaring để biết hướng dẫn.

Sửa lỗi

  • Khắc phục vấn đề với việc tắt tính năng đồng bộ hoáLocationTracking.
  • Ra mắt giao diện DriverStatusListener mới giúp báo cáo nguyên nhân trong việc cập nhật trạng thái ngoại lệ.
  • Khắc phục sự cố đối với các trình điều khiển đứng yên (có sẵn từ phiên bản 4.99.0).

Phiên bản 4.99.0 (ngày 9 tháng 8 năm 2023)

  • Hỗ trợ nhiều phiên bản cho phần phụ thuộc NavSDK. ** Hỗ trợ v4.5.0 lên đến (nhưng không bao gồm) v5.0.0.
  • Ngăn không cho giờ đến dự kiến tự giảm khi xe đứng yên. Thay đổi này được triển khai dần dần dưới dạng một thử nghiệm, vì vậy, không phải tất cả các ứng dụng sẽ thấy thay đổi này cùng một lúc.

Phiên bản 4.5.0 (Ngày 12 tháng 5 năm 2023)

  • Cập nhật phần phụ thuộc SDK điều hướng lên phiên bản 4.5. Xin lưu ý rằng mã nhóm và mã cấu phần phần mềm của SDK điều hướng đã thay đổi.

Phiên bản 4.4.3 (Ngày 20 tháng 3 năm 2023)

Thay đổi phần phụ thuộc

  • Nâng cấp phần phụ thuộc SDK Điều hướng lên phiên bản 4.4.1.

Phiên bản 4.4.2 (Ngày 15 tháng 2 năm 2023)

Sửa lỗi

  • Cải thiện thời gian khôi phục mạng khi SDK gặp sự cố kết nối tạm thời. Tính năng này hiện đang được triển khai dưới dạng thử nghiệm.

  • Loại bỏ UpdateVehicle yêu cầu chỉ chứa một giá trị "Thô" vị trí.

  • Khắc phục tình huống tương tranh trong phần "Tổng quan về tuyến đường" API ALPHA.

Phiên bản 4.4.1 (Ngày 18 tháng 11 năm 2022)

Sửa lỗi

  • Đã sửa lỗi trong logic tải lưu lượng truy cập lên.

Các nội dung thay đổi khác

  • Cải tiến nội bộ về tiêu đề của yêu cầu và báo cáo mã trạng thái.

Phiên bản 4.4.0 (ngày 21 tháng 9 năm 2022)

Sửa lỗi

  • Đã khắc phục lỗi ngăn tính năng "Lái xe bằng Google Maps" thông báo sẽ không bị xoá nếu phiên bản API không bị xoá.

Thay đổi phần phụ thuộc

  • Nâng cấp phần phụ thuộc SDK Điều hướng lên phiên bản 4.2.2.

Phiên bản 4.3.0 (ngày 24 tháng 8 năm 2022)

Cải tiến nội bộ.

Thông báo: Hỗ trợ đóng băng Android 5 (ngày 21 tháng 7 năm 2022)

Đối với phiên bản SDK mới nhất (phiên bản 4.2.0), chúng tôi cung cấp thêm một năm hỗ trợ cho các ứng dụng chạy trên Android 5, cho cả API cấp 21 và 22.

Điều này có nghĩa là:

  • SDK điều hướng và SDK trình điều khiển chạy trên các ứng dụng Android của bạn sẽ hỗ trợ tối thiểu là Android 5 (API cấp 21) cho đến ngày 30 tháng 6 năm 2023.
  • Sau ngày 30 tháng 6 năm 2023, chúng tôi sẽ chỉ hỗ trợ API Android cấp 23 trở lên. Nói cách khác, chúng tôi sẽ ngừng hỗ trợ API Android cấp 21 và 22 trên tất cả phiên bản SDK sau ngày đó. Tức là các lỗi liên quan đến Android 21 hoặc 22 trong mọi phiên bản SDK (bao gồm cả 4.x) sẽ không được khắc phục và chúng tôi không đảm bảo SDK sẽ hoạt động chính xác.

Thông báo này ghi đè thông báo đóng băng hỗ trợ Android 21 và 22 từ tháng 6 21, 2021 và Android 23, 24 và 25 hỗ trợ việc treo máy từ ngày 18 tháng 10 năm 2021.

Phiên bản 4.2.0 (ngày 8 tháng 6 năm 2022)

Thay đổi phần phụ thuộc

  • Nâng cấp phần phụ thuộc SDK Điều hướng lên phiên bản 4.1.3.
  • Hạ cấp cấp độ API Android tối thiểu được hỗ trợ xuống 21.

Phiên bản 4.1.0 (ngày 28 tháng 4 năm 2022)

Các bản cập nhật API

  • Đổi tên thuộc tính parentId của đối tượng Task thành trackingId. Cũ thuộc tính hiện vẫn tồn tại nhưng không được dùng nữa.

Phiên bản 4.0.0 (Ngày 29 tháng 11 năm 2021)

Cấp độ API Android tối thiểu được hỗ trợ cho bản phát hành này là 23.

Các bản cập nhật API

Đối với bản phát hành này, chúng tôi đã cập nhật SDK trình điều khiển dành cho Android với các tính năng sau thay đổi.

Thay đổi API VehicleStops

Các đối tượng VehicleStop hiện tham chiếu đến một Danh sách TaskInfo thay vì một Danh sách Task . Nếu bạn cần trạng thái Tác vụ, thì bạn nên theo dõi mã đó trong mã xử lý ứng dụng của mình.

Giám sát sự cố

Tính năng theo dõi và báo cáo sự cố được thêm vào để giúp cải thiện độ ổn định của SDK. Tính năng này được bật theo mặc định nhưng bạn có thể tắt nếu bạn gọi setAbnormalTerminationReportingEnabled() rồi truyền vào đó giá trị false trước khi khởi chạy SDK.

getRemainingvehicleStops không đồng bộ

Xác thực

Xoá các thuộc tính không cần thiết khỏi giao diện AuthTokenContext. Ngừng sử dụng ServiceType. Giờ đây, bạn chỉ cần nhận thông báo xác nhận quyền sở hữu đối với bao gồm mã xe và mã nhiệm vụ, thay vì dựa vào ServiceType.

Ngày 18 tháng 10 năm 2021 – Hỗ trợ đóng băng cho API cấp 23, 24 và 25

Đọc thông báo ngày 18 tháng 10

Để phản hồi những thay đổi về các phần phụ thuộc nội bộ, API Android cấp 23, 24 và 25 (Android 6, 7.0 và 7.1) sẽ không được hỗ trợ trong các phiên bản mới của SDK Điều hướng và Trình điều khiển dành cho Android, bắt đầu trong quý năm 2022.

SDK điều hướng và SDK trình điều khiển dành cho các phiên bản Android được phát hành kể từ tháng 3 trong quý năm 2022 sẽ chỉ hỗ trợ các thiết bị chạy tối thiểu API Android cấp 26.

Các phiên bản ứng dụng được xây dựng bằng SDK Điều hướng và Trình điều khiển phiên bản 4.x trở xuống dành cho Android sẽ tiếp tục hoạt động trên các thiết bị chạy API Android cấp 25 và thấp hơn nữa.

Phiên bản 3.0.4 (ngày 28 tháng 7 năm 2021)

Tính năng

Với bản phát hành này, SDK trình điều khiển chính thức tách khỏi SDK điều hướng. Xem hướng dẫn di chuyển để biết thông tin chi tiết.

Các bản cập nhật API

Thêm các phương thức sau:

RidesharingDriverApi.getDriverSdkVersion()

Độ ổn định và các bản sửa lỗi

Báo cáo PERMISSION_DENIED lỗi thay vì phân loại các lỗi đó là lỗi kết nối.

Thông báo về việc ngừng cung cấp (ngày 21 tháng 6 năm 2021)

Thông báo này mô tả việc ngừng sử dụng SDK trình điều khiển dành cho Android và Navigation SDK cho Android kể từ ngày nêu trên. Thông báo này cũng được gửi đi dưới dạng một Thông báo dịch vụ bắt buộc (MSA) cho những khách hàng bị ảnh hưởng.

Để đơn giản hoá việc tích hợp với khách hàng và đẩy nhanh khả năng cung cấp các sản phẩm hữu ích chúng tôi sẽ tách SDK điều hướng cho Android và SDK trình điều khiển dành cho Android thành hai tệp nhị phân:

  • SDK điều hướng dành cho Android, sẽ cung cấp điều hướng/tuyến đường cho trình điều khiển của mình.
  • SDK trình điều khiển dành cho Android, sẽ cho phép bạn tận dụng Fleet Các dịch vụ web có trạng thái của công cụ cho chuyến đi hoặc tiến trình phân bổ công việc.

Xin lưu ý rằng SDK trình điều khiển dành cho Android có phần phụ thuộc bắt buộc trên SDK điều hướng dành cho Android dành cho các chức năng định tuyến cốt lõi.

Có những thay đổi nào?

Các thay đổi chính trong phiên bản 3 là:

  • 2 tệp nhị phân thay vì 1 tệp nhị phân.
  • Định nghĩa gói rõ ràng hơn cho các lớp SDK của trình điều khiển.
  • SDK điều hướng dành cho Android bao gồm SDK bản đồ dành cho Android trong gói (kể từ SDK điều hướng cho Android phiên bản 2).
    • Điều này cho phép các tính năng bản đồ và điều hướng cùng tồn tại trên cùng một bản đồ (chẳng hạn như vẽ hình nhiều đường trên NavigationView) và giảm mức sử dụng bộ nhớ vì một bản đồ sẽ được sử dụng thay vì hai bản đồ.
    • SDK điều hướng dành cho Android 3.0 thiếu tính năng đầy đủ tương đương với SDK điều hướng dành cho Android, nhưng phiên bản 3.2 sẽ giải quyết hầu hết sự cố ở đây. Xem mục Tôi có thể làm gì và khi nào? để biết thêm chi tiết.
  • Việc ghi nhật ký sẽ giúp chúng tôi dễ dàng khắc phục các vấn đề mà bạn có thể gặp phải.

Các phương thức sau đây cũng đã bị xoá trong phiên bản 3, vì trước đó đã bị xoá được đánh dấu là không được dùng nữa và đã có giải pháp thay thế tồn tại:

  • Các phương thức SDK Điều hướng/Trình điều khiển sau đây không còn được dùng trong phiên bản 1.16, được phát hành vào Ngày 10 tháng 8 năm 2020 và đã bị xoá trong phiên bản 3.0:
    • Waypoint#fromLatLng(*)
    • Waypoint#fromPlaceId(*)
    • Navigator#startGuidance(resumeIntent)
    • NavigationApi#initForegroundServiceManager(*)
  • Để cho đầy đủ và rõ ràng hơn, xin lưu ý rằng chúng tôi đã xoá một số phương thức trong quá trình chuyển đổi v1 sang v2. Hầu hết các báo cáo này là sự hợp nhất của các báo cáo trùng lặp giữa SDK điều hướng cho Android và lớp SDK Bản đồ dành cho Android. Vui lòng xem hướng dẫn di chuyển để hiểu rõ hơn về những thay đổi này.

Ngừng sử dụng SDK trình điều khiển dành cho Android và SDK điều hướng dành cho Android phiên bản 1.x

SDK Điều hướng/Trình điều khiển phiên bản 1 được phát hành vào năm 2018, và chúng tôi sẽ sớm bổ sung phiên bản v3 đã được phát hành, đã đến lúc ngừng sử dụng phiên bản 1 để tránh sự không bền vững của hỗ trợ nhiều phiên bản chính.

Thời gian tiết kiệm được do không phải hỗ trợ phiên bản bổ sung này sẽ cho phép chúng tôi hỗ trợ tốt hơn cho phiên bản lớn mới nhất và tạo thêm các tính năng là rất quan trọng đối với khách hàng của chúng tôi.

Do đó, Nav/Driver SDK phiên bản 1.x hiện không còn được dùng nữa và sẽ không còn được duy trì. sau ngày 21 tháng 6 năm 2022.

Vui lòng dành chút thời gian để xem cách hoạt động của việc ngừng sử dụng trong phiên bản SDK.

Đọc thông báo bị thu hồi

Phiên bản 4.0 sắp tới của SDK điều hướng dành cho Android và SDK trình điều khiển dành cho Android sẽ hỗ trợ tối thiểu [Android 6.0 (API cấp 23)](https://developer.android.com/studio/releases/platforms#6.0){: .external}. Phiên bản tối thiểu được hỗ trợ hiện tại là Android 5.0 (API cấp 21). Chúng tôi dự kiến sẽ phát hành phiên bản 4.0 vào quý 4 năm 2021. Điều này có nghĩa là:

  • Các phiên bản ứng dụng được tạo bằng các phiên bản cũ hơn v4.x sẽ tiếp tục hoạt động trên Thiết bị chạy Android 21 và 22. Ứng dụng trình điều khiển của bạn đã tích hợp Các SDK hiện tại sẽ tiếp tục hoạt động trên các thiết bị chạy Android 21 trở lên. Mục này cũng giống như trước đây.
  • Các phiên bản ứng dụng được xây dựng bằng SDK trình điều khiển dành cho Android và SDK điều hướng dành cho Android phiên bản 4.x (nhắm đến Quý 4 năm 2021, có thể thay đổi) và sau đó sẽ không thể cài đặt trên thiết bị chạy Android 21 và 22. v4.x sẽ chạy trên Android 6.0 (API cấp 23) trở lên, vì vậy, các phiên bản ứng dụng được tạo bằng phiên bản 4.x sắp tới mà người lái xe sử dụng thiết bị chạy Android 23 trở lên nhận được. Xin nhắc lại rằng điều này có nghĩa là cả những thay đổi liên quan đến SDK và mọi thay đổi đối với ứng dụng mà bạn đã thực hiện sẽ không hiển thị với trình điều khiển có thiết bị chạy Android 21 và 22.

Các phiên bản SDK điều hướng dành cho Android v3 và SDK trình điều khiển dành cho Android phiên bản 3 mà bạn sẽ muốn nâng cấp lên được giải thích trong bảng sau cùng với thời điểm sẽ có sẵn.

Bạn dùng tính năng nào của nền tảng trình điều khiển? Bạn có sử dụng những chức năng này không? Sau đó, các phiên bản đầu tiên có sẵn mà bạn nên nâng cấp lên là... Lượng hàng dự kiến
(có thể thay đổi)
Đường liên kết di chuyển
Chỉ điều hướng
(phương thức NavSDK)
Không NavSDK phiên bản 3.0.1 Bây giờ Hướng dẫn
NavSDK phiên bản 3.5 (dự kiến) Tháng 9 năm 2021
Điều hướng và Theo dõi động cơ nhóm (phương thức NavSDK và DriverSDK) Không SDK điều hướng phiên bản 3.0 và SDK trình điều khiển phiên bản 3.0 Hướng dẫn di chuyển trình điều khiển phiên bản 3.0 có sẵn trong bản phát hành
NavSDK phiên bản 3.x và DriverSDK phiên bản 3.0

Để tiếp tục dùng các phương thức đã bị xoá, bạn có thể ở lại phiên bản 1.x nhưng không yêu cầu hỗ trợ hoặc bảo trì sau ngày 21 tháng 6 năm 2022 (xem phần tiếp theo).

Bạn nên chuyển sang phiên bản 3.x. Điều này có nghĩa là:

* Bản phát hành gần đây nhất của phiên bản 1.x sẽ ra mắt vào Quý 4 năm 2021 (và do đó v1 là “tính năng bị treo” kể từ thời điểm đó).

* Bản phát hành cuối cùng này có thể được vá trong 6 tháng sau đó, cho đến hết ngày 21 tháng 6 năm 2022. Sau thời gian này, chúng tôi sẽ không thể phản hồi các yêu cầu về lỗi hoặc tính năng cho phiên bản 1.x.

Vui lòng dành chút thời gian để xem lại bảng sau đây và [hướng dẫn di chuyển](/maps/documentation/navigation-sdk-android/v2/migration) trong để giúp bạn làm quen với những thay đổi này.

Tôi có thể làm gì vào thời điểm nào?

Nếu bạn đang ở trên... Bạn có sử dụng những chức năng này không? Để nâng cấp ngay Khả năng nâng cấp vào tháng 9 năm 2021 Đường liên kết di chuyển
v1.x
(không sử dụng chức năng FleetEngine.java / Trình điều khiển)
Không NavSDK phiên bản 3.0 Hướng dẫn
Không có tuỳ chọn nào NavSDK 3.x
v1.x
(sử dụng chức năng FleetEngine.java / Trình điều khiển)
Không Không có tuỳ chọn nào NavSDK 3.x +
DriverSDK 3.x
Hướng dẫn ở trên cùng với hướng dẫn di chuyển sang Driver v3.0 có sẵn tại bản phát hành.

Bạn nên thông báo cho người lái xe bằng thiết bị trên Android 21 và 22 để nâng cấp lên phiên bản Android mới hơn (tối thiểu Android 6.0) trước khi bạn tích hợp SDK trình điều khiển cho Android và SDK điều hướng cho Android phiên bản 4.x trở lên vào ứng dụng trình điều khiển của bạn.

Phiên bản 1.15.3 (ngày 9 tháng 10 năm 2020)

Các bản cập nhật API

  • SDK trình điều khiển hiện đăng ký SDK điều hướng để cập nhật lưu lượng truy cập, được gửi đến API Fleet Engine.

Độ ổn định và các bản sửa lỗi

  • Khắc phục sự cố thời gian chạy gRPC.

v1.15.2

Tính năng

Đã thêm khả năng dừng thông báo liên tục. Nếu báo cáo vị trí đã dừng trong phiên bản Fleet Engine, hướng dẫn sẽ dừng lại trong Navigator, tất cả trình nghe điều hướng bị huỷ đăng ký, và NavigationFragment hoặc NavigationView bị tạm dừng.

Độ ổn định và các bản sửa lỗi

  • Khắc phục lỗi dẫn đến hệ thống gửi một ngoại lệ nếu thực thể Fleet Engine bị xoá.

Phiên bản 1.15.1 (ngày 12 tháng 5 năm 2020)

Tính năng

Phân tích sơ bộ dữ liệu 1.15.0 cho thấy những cải thiện đáng kể trong báo cáo vị trí ổn định (giảm số vị trí "bị mắc kẹt"). Bản vá này cho phép tiếp tục sử dụng báo cáo vị trí cải thiện. Vấn đề ANR không liên quan vào những cải tiến này.

Độ ổn định và các bản sửa lỗi

  • Đã khắc phục lỗi đôi khi gây ra một đường thẳng ngay từ đầu của tuyến được hiển thị trong ứng dụng cho người dùng thông thường.
  • Đã khắc phục lỗi có thể dẫn đến lỗi ANR khi vị trí đang được báo cáo bởi SDK. Điều này có được nhờ onArrival() cải tiến dễ bị tranh chấp khoá. Chúng tôi đã có thể tái tạo lỗi ANR một cách chính xác trong một số trường hợp và có thể xác minh rằng các bản sửa lỗi đã được giải quyết sự cố. Ứng dụng kiểm thử được sửa đổi để tạo lỗi ANR đã chạy trong 8 giờ không gặp lỗi ANR sau khi khắc phục.

phiên bản 1.15.0 (ngày 23 tháng 3 năm 2019)

Tính năng

  • Ra mắt trạng thái hướng dẫn đi theo chỉ dẫn trong các sự kiện bắt đầu, ngoài tuyến đường và đến nơi để cải thiện tính năng theo dõi vị trí của xe.
  • Đã thêm khả năng tiếp tục nhận các vị trí bị chụp trên đường một cách độc lập của trạng thái điều hướng.
  • Thêm thông tin bổ sung về vị trí bị bắt ngay trước đường, chẳng hạn như độ chính xác.

Độ ổn định và các bản sửa lỗi

  • Tăng minSdkVersion cho navsdk lên 19.
  • Khắc phục lỗi khiến tên tham chiếu vĩ độ/lng không được chấp nhận khi mã hoá địa lý đảo ngược phía máy chủ không thành công.

Bản phát hành phiên bản 1.14.2 (Ngày 2 tháng 2 năm 2019)

Tính năng

  • Ngăn DriverSDK gửi 0.0 vị trí đến Fleet Engine (tốt hơn chia sẻ hành trình và thông tin đầu vào về vị trí phân bổ).
  • Ghi nhật ký bổ sung để cải thiện các vấn đề về vị trí bị kẹt và giảm phương án dự phòng cho việc chia sẻ hành trình.
  • Bỏ qua các lệnh gọi lặp lại đến setLocationReportingInterval() trừ phi khoảng thời gian này thay đổi.
  • Cập nhật javadocs cho phương thức setReportingInterval() với mục tiêu ngăn cản việc gọi lặp lại phương thức này ở tốc độ cao với các khoảng thời gian được sử dụng.
  • Cải thiện độ tin cậy về vị trí Api 29.

v1.13.0

Độ ổn định và các bản sửa lỗi

  • Thêm một phần phụ thuộc trên okhttp mà ứng dụng sẽ phải thêm vào bản dựng Gradle của họ.

Phiên bản 1.11.7 (ngày 18 tháng 10 năm 2019)

Độ ổn định và các bản sửa lỗi

  • Quá trình cập nhật vị trí hiện sẽ tiếp tục sau khi onArrival() kích hoạt một đích đến nhất định.
  • Thông báo mặc định (một chuỗi không đổi trong chế độ Điều hướng miễn phí) khớp với bảng phối màu đã đặt cho các thông báo điều hướng. Để biết thêm thông tin, hãy xem Thông báo liên tục được chia sẻ.
  • Giải quyết vấn đề trong đó sự kiện cập nhật vị trí bị trì hoãn có thể gây ra cập nhật vị trí giả, gây ra các hiện tượng như đường thẳng tại điểm đầu của một tuyến đường.

Phiên bản 1.11.6 (ngày 4 tháng 10 năm 2019)

Các bản cập nhật API

  • Ra mắt một loạt thay đổi nhằm đảm bảo rằng SDK Trình điều khiển sẽ tiếp tục hoạt động cập nhật vị trí nhanh chóng sau sự cố mạng. Sau khi kết nối mạng đã được khôi phục, quy trình cập nhật vị trí sẽ bắt đầu lại vào vị trí đã lên lịch tiếp theo cập nhật.

Độ ổn định và các bản sửa lỗi

  • setVehicleState() sẽ trả về ngay lập tức. Quá trình cập nhật FleetEngine hiện diễn ra ở chế độ nền chuỗi. Khắc phục sự cố Ứng dụng không phản hồi (ANR).
  • Khắc phục vấn đề khiến các tuyến đường chia sẻ hành trình hiển thị dưới dạng đường thẳng bằng cách sử dụng các phiên bản cũ hơn của SDK người tiêu dùng. Đảm bảo rằng không điểm tham chiếu một lần được SDK trình điều khiển thêm vào tuyến đường.