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 cho Android.

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

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

  • 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 dùng SDK trình điều khiển hiện phải có targetSdkVersion API 31 trở lên.
  • Giờ đây, các ứng dụng dùng SDK trình điều khiển phải bật tính năng hỗ trợ thư viện Java 8. Hãy truy cập https://developer.android.com/studio/write/java8-support để xem hướng dẫn cập nhật.
  • Các ứng dụng 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 quy trình đơn giản hoá. Hãy truy cập 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ề việc tắt tính năng đồng bộ hoáLocationTracking.
  • Ra mắt giao diện DriverStatusListener mới báo cáo nguyên nhân trong các bản cập nhật trạng thái ngoại lệ.
  • Sửa lỗi đối với người lái xe đứng yên (có 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 đến (nhưng không bao gồm) v5.0.0.
  • Ngăn thời gian đến dự kiến (ETA) không tự giảm khi xe đang đứng yên. Thay đổi này được triển khai từng bước dưới dạng thử nghiệm, nên không phải ứng dụng nào cũng thấy thay đổi này cùng 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. Lưu ý rằng mã nhóm và cấu phần phần mềm cho 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 vị trí "Thô".

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

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

Sửa lỗi

  • Đã khắc phục 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ộ trong báo cáo tiêu đề yêu cầu và 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 khiến thông báo "Lái xe bằng Google Maps" không bị xoá nếu phiên bản API chưa được 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 dành cho Android 5 (ngày 21 tháng 7 năm 2022)

Đối với phiên bản SDK mới nhất (v4.2.0), chúng tôi sẽ 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ợ Android 5 (API cấp 21) tối thiểu 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ả các phiên bản SDK sau ngày đó. Điều này có nghĩa 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 rằng SDK sẽ hoạt động chính xác.

Thông báo này thay thế thông báo tạm ngưng hỗ trợ Android 21 và 22 từ ngày 21 tháng 6 năm 2021 và thông báo đóng băng hỗ trợ Android 23, 24 và 25 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)

Bản cập nhật API

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

  • Thay đổi một số loại dữ liệu trả về từ Future thành ListenableFuture cụ thể hơn và từ List thành ImmutableList cụ thể hơn.

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.

Bản cập nhật API

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

Thay đổi API xeStops

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

  • Đã thêm một lớp mới: TaskInfo

  • Thay thế hàm getTasks của VehicleStop bằng hàm getTaskInfoList.

  • Thay thế hàm setTasks của VehicleStop.Builder bằng hàm setTaskInfoList.

Giám sát sự cố

Chúng tôi đã thêm tính năng báo cáo và theo dõi sự cố để 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 gọi setAbnormalTerminationReportingEnabled() và chuyển giá trị false trước khi khởi chạy SDK.

Không đồng bộ hoá getRemainingCarStops

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 các thông báo xác nhận quyền sở hữu cho mã xe và mã công việc đi kèm, thay vì dựa vào ServiceType.

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

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

Để đáp ứng những thay đổi về các phần phụ thuộc nội bộ của chúng tôi, kể từ quý 3 năm 2022, 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 cho Android.

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

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

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 được tách khỏi SDK điều hướng. Vui lòng xem hướng dẫn di chuyển để biết thông tin chi tiết.

Bản cập nhật API

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

DeliveryDriverApi.getDriverSdkVersion()

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

Báo cáo lỗi PERMISSION_DENIED thay vì phân loại lỗi này 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 cho Android và SDK điều hướng cho Android kể từ ngày nêu trên. Chúng tôi cũng gửi thông báo này dưới dạng 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á quá trình tích hợp khách hàng và tăng tốc khả năng cung cấp các tính năng hữu ích, chúng tôi sẽ chia SDK Điều hướng cho Android và SDK trình điều khiển cho Android thành hai tệp nhị phân khác nhau:

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

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 cho các chức năng định tuyến cốt lõi.

Có những thay đổi gì?

