Android 版 Driver SDK 版本資訊

本節提供 Android 適用的 Driver SDK 版本資訊。

v7.99.0 (2026 年 11 月 11 日)

修正錯誤

  • 修正問題：如果中繼電信業者 Proxy 在連線設定期間停滯，嘗試與 Fleet Engine 建立安全連線時，可能會無限期處於待處理狀態，導致行程狀態和車輛追蹤更新無法在特定行動網路上重新整理。Driver SDK 現在會強制執行連線逾時，並自動在新連線上復原。

  • 修正呼叫 DriverApi.clearInstance() (FleetEngineEventHandler、FusedLocationWriter 和 DriverApi 執行器) 時，執行緒和執行器外洩的問題。

依附元件和設定變更

  • 將 Jetpack DataStore 依附元件 (androidx.datastore:datastore-core 和 androidx.datastore:datastore-guava) 升級至 1.2.1 版。

  • 將 Kotlin 依附元件版本升級至 2.4.0 版。

  • 更新支援的 Navigation SDK 版本範圍至 [7.9.0, 8.0.0)。

v7.1.0 (2026 年 5 月 14 日)

依附元件和設定變更

  • 新增 Jetpack DataStore 依附元件：androidx.datastore:datastore-core 1.1.7 版和 androidx.datastore:datastore-guava 1.2.0 版。

  • 將 Kotlin 依附元件版本升級至 2.3.0 版。

  • 將 Android Gradle 外掛程式升級至 8.13.2 版。

  • 將 Gradle 升級至 8.13 版。

  • 將 Desugar 程式庫升級至 2.1.5 版。

  • 支援的 Navigation SDK 版本範圍從 [7.0, 7.3) 擴大至 [7.0, 8.0)。

v7.0.0 (2025 年 12 月 5 日)

依附元件和設定變更

  • 將 minSdkVersion 升級至 API 26。

  • 將 targetSdkVersion 升級至 API 36。

  • 更新 Navigation SDK 支援的版本範圍，包括 7.0.0 版及以上版本。

v6.99.0 (2025 年 12 月 5 日)

  • 內部改善

公告：停止支援 API 級別 23、24 和 25

根據行動作業系統版本支援政策，我們將在即將推出的 Driver SDK for Android 主要版本中，停止支援 Android 6 和 7 (API 級別 23、24 和 25)。

自 7.0.0 版起，Android 專用 Driver SDK 支援的最低版本為 Android 8 (API 級別 26)。舊版 SDK 將繼續支援 Android 6 和 7。

如果依附元件未指定版本號碼，IDE 會載入最新的 SDK 版本，且應用程式的新版本將不支援 Android 6 和 7。

在應用程式的建構依附元件中，指定 Driver SDK for Android 版本，即可控管何時提高新版應用程式的最低支援 OS 版本。

v6.2.0 (2025 年 6 月 18 日)

修正錯誤

  • 修正未提供 DriverStatusListener 時，呼叫 DriverApi.createInstance() 導致 NullPointerException 異常終止的問題。

依附元件和設定變更

  • 自 Android 版 Driver SDK 6.2.0 版起，應用程式必須升級至 Kotlin 2.1。

  • 更新 Navigation SDK 支援的版本範圍，包括 6.1.0 以上版本。

v6.1.0 (2025 年 3 月 10 日)

修正錯誤

  • 改善內部記錄功能。

v5.99.1 (2025 年 1 月 10 日)

修正錯誤

  • 修正問題：司機收到 gRPC 錯誤，代碼為「INTERNAL」，並顯示「Panic! 安裝後首次啟動應用程式時，會顯示「這是一個錯誤！」說明。

v6.0.0 (2024 年 11 月 25 日)

修正錯誤

  • 修正問題：司機收到 gRPC 錯誤，代碼為「INTERNAL」，並顯示「Panic! 這是錯誤！」說明。
  • 內部改善，減少位置更新連線錯誤，特別是在裝置切換網路時。整合版本後，系統會逐步推出 (從 0% 開始)。

API 更新

  • 移除已淘汰的介面 StatusListener。

依附元件和設定變更

  • 移除 POM.xml 中對 glide:cronet-integration 的依附元件
  • 更新 Navigation SDK 支援的版本範圍至 5.x 版。
  • 自 Android 專用 Driver SDK 6.0.0 版起，應用程式必須升級至 Kotlin 2.0。
  • targetSdk 現在是 API 級別 34。自 2024 年 8 月起，所有部署至 Google Play 商店的應用程式都必須符合這項規定。請參閱「符合 Google Play 的目標 API 級別規定」。

v5.99.0 (2024 年 9 月 20 日)

修正錯誤

  • 修正問題：司機收到 gRPC 錯誤，代碼為「INTERNAL」，並顯示「Panic! 這是錯誤！」說明。整合版本後，系統會逐步推出 (從 0% 開始)。
  • 內部改善，減少位置更新連線錯誤，特別是在裝置切換網路時。整合版本後，系統會逐步推出 (從 0% 開始)。

依附元件和設定變更

  • 移除 POM.xml 中對 glide:cronet-integration 的依附元件

v5.0.0 (2023 年 9 月 12 日)

依附元件和設定變更

  • 將 Navigation SDK 更新至 5.x 版。
  • minSdkVersion 升級至 API 23。
  • 將 Kotlin 升級至 1.9.0 版。
  • 新增 Room 依附元件。* 使用 Driver SDK 的應用程式現在必須具備 API 31 以上版本的 targetSdkVersion。
  • 使用 Driver SDK 的應用程式，現在必須支援 Java 8 程式庫。如需更新操作說明，請參閱 https://developer.android.com/studio/write/java8-support。
  • 使用 Proguard 或 Dexguard 的應用程式必須遷移至 R8。詳情請參閱 https://developer.android.com/build/shrink-code。
  • 使用 Driver SDK 的應用程式必須啟用脫糖功能。https://developer.android.com/studio/write/java8-support#library-desugaring

修正錯誤

  • 修正 disableLocationTracking 同步處理問題。
  • 推出新的 DriverStatusListener 介面，可在例外狀況狀態更新中回報原因。
  • 修正司機保持靜止的問題 (自 v4.99.0 起提供)。

v4.99.0 (2023 年 8 月 9 日)

  • 支援 NavSDK 依附元件的多個版本。** 支援 4.5.0 版至 5.0.0 版 (不含)。
  • 防止車輛靜止時預計到達時間自行減少。這項異動會逐步推出，因此並非所有應用程式都會同時看到這項異動。

v4.5.0 (2023 年 5 月 12 日)

  • 將 Navigation SDK 依附元件更新至 4.5 版。請注意，Navigation SDK 的群組和構件 ID 已變更。

v4.4.3 (2023 年 3 月 20 日)

依附元件變更

  • 將 Navigation SDK 依附元件升級至 4.4.1 版。

v4.4.2 (2023 年 2 月 15 日)

修正錯誤

  • 縮短 SDK 遇到暫時連線問題時的網路復原時間。這是實驗性修正。

  • 捨棄僅包含「原始」位置的 UpdateVehicle 要求。

  • 修正「路線總覽」Alpha 版 API 的競爭狀況。

v4.4.1 (2022 年 11 月 18 日)

修正錯誤

  • 修正流量上傳邏輯中的錯誤。

其他異動

  • 改善要求標頭和狀態碼回報功能。

v4.4.0 (2022 年 9 月 21 日)

修正錯誤

  • 修正了以下錯誤：如果未清除 API 執行個體，就無法移除「使用 Google 地圖行車」通知。

依附元件變更

  • 將 Navigation SDK 依附元件升級至 4.2.2 版。

v4.3.0 (2022 年 8 月 24 日)

內部改善。

公告：停止支援 Android 5 (2022 年 7 月 21 日)

針對最新 SDK 版本 (4.2.0 版)，我們將為在 Android 5 (API 級別 21 和 22) 上執行的應用程式，額外提供一年的支援。

具體情況：

  • 2023 年 6 月 30 日前，在 Android 應用程式上執行的 Navigation SDK 和 Driver SDK，最低支援 Android 5 (API 級別 21)。
  • 2023 年 6 月 30 日後，我們僅支援 Android API 級別 23 以上版本。也就是說，自該日期起，我們將停止在所有 SDK 版本中支援 Android API 級別 21 和 22。也就是說，任何 SDK 版本 (包括 4.x) 中與 Android 21 或 22 相關的錯誤都不會修正，我們也不保證 SDK 能正常運作。

本通知會覆寫 2021 年 6 月 21 日發布的 Android 21 和 22 支援凍結通知，以及 2021 年 10 月 18 日發布的 Android 23、24 和 25 支援凍結通知。

v4.2.0 (2022 年 6 月 8 日)

依附元件變更

  • 將 Nav SDK 依附元件升級至 4.1.3 版。
  • 將支援的 Android API 最低級別降至 21。

v4.1.0 (2022 年 4 月 28 日)

API 更新

  • 將 Task 物件的 parentId 屬性重新命名為 trackingId。舊屬性目前仍存在，但已淘汰。

v4.0.0 (2021 年 11 月 29 日)

這個版本支援的最低 Android API 級別為 23。

API 更新

這個版本的 Driver SDK for Android 有下列異動。

VehicleStops API 異動

VehicleStop 物件現在會參照 TaskInfo 物件清單，而非 Task 物件清單。如需工作狀態，建議您在應用程式程式碼中追蹤。

當機監控

新增當機監控和回報功能，有助於提升 SDK 穩定性。這項功能預設為啟用，但您可以在初始化 SDK 前呼叫 setAbnormalTerminationReportingEnabled() 並傳遞 false 值，藉此停用這項功能。

非同步 getRemainingVehicleStops

驗證

從 AuthTokenContext 介面中移除不必要的屬性。ServiceType 已淘汰。現在，您只需要取得包含車輛 ID 和任務 ID 的請求，而不必依賴 ServiceType。

2021 年 10 月 18 日：停止支援 API 級別 23、24 和 25

閱讀 10 月 18 日的公告

為因應內部依附元件的異動，自 2022 年第三季起，新版 Navigation SDK for Android 和 Driver SDK for Android 將不再支援 Android API 級別 23、24 和 25 (Android 6、7.0 和 7.1)。

2022 年第三季起推出的 Android 版 Navigation 和 Driver SDK，僅支援搭載 Android API 級別 26 以上版本的裝置。

以 Navigation and Driver SDKs for Android 4.x 以下版本建構的應用程式版本，會繼續在搭載 Android API 級別 25 以下版本的裝置上運作。

v3.0.4 (2021 年 7 月 28 日)

功能

這個版本正式將 Driver SDK 與 Navigation SDK 分開。詳情請參閱遷移指南。

API 更新

新增了下列方法：

`RidesharingDriverApi.getDriverSdkVersion()`

提升穩定性及修正錯誤

回報 PERMISSION_DENIED 錯誤，而不是將其歸類為連線錯誤。

淘汰公告 (2021 年 6 月 21 日)

本公告說明自上述日期起，Android 適用的 Driver SDK 和 Navigation SDK 淘汰情形。我們也向受影響的客戶發布了重大服務公告 (MSA)。

為簡化客戶整合程序，並加快提供實用功能，我們將 Android 版 Navigation SDK 和 Android 版 Driver SDK 拆分為兩個不同的二進位檔：

  • Navigation SDK for Android：為司機提供導航/路線規劃功能。
  • Driver SDK for Android：可讓您運用 Fleet Engine 有狀態網路服務，追蹤行程或任務進度及分配。

請注意，Driver SDK for Android 必須依附 Navigation SDK for Android，才能使用核心路線規劃功能。

有哪些異動？

第 3 版的主要異動如下：

  • 兩個二進位檔，而非一個。
  • 更清楚定義 Driver SDK for Android 類別的套件。
  • Navigation SDK for Android 包含 Maps SDK for Android，做為套件的一部分 (自 Navigation SDK for Android 第 2 版起)。
    • 這樣一來，地圖和導航功能就能在地圖上並存 (例如在 NavigationView 上繪製折線)，而且由於只使用一個地圖，因此能減少記憶體用量。
    • Navigation SDK for Android 3.0 的功能與 Navigation SDK for Android 不完全相同，但 3.2 版會解決大部分問題。詳情請參閱「我能做什麼？何時能做？」。
  • 記錄功能，方便我們偵錯您可能遇到的問題。

下列方法先前已標示為淘汰，且已有替代解決方案，因此也已在第 3 版中移除：

  • 下列 Nav/Driver SDK 方法已於 2020 年 8 月 10 日發布的 1.16 版中淘汰，並已在 3.0 版中移除：
    • Waypoint#fromLatLng(*)
    • Waypoint#fromPlaceId(*)
    • Navigator#startGuidance(resumeIntent)
    • NavigationApi#initForegroundServiceManager(*)
  • 為求完整和清楚，請注意，從第 1 版轉換至第 2 版時，我們移除了多個方法。其中大部分是整合 Navigation SDK for Android 和 Maps SDK for Android 之間的重複類別。請參閱遷移指南，進一步瞭解這些異動。

Driver SDK for Android 和 Navigation SDK for Android 1.x 版淘汰

Nav/Driver SDK 第 1 版於 2018 年推出，隨著第 3 版即將發布，我們決定淘汰第 1 版，避免因支援多個主要版本而造成不永續的情況。

由於不必支援這個額外版本，我們將有更多時間，能更妥善地支援最新主要版本，並建構更多對客戶重要的功能。

因此，Nav/Driver SDK 1.x 版現已淘汰，2022 年 6 月 21 日後將不再維護。

請花點時間瞭解 SDK 版本淘汰機制的運作方式。

閱讀撤銷公告

即將推出的 Navigation SDK for Android 和 Driver SDK for Android 4.0 版，最低支援 [Android 6.0 (API 級別 23)](https://developer.android.com/studio/releases/platforms#6.0){: .external}。目前支援的最低版本為 Android 5.0 (API 級別 21)。我們預計在 2021 年第 4 季發布 4.0 版。也就是說：

  • 以 4.x 版之前版本建構的應用程式版本，將繼續在 Android 21 和 22 裝置上運作。如果司機應用程式已整合目前的 SDK，則在搭載 Android 21 以上版本的裝置上，仍可繼續運作，這與先前相同。
  • 使用 Driver SDK for Android 和 Navigation SDK for Android 4.x 版 (預計 2021 年第 4 季推出，可能會有異動) 以上版本建構的應用程式版本，將無法安裝在搭載 Android 21 和 22 的裝置上。4.x 版最低可在 Android 6.0 (API 級別 23) 上執行，因此使用即將推出的 4.x 版建構的應用程式版本，只能由搭載 Android 23 以上版本裝置的司機接收。重申一次，這表示我們與 SDK 相關的變更，以及您所做的任何應用程式變更，都不會影響搭載 Android 21 和 22 裝置的司機。

下表說明您要升級的 Navigation SDK for Android 第 3 版和 Driver SDK for Android 第 3 版，以及這些版本的推出時間。

您使用哪些 Driver 平台功能？ 您是否使用這些功能？ 那麼您應該升級的第一個可用版本是... 預計推出時間
(可能會有變動)		 遷移連結
僅限導航
(NavSDK 方法)		 否 NavSDK 3.0.1 版 現在 使用指南
是 NavSDK 3.5 版 (預計) 2021 年 9 月
導航和 Fleet Engine 追蹤 (NavSDK 和 DriverSDK 方法) 否 Nav SDK 3.0 版和 Driver SDK 3.0 版 發布時提供驅動程式 v3.0 遷移指南
是 NavSDK 3.x 版和 DriverSDK 3.0 版

如要繼續使用已移除的方法，您可以繼續使用 v1.x，但 2022 年 6 月 21 日之後將不再提供支援或維護服務 (請參閱下一節)。

建議您改用 v3.x。也就是說：

* 第 1.x 版的最後一個版本將於 2021 年第 4 季推出 (因此第 1 版從那時起「功能凍結」)。

* 最終版本在發布後 6 個月內 (2022 年 6 月 21 日前) 仍可修補。此後，我們將無法回應 v1.x 的錯誤或功能要求。

請花點時間查看下表和 [遷移指南](/maps/documentation/navigation-sdk-android/v2/migration)，瞭解這些異動。

我該在何時採取什麼行動？

如果目前使用... 您是否使用這些功能？ 立即升級 2021 年 9 月升級 遷移連結
v1.x
(不使用 FleetEngine.java/Driver 功能) 		否 NavSDK 3.0 版 使用指南
是 沒有選項 NavSDK 3.x
v1.x
(使用 FleetEngine.java/Driver 功能)		 否 沒有選項 NavSDK 3.x +
DriverSDK 3.x		 上述指南，以及發布時提供的 Driver 3.0 版遷移指南。
是

建議您通知使用 Android 21 和 22 裝置的司機，將裝置升級至較新的 Android 版本 (最低 Android 6.0)，再將 Driver SDK for Android 和 Navigation SDK for Android 4.x 以上版本，整合至司機應用程式。

v1.15.3 (2020 年 10 月 9 日)

API 更新

  • Driver SDK 現在會訂閱 Navigation SDK 的路況更新，並傳送至 Fleet Engine API。

提升穩定性及修正錯誤

  • 修正 gRPC 執行階段當機問題。

v1.15.2

功能

新增停止持續通知的功能。如果 Fleet Engine 執行個體停止回報位置，Navigator 會停止導航，所有導航事件監聽器都會取消註冊，且 NavigationFragment 或 NavigationView 會暫停。

提升穩定性及修正錯誤

  • 修正 Fleet Engine 執行個體清除時，會擲回例外狀況的錯誤。

v1.15.1 (2020 年 5 月 12 日)

功能

1.15.0 資料的初步分析顯示，穩定位置回報功能有顯著改善 (「卡住」的位置減少)。這個修補程式可讓改良後的位置回報功能繼續運作。ANR 問題與這些改善措施無關。

提升穩定性及修正錯誤

  • 修正錯誤：消費者應用程式有時會在路線起點顯示直線。
  • 修正 SDK 回報位置時可能導致 ANR 的錯誤。這是因為 onArrival() 改進項目容易發生鎖定爭用。我們在某些情況下能夠可靠地重現 ANR，並確認修正程式已解決問題。修正後，用於產生 ANR 的修改測試應用程式執行了八小時，未發生 ANR。

v1.15.0 (2019 年 3 月 23 日)

功能

  • 在開始、偏離路線、抵達事件中，導入導航指引狀態，改善車輛位置追蹤功能。
  • 新增功能，可繼續取得與導航狀態無關的道路貼齊位置。
  • 新增預先貼齊道路位置的其他資訊，例如準確度。

提升穩定性及修正錯誤

  • 將 navsdk 的 minSdkVersion 提高至 19。
  • 修正錯誤：伺服器端反向地理編碼失敗時，系統不會採用經緯度路線控點名稱。

v1.14.2 版本 (2019 年 2 月 2 日)

功能

  • 防止 DriverSDK 將 0,0 位置傳送至 Fleet Engine (改善行程分享和分配位置輸入)。
  • 新增記錄功能，改善位置卡住的問題，並減少行程分享的備用方案。
  • 除非間隔變更，否則請忽略重複呼叫 setLocationReportingInterval()。
  • 更新 setReportingInterval() 方法的 JavaDoc，避免以高於所用間隔的頻率重複呼叫此方法。
  • 提升 API 29 定位可靠性。

v1.13.0

提升穩定性及修正錯誤

  • 新增 okhttp 依附元件，用戶端必須將其新增至 Gradle 建構。

v1.11.7 (2019 年 10 月 18 日)

提升穩定性及修正錯誤

  • 現在，onArrival() 針對特定目的地觸發後，位置更新通知作業會繼續進行。
  • 預設通知 (自由導航模式中的常數字串) 會與導航通知設定的色彩配置相符。詳情請參閱「共用永久通知」。
  • 修正問題：位置更新事件延遲可能導致位置更新通知錯誤，進而產生路線開頭出現直線等不自然現象。

v1.11.6 (2019 年 10 月 4 日)

API 更新

  • 推出一系列異動，確保 Driver SDK 在網路故障後能快速恢復位置更新。網路連線恢復後，位置更新通知會在下一次排定的位置更新通知時重新開始。

提升穩定性及修正錯誤

  • setVehicleState() 現在會立即傳回。FleetEngine 現在會在背景執行緒中更新。解決應用程式無回應 (ANR) 問題。
  • 修正問題：使用舊版 Consumer SDK 時，行程分享路線會顯示為直線。確保 Driver SDK 不會在路線中加入一次性路線控點。