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

Phần này chứa ghi chú phát hành cho Driver SDK cho Android.

Thông báo: Ngừng hỗ trợ API cấp 23, 24 và 25

Theo chính sách hỗ trợ phiên bản hệ điều hành di động, chúng tôi sẽ ngừng hỗ trợ Android 6 và 7 (API cấp 23, 24 và 25) trong các phiên bản chính sắp tới của Driver SDK cho Android.

Các phiên bản Driver SDK cho Android được phát hành từ quý 4 năm 2025 trở đi sẽ hỗ trợ tối thiểu Android 8 (API cấp 26). Các phiên bản SDK cũ hơn sẽ tiếp tục hỗ trợ Android 6 và 7.

Nếu các phần phụ thuộc của bạn không chỉ định số phiên bản, thì IDE sẽ tải phiên bản SDK mới nhất và các bản dựng mới của ứng dụng sẽ không hỗ trợ Android 6 và 7.

Chỉ định một phiên bản Driver SDK cho Android trong các phần phụ thuộc bản dựng của ứng dụng để kiểm soát thời điểm bạn tăng hệ điều hành được hỗ trợ tối thiểu cho các phiên bản mới của ứng dụng.

v6.2.0 (ngày 18 tháng 6 năm 2025)

Sửa lỗi

• Khắc phục sự cố NullPointerException khi gọi DriverApi.createInstance() khi không có DriverStatusListener.

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

• Kể từ phiên bản 6.2.0 của Driver SDK cho Android, các ứng dụng phải nâng cấp lên Kotlin 2.1.

• Đã cập nhật các phiên bản có phạm vi được hỗ trợ của Navigation SDK, bao gồm cả phiên bản 6.1.0 trở lên.

Phiên bản 6.1.0 (Ngày 10 tháng 3 năm 2025)

Sửa lỗi

• Cải thiện tính năng ghi nhật ký nội bộ.

v5.99.1 (ngày 10 tháng 1 năm 2025)

Sửa lỗi

• Khắc phục vấn đề trong đó trình điều khiển nhận được lỗi gRPC có mã "INTERNAL" và "Panic! Đây là một lỗi!" nội dung mô tả khi ứng dụng khởi chạy lần đầu sau khi cài đặt.

v6.0.0 (Ngày 25 tháng 11 năm 2024)

Sửa lỗi

• Khắc phục vấn đề trong đó trình điều khiển nhận được lỗi gRPC có mã "INTERNAL" và "Panic! Đây là nội dung mô tả "Đây là lỗi!".
• Cải thiện nội bộ để giảm lỗi kết nối khi cập nhật vị trí, đặc biệt là khi thiết bị chuyển đổi mạng. Tính năng này sẽ được triển khai dần (bắt đầu từ 0%) sau khi bản phát hành được tích hợp.

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

• Xoá giao diện StatusListener không dùng nữa.

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

• Xoá phần phụ thuộc vào glide:cronet-integration trong POM.xml
• Cập nhật các phiên bản được hỗ trợ của Navigation SDK thành v5.x.
• Kể từ phiên bản 6.0.0 của Driver SDK cho Android, các ứng dụng phải nâng cấp lên Kotlin 2.0.
• targetSdk hiện là API cấp 34. Đây là yêu cầu bắt buộc đối với tất cả ứng dụng triển khai lên Cửa hàng Google Play kể từ tháng 8 năm 2024. Xem bài viết Đáp ứng yêu cầu của Google Play về cấp độ API mục tiêu.

v5.99.0 (Ngày 20 tháng 9 năm 2024)

Sửa lỗi

• Khắc phục vấn đề trong đó trình điều khiển nhận được lỗi gRPC có mã "INTERNAL" và "Panic! Đây là nội dung mô tả "Đây là lỗi!". Việc này sẽ được triển khai dần (bắt đầu từ 0%) sau khi bản phát hành được tích hợp.
• Cải thiện nội bộ để giảm lỗi kết nối khi cập nhật vị trí, đặc biệt là khi thiết bị chuyển đổi mạng. Tính năng này sẽ được triển khai dần (bắt đầu từ 0%) sau khi bản phát hành được tích hợp.

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

• Xoá phần phụ thuộc vào glide:cronet-integration trong POM.xml

v5.0.0 (Ngày 12 tháng 9 năm 2023)

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

• Cập nhật Navigation SDK lên phiên bản 5.x.
• Nâng cấp minSdkVersion lên API 23.
• Nâng cấp Kotlin lên phiên bản 1.9.0.
• Đã thêm phần phụ thuộc vào Room. * Giờ đây, các ứng dụng sử dụng Driver SDK phải có targetSdkVersion từ API 31 trở lên.
• Giờ đây, những ứng dụng sử dụng Driver SDK phải bật tính năng hỗ trợ thư viện Java 8. Hãy xem 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 xem https://developer.android.com/build/shrink-code để biết thêm thông tin.
• Những ứng dụng sử dụng Driver SDK phải bật tính năng khử đường. Hãy xem 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 đồng bộ hoá disableLocationTracking.
• Giới thiệu giao diện DriverStatusListener mới báo cáo nguyên nhân trong các thông tin cập nhật trạng thái ngoại lệ.
• Khắc phục vấn đề về việc người lái xe vẫn đứ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ợ phiên bản 4.5.0 đến (nhưng không bao gồm) phiên bản 5.0.0.
• Ngăn ETA tự động giảm khi xe đang đứng yên. Thay đổi này sẽ được triển khai từng bước dưới dạng một thử nghiệm, nên không phải ứng dụng nào cũng thấy được 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 Navigation SDK lên phiên bản 4.5. Xin lưu ý rằng mã nhận dạng nhóm và mã nhận dạng cấu phần phần mềm cho Navigation SDK đã thay đổi.

v4.4.3 (Ngày 20 tháng 3 năm 2023)

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

• Nâng cấp phần phụ thuộc Navigation SDK lên phiên bản 4.4.1.

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 phải vấn đề tạm thời về kết nối. Đây là một bản sửa lỗi thử nghiệm.

• Loại bỏ các yêu cầu UpdateVehicle chỉ chứa thông tin vị trí "Thô".

• Khắc phục điều kiện tương tranh trong API ALPHA "Thông tin tổng quan về tuyến đường".

v4.4.1 (Ngày 18 tháng 11 năm 2022)

Sửa lỗi

• Khắc phục một 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 thiện nội bộ trong tiêu đề 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 một 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 về phần phụ thuộc

• Nâng cấp phần phụ thuộc Navigation SDK lên phiên bản 4.2.2.

4.3.0 (Ngày 24 tháng 8 năm 2022)

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

Thông báo: Ngừng hỗ trợ 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 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à:

• Navigation SDK và Driver SDK chạy trên các ứng dụng Android của bạn sẽ hỗ trợ tối thiểu Android 5 (API cấp 21) cho đến hết 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ợ Android API 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 (kể cả 4.x) sẽ không được khắc phục và chúng tôi không đảm bảo rằng các SDK sẽ hoạt động đúng cách.

Thông báo này thay thế thông báo về việc ngừng hỗ trợ Android 21 và 22 từ ngày 21 tháng 6 năm 2021, cũng như thông báo về việc ngừng hỗ trợ Android 23, 24 và 25 từ ngày 18 tháng 10 năm 2021.

v4.2.0 (ngày 8 tháng 6 năm 2022)

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

• Nâng cấp phần phụ thuộc Nav SDK lên phiên bản 4.1.3.
• Hạ 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. Thuộc tính cũ hiện vẫn tồn tại nhưng không được dùng nữa.

v4.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

Trong bản phát hành này, Driver SDK cho Android đã được cập nhật với những thay đổi sau.

Thay đổi về VehicleStops API

Các đối tượng VehicleStop hiện tham chiếu đến một Danh sách các đối tượng TaskInfo thay vì một Danh sách các đố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ã ứng dụng của mình.

• 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 giám sát và báo cáo 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 tính năng này nếu gọi setAbnormalTerminationReportingEnabled() và truyền cho tính năng này giá trị false trước khi bạn khởi chạy SDK.

• Đã thêm hàm setAbnormalTerminationReportingEnabled vào DriverApi.

Async getRemainingVehicleStops

• Đã thay đổi hàm DeliveryVehicleReporter của getRemainingVehicleStops để trả về Future<List<VehicleStop>> thay vì List<VehicleStop>.

Xác thực

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

• Đã xoá ServiceType khỏi AuthTokenContext.

• Đã xoá getServiceType() khỏi AuthTokenContext.

• Đã xoá setServiceType khỏi AuthTokenContext.Builder.

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

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, Driver SDK chính thức tách biệt với Navigation SDK. Hãy 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()`

Cải thiện độ ổn định và sửa lỗi

Báo cáo lỗi PERMISSION_DENIED thay vì phân loại chúng 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ả những thay đổi đối với Driver SDK 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 dưới dạng Thông báo dịch vụ bắt buộc (MSA) cho những khách hàng chịu ảnh hưởng.

Nav/Driver SDK cho Android sẽ trở thành Navigation SDK cho Android phiên bản 3.x và Driver SDK cho Android phiên bản 3.x cho Android (phân tách các tệp nhị phân)

Để đơn giản hoá quy trình tích hợp cho 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 Navigation SDK cho Android và Driver SDK cho Android thành 2 tệp nhị phân riêng biệt:

• Navigation SDK cho Android, cung cấp chức năng chỉ đường/định tuyến cho người lái xe.
• Driver SDK 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 để biết tiến trình và việc phân bổ chuyến đi hoặc nhiệm vụ.

Xin lưu ý rằng Driver SDK cho Android có một phần phụ thuộc bắt buộc vào Navigation SDK cho Android đối với các chức năng định tuyến cốt lõi.

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

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

• Hai tệp nhị phân thay vì một.
• Định nghĩa gói rõ ràng hơn cho các lớp Driver SDK cho Android.
• Navigation SDK cho Android bao gồm Maps SDK cho Android trong gói (kể từ Navigation SDK 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ẽ nhiều đường trên NavigationView) và giảm mức sử dụng bộ nhớ vì chỉ dùng một bản đồ thay vì hai.
  • Navigation SDK cho Android 3.0 thiếu tính năng tương đương hoàn toàn với Navigation SDK cho Android, nhưng phiên bản 3.2 sẽ giải quyết hầu hết các vấn đề tại đây. Hãy xem phần Tôi có thể làm gì và khi nào? để biết thêm thông tin.
• Nhật ký sẽ giúp chúng tôi dễ dàng gỡ lỗi các vấn đề 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 được dùng nữa và đã có giải pháp thay thế:

• Các phương thức Nav/Driver SDK sau đây đã ngừng hoạt động trong phiên bản 1.16 (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(*)
• Để đảm bảo tính đầy đủ và rõ ràng, xin lưu ý rằng một số phương thức đã bị xoá trong quá trình chuyển đổi từ phiên bản 1 sang phiên bản 2. Hầu hết các lớp này đều là các lớp trùng lặp được hợp nhất giữa Navigation SDK cho Android và Maps SDK 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 cung cấp Driver SDK cho Android và Navigation SDK cho Android phiên bản 1.x

Nav/Driver SDK phiên bản 1 được phát hành vào năm 2018 và phiên bản 3 sắp được phát hành. Do đó, chúng tôi sẽ ngừng cung cấp phiên bản 1 để tránh việc không thể duy trì hỗ trợ nhiều phiên bản chính.

Thời gian tiết kiệm được nhờ không phải hỗ trợ phiên bản bổ sung này sẽ giúp chúng tôi hỗ trợ tốt hơn phiên bản chính mới nhất và xây dựng nhiều tính năng quan trọng hơn cho khách hàng.

Do đó, Nav/Driver SDK phiên bản 1.x hiện không được dùng nữa và sẽ không đượ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.

Navigation SDK và Driver SDK Android 21 và 22 kết thúc hỗ trợ

v1.15.3 (Ngày 9 tháng 10 năm 2020)

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

• Driver SDK hiện đăng ký Navigation SDK để nhận thông tin cập nhật về tình trạng giao thông, thông tin này được gửi đến Fleet Engine API.

Cải thiện độ ổn định và 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 tính năng báo cáo vị trí bị dừng trong phiên bản Fleet Engine, thì hướng dẫn sẽ bị 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.

Cải thiện độ ổn định và sửa lỗi

• Khắc phục một lỗi khiến ngoại lệ được đưa ra nếu phiên bản Fleet Engine bị xoá.

v1.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 tiến đáng kể trong việc báo cáo vị trí ổn định (giảm số lượng vị trí "bị kẹt"). Bản vá này giúp bạn tiếp tục sử dụng tính năng báo cáo vị trí được cải thiện. Vấn đề ANR không liên quan đến những điểm cải tiến này.

Cải thiện độ ổn định và sửa lỗi

• Khắc phục một lỗi đôi khi khiến đường thẳng ở đầu tuyến đường xuất hiện trong ứng dụng người dùng.
• Đã khắc phục một lỗi có thể dẫn đến lỗi ANR khi SDK báo cáo vị trí. Điều này là do 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 đá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 đề. Ứng dụng kiểm thử đã sửa đổi để tạo ra lỗi ANR chạy trong 8 giờ mà không gặp lỗi ANR sau khi được khắc phục.

v1.15.0 (Ngày 23 tháng 3 năm 2019)

Tính năng

• Giới thiệu trạng thái hướng dẫn chỉ đường khi bắt đầu, khi đi sai đường, khi đế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í được khớp với đường, bất kể trạng thái điều hướng.
• Thêm thông tin bổ sung về các vị trí chưa được điều chỉnh theo đường, chẳng hạn như độ chính xác.

Cải thiện độ ổn định và sửa lỗi

• Tăng minSdkVersion cho navsdk lên 19.
• Khắc phục một lỗi khiến tên Điểm tham chiếu theo vĩ độ/kinh độ không được tuân thủ khi tính năng địa lý mã hoá ngược phía máy chủ không hoạt động.

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 vị trí 0,0 đến Fleet Engine (cải thiện tính năng chia sẻ hành trình và đầu vào vị trí phân bổ).
• Thêm nhật ký để cải thiện các vấn đề về vị trí bị kẹt và giảm các trường hợp dự phòng cho tính nă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 thay đổi.
• Đã cập nhật javadoc cho phương thức setReportingInterval() với mục tiêu là ngăn chặn việc gọi lặp lại phương thức này với tốc độ cao so với các khoảng thời gian đang được sử dụng.
• Độ tin cậy của vị trí Api 29 đã được cải thiện.

v1.13.0

Cải thiện độ ổn định và sửa lỗi

• Thêm một phần phụ thuộc vào okhttp mà các ứng dụng sẽ phải thêm vào bản dựng gradle của chúng.

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

Cải thiện độ ổn định và sửa lỗi

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

v1.11.6 (Ngày 4 tháng 10 năm 2019)

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

• Đã triển khai một loạt thay đổi để đảm bảo Driver SDK nhanh chóng tiếp tục cập nhật vị trí sau khi mạng gặp sự cố. 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.

Cải thiện độ ổn định và sửa lỗi

• setVehicleState() hiện trả về ngay lập tức. Giờ đây, quá trình cập nhật FleetEngine diễn ra trên một luồng nền. Khắc phục vấn đề Ứng dụng không phản hồi (ANR).
• Khắc phục một 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 khi dùng các phiên bản cũ của Consumer SDK. Đảm bảo rằng Driver SDK không thêm điểm đánh dấu chỉ xuất hiện một lần vào tuyến đường.