Những thay đổi chính trong phiên bản 3 là:

  • Hai tệp nhị phân thay vì một.
  • Định nghĩa gói rõ ràng hơn cho SDK trình điều khiển cho các lớp Android.
  • SDK Điều hướng dành cho Android bao gồm SDK Bản đồ dành cho Android như một phần của quá trình đóng gói (kể từ SDK Điều hướng dành cho Android phiên bản 2).
    • Điều này cho phép bản đồ và các tính năng điều hướng cùng tồn tại trên cùng một bản đồ (chẳng hạn như vẽ nhiều đường trên NavigationView) và giảm mức sử dụng bộ nhớ vì sử dụng một bản đồ thay vì hai bản đồ.
    • SDK Điều hướng cho Android 3.0 thiếu tính năng tương đương đầy đủ về tính năng như SDK Điều hướng cho Android, nhưng phiên bản 3.2 sẽ giải quyết được hầu hết các vấn đề ở đây. Hã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 gỡ lỗi các sự cố mà bạn có thể gặp phải.

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

  • Các phương thức sau đây của Nav/Driver SDK không còn được dùng trong phiên bản 1.16, được phát hành vào ngày 10/8/2020 và đã bị xoá trong phiên bản 3.0:
    • Waypoint#fromLatLng(*)
    • Waypoint#fromPlaceId(*)
    • Navigator#startGuidance(resumeIntent)
    • NavigationApi#initForegroundServiceManager(*)
  • Để hoàn chỉnh và rõ ràng, hãy lưu ý rằng một số phương thức đã bị xoá trong quá trình chuyển đổi từ v1 sang v2. Hầu hết trong số này là sự hợp nhất của các lớp trùng lặp giữa SDK Điều hướng cho Android và SDK Bản đồ 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.

SDK trình điều khiển cho Android và SDK điều hướng cho Android phiên bản 1.x không dùng nữa

Phát hành SDK Nav/Driver v1 vào năm 2018 và với các phiên bản v3 sắp được phát hành, đã đến lúc ngừng sử dụng v1 để tránh tình trạng hỗ trợ nhiều phiên bản lớn không bền vững.

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 phiên bản lớn mới nhất và tạo thêm nhiều tính năng quan trọng đối với khách hàng của mình.

Do đó, SDK Nav/Driver phiên bản 1.x hiện không đượ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 các 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 cho Android và SDK trình điều khiển 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ự báo 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 phiên bản trước phiên bản 4.x sẽ tiếp tục hoạt động trên các thiết bị Android 21 và 22. Ứng dụng cho trình điều khiển đã tích hợp các SDK hiện tại của chúng tôi sẽ tiếp tục hoạt động trên các thiết bị chạy Android 21 trở lên. Phiên bản này vẫn giống như trước.
  • Các phiên bản ứng dụng được tạo bằng SDK trình điều khiển cho Android và SDK điều hướng 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 cài đặt được trên các 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 xây dựng bằng SDK Android phiên bản 2 trở lên sẽ chỉ tiếp cận được các thiết bị Android

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

Bạn sử dụng nhữ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 tính năng này không? Thì những phiên bản đầu tiên có sẵn mà bạn nên nâng cấp lên sẽ là... Phạm vi cung cấp 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 Vừa xong Hướng dẫn
Có NavSDK phiên bản 3.5 (dự kiến) Tháng 9 năm 2021
Theo dõi công cụ điều hướng và nhóm thiết bị (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 hiện đã có bản phát hành
Có NavSDK phiên bản 3.x và DriverSDK phiên bản 3.0

Để tiếp tục sử dụng các phương thức đã bị xoá, bạn có thể tiếp tục sử dụng phiên bản 1.x nhưng không kỳ vọng được 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 v1.x sẽ ra mắt vào Quý 4 năm 2021 (và do đó, phiên bản 1 sẽ "bị treo tính năng" kể từ thời điểm đó).

* Bản phát hành cuối cùng này có thể được vá thêm 6 tháng sau đó, cho đến 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 xét bảng sau đây và [hướng dẫn di chuyển](/maps/documentation/navigation-sdk-android/v2/migration) để giúp bạn làm quen với các thay đổi này.

Tôi có thể làm gì khi nào?

Nếu bạn hiện đang ở trên... Bạn có sử dụng những tính năng này không? Nâng cấp ngay Sẽ 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 FleetEngine.java / chức năng của Trình điều khiển) 		Không NavSDK phiên bản 3.0 Hướng dẫn
Có 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 Driver phiên bản 3.0 có sẵn khi phát hành.
Có

Bạn nên thông báo cho những người lái xe có thiết bị sử dụng thiết bị Android 21 và 22 để nâng cấp lên phiên bản Android mới hơn (tối thiểu là Android 6.0) trước khi 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 v4.x trở lên vào ứng dụng trình điều khiển.

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

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ác nội dung này được gửi đến Fleet Engine API.

Độ ổ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 ngừng thông báo liên tục. Nếu tính năng báo cáo vị trí bị dừng trong thực thể Fleet Engine, hướng dẫn sẽ dừng trong Navigator, tất cả trình nghe điều hướng sẽ bị huỷ đăng ký và NavigationFragment hoặc NavigationView sẽ bị tạm dừng.

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

  • Khắc phục lỗi hệ thống sẽ gửi một trường hợp 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 phiên bản 1.15.0 cho thấy những cải tiến đáng kể trong tính năng báo cáo vị trí ổn định (giảm số vị trí "bị mắc kẹt"). Bản vá sửa lỗi này cho phép tính năng báo cáo vị trí được cải thiện tiếp tục hoạt động. Vấn đề ANR không liên quan đến 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 khiến một đường thẳng ở đầu tuyến hiện trong ứng dụng của người dùng.
  • Khắc phục lỗi có thể dẫn đến lỗi ANR khi SDK báo cáo vị trí. Điều này là kết quả của những cải tiến về onArrival() dễ bị tranh chấp khoá. Chúng tôi có thể tái tạo lỗi ANR một cách đáng tin cậy trong một số trường hợp và có thể xác minh rằng các bản sửa lỗi đã giải quyết được vấn đề. Sau khi khắc phục, ứng dụng thử nghiệm được sửa đổi để tạo lỗi ANR đã chạy trong 8 giờ mà không có lỗi ANR.

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 chỉ đường khi bắt đầu, sai tuyến đường và đến nơi để cải thiện khả 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í chụp đường độc lập với trạng thái điều hướng.
  • Thêm thông tin bổ sung về các vị trí trước khi chụp đường, chẳng hạn như độ chính xác.

Bản sửa lỗi và độ ổn định

  • Tăng minSdkVersion cho navsdk lên 19.
  • Sửa lỗi khiến tên tham chiếu lat/lng không được chấp nhận khi mã hoá địa lý 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 (dữ liệu đầu vào về vị trí phân bổ và chia sẻ hành trình hiệu quả hơn).
  • Ghi nhật ký bổ sung để cải thiện các vấn đề về vị trí bị nghẽn và giảm bớt dự phòng cho hoạt động 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() nhằm ngăn cản việc gọi phương thức này nhiều lần ở tốc độ cao so với các khoảng thời gian đang được sử dụng.
  • Đã cải thiện độ tin cậy của 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 các 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

  • Giờ đây, hoạt động cập nhật vị trí sẽ tiếp tục sau khi onArrival() kích hoạt cho một điểm đến nhất định.
  • Thông báo mặc định (một chuỗi không đổi trong chế độ Điều hướng tự do) khớp với bảng phối màu được thiết lập cho các thông báo chỉ đường. Để biết thêm thông tin, hãy xem phần 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ễ có thể gây ra hoạt động cập nhật vị trí giả, gây ra các cấu phần phần mềm như một đường thẳng ở đầu một tuyến đường.

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

Bản cập nhật API

  • Ra mắt một loạt các thay đổi nhằm đảm bảo SDK trình điều khiển sẽ nhanh chóng tiếp tục cập nhật vị trí sau khi xảy ra lỗi mạng. Sau khi kết nối mạng được khôi phục, thông tin cập nhật vị trí sẽ bắt đầu lại vào lần cập nhật vị trí theo lịch tiếp theo.

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

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