本節包含 Consumer SDK for Android 的版本資訊。
2.3.0 (2024 年 8 月 2 日)
API 變更
新增雲端式地圖樣式設定支援功能,可讓您為使用者打造自訂道路地圖體驗,這樣您每次變更地圖樣式時,就不用再更新應用程式的程式碼。詳情請參閱「使用雲端式地圖樣式設定地圖樣式」一文。
將
getServerTimeMillis()
方法新增至VehicleLocation
,以判斷 Fleet Engine 收到位置更新的時間。
2.2.0 (2024 年 5 月 7 日)
API 變更
- 新增 Jetpack Compose 整合的支援 API。這是實驗性質的功能。如要進一步瞭解如何與 Jetpack Compose 整合,請洽詢您的業務代表。
2.1.0 (2024 年 1 月 17 日)
修正錯誤
- 修正在應用程式生命週期內 SDK 初始化超過一次時發生的當機問題。
API 變更
- 導入擷取 SDK (
ConsumerGoogleMap.getGoogleMap()
) 建立的GoogleMap
例項的方法。 - 引入 API 來擷取由 SDK 建立的
Marker
例項,以代表車輛 (ConsumerController.getConsumerMarker()
)。 - 推出 API,可在行程分享期間接收用戶端預測的時間和距離更新資訊 (
ProjectedRouteEta
)。
1.99.2 (2023 年 11 月 3 日)
修正從與應用程式分開的遠端程序初始化 SDK 時發生的當機問題。
修正執行相機動畫時發生的當機問題,且沒有足夠的垂直或水平空間可用於邊框。這只會發生在最新的地圖轉譯器上。
修正當第二段行程經過相同道路時,會導致回程行程的第一段行程遭到裁剪的錯誤。
問題
- 如果 API 執行個體已存在,則
ConsumerApi.initialize()
會擲回例外狀況。如要解決這個問題,請先呼叫ConsumerApi.getInstance()
,然後評估傳回的Task
,判斷 API 例項是否已存在。
2.0.0 (2023 年 9 月 15 日)
公告:破壞性變更
最低 API 級別規定已從 21 更新為 23。
將 Maps SDK 版本要求從 17.0.0 版更新至 18.1.0 版
Kotlin 標準程式庫最低版本需求已從 1.6.10 版更新至 1.9.0 版
更新 Google Play 服務依附元件版本
最低的 play-services-base 程式庫版本需求從 18.0.1 更新為 18.2.0
play-services-basement 程式庫最低版本需求已從 18.0.0 版更新為 18.2.0 版
最低的 play-services-location 資料庫版本需求已從 17.0.0 版更新為 21.0.1 版
最低的 play-services-tasks 程式庫版本需求已從 18.0.1 更新為 18.0.2
新增 androidx.room:room-runtime 程式庫,並將最低版本需求設為 2.5.2 版
更新下列依附元件版本
最低 android-maps-utils 程式庫版本需求從 v0.4.2 更新為 v3.5.2
最低 com.google.android.datatransport:transport-backend-cct 版本需求從 3.0.0 更新為 3.1.9
最低 com.google.android.datatransport:transport-runtime 版本需求已從 v3.0.1 更新為 v3.1.9
androidx.lifecycle:lifecycle-extensions 的最低版本需求已從 2.0.0 更新為 2.2.0
androidx.lifecycle:lifecycle-common-java8 最低版本需求從 2.0.0 更新為 2.6.1
androidx.appcompat:appcompat 最低版本要求已從 1.0.0 版更新至 1.6.1 版
androidx.fragment:fragment 的最低版本需求已從 v1.0.0 更新為 v1.6.1
移除下列先前已淘汰的 API:
ConsumerTrip
、ConsumerTripCallback
、ConsumerTripManager
、ConsumerTripOptions
。這些元素已由TripModel
、TripModelCallback
、TripModelManager
和TripModelOptions
取代。使用 Consumer SDK 的應用程式現在必須
targetSdkVersion
API 31 以上,compileSdkVersion
API 33 以上。使用 Consumer SDK 的應用程式現在必須啟用 Java 8 程式庫支援功能。如需更新操作說明,請參閱 https://developer.android.com/studio/write/java8-support。
使用 ProGuard 或 Dexguard 的應用程式必須遷移至 R8。詳情請參閱 https://developer.android.com/build/shrink-code。
使用 Consumer SDK 的應用程式必須啟用 desugaring。如需操作說明,請前往 https://developer.android.com/studio/write/java8-support#library-desugaring。
如果是已建立 API 執行個體時叫用,
ConsumerApi.initialize()
方法現在會擲回例外狀況。由ConsumerApi.getInstance()
傳回的Task
必須用來判斷是否有事先建立的 API 執行個體。
公告:API 淘汰事宜
淘汰
Trip.TripStatus
和Trip.TripType
註解類別,新增TripInfo.TripStatus
和TripInfo.TripType
註解類別加以取代。在本次異動中,
TripModelCallback#onTripStatusUpdated(TripInfo tripInfo, @Trip.TripStatus int status)
已淘汰,並新增TripModelCallback#onTripStatusUpdate(TripInfo tripInfo, @TripInfo.TripStatus int status)
取代之。為配合這項變更,
TripInfo#getTripStatus()
已淘汰,並新增了TripInfo#getCurrentTripStatus()
來取代。在本次異動中,
TripInfo#getTripType()
已淘汰,TripInfo#getCurrentTripType()
已新增用來取代。
淘汰
Trip
類別。
其他變更和錯誤修正
支援要求最新的 Maps SDK 轉譯器。詳情請參閱「新版地圖轉譯器」一文。
提供從 18.1.0 版 (含) 到 19.0.0 版 (含) 的 Maps SDK 範圍支援。
修正 SDK 和 Google 後端之間內部通訊的「已超過期限」錯誤。
修正小型螢幕和子母畫面模式的算繪問題。
遷移指南
1.99.1 (2023 年 8 月 31 日)
修正錯誤
修正 SDK 主機活動或片段刪除時發生的當機問題。
修正 MapView 尺寸為 0 (高度或寬度) 時發生的異常終止問題。
修正在路線多邊形上投射車輛位置時發生的當機問題。
改善項目
- 在主機應用程式側載,且沒有預設的視覺資源的情況下,防止 SDK 當機。
1.99.0 (2023 年 6 月 22 日)
修正錯誤
修正小螢幕和子母畫面模式的算繪問題。
修正行程分享期間車輛閃爍的問題。
1.2.1 (2023 年 6 月 7 日)
修正錯誤
- 修正行程分享期間車輛閃爍的錯誤。
1.2.0 (2022 年 11 月 21 日)
修正錯誤
- 修正導致
onTripActiveRouteTrafficUpdated
回呼回報空白流量的錯誤。
新功能
- 「交通狀況感知多邊形」功能現已正式推出。
1.1.2 (2022 年 10 月 27 日)
修正錯誤
- 修正錯誤:如果
TripModel
的JourneySharingSession
啟動次數超過一次,路線多邊形就會消失。
公告:Android 5 的支援服務即將停止 (2022 年 7 月 25 日)
針對 v1.1.1 SDK 版本,我們將額外支援一年,支援在 Android 5 上執行的應用程式,同時支援 API 級別 21 和 22。
也就是說:
在 Android 應用程式上執行的 Consumer SDK 將支援 Android 5 (API 級別 21) 以上版本,直到 2023 年 6 月 30 日為止。
2023 年 6 月 30 日後,我們只會支援 Android API 級別 23 以上版本。也就是說,在該日期後,我們將停止支援所有 SDK 版本,包括 Android API 級別 21 和 22。也就是說,系統不會修正任何 SDK 版本 (包括 4.x) 中與 Android 21 或 22 相關的錯誤,我們無法保證 SDK 能正常運作。
第 1.1.1 版 (2022 年 7 月 25 日)
依附元件變更
- 將支援的最低 Android API 級別降級至 21。
v1.1.0 (2022 年 4 月 28 日)
- 內部改善措施。
v1.0.19 (2022 年 3 月 17 日)
修正錯誤
- 修正
ConsumerApi
類別中的記憶體流失問題。
第 1.0.14 版 (2021 年 11 月 30 日)
目前支援的最低 Android API 級別為 23。
API 變更
ConsumerTrip
和ConsumerTripManager
類別的變更。- 清理部分方法名稱,讓名稱更明確,並與 iOS 平台保持一致。
ConsumerTripCallback
、ConsumerTrip
和TripInfo
的變更。變更部分類別名稱,使其與 iOS 保持一致。推出
TripModel
、TirpModelManager
和TripModelOptions
,淘汰ConsumerTrip
、ConsumerTripManager
和ConsumerTripOptions
。清除部分方法名稱。修訂或新增方法的 JavaDoc 註解,以便更清楚地表達意義。
改善錯誤處理機制。
自訂樣式
已淘汰的舊版包裝函式
MarkerStyleOptions
和PolylineStyleOptions
已淘汰,並由MarkerOptions
和PolylineOptions
取代,兩者皆與 Maps SDK 共用。
當機監控
新增當機偵測和記錄功能。
- 我們新增了一項功能,可讓您選擇停用這項功能。這是為了進行更廣泛的全球異動監控作業而採取的做法。
驗證變更
- 從驗證介面中移除不必要的方法。
- 已移除
ServiceType
參數。
- 已移除
v0.9.28 (2021 年 5 月 18 日)
API 變更
- 已更新所有
ConsumerTripCallback
方法,以使用TripInfo
做為參數。 - 新增
ConsumerTrip.isRefreshing()
,用於指出ConsumerTrip
是否會主動更新來自 Fleet Engine 的最新行程資訊。 - 新增了
ConsumerTripCallback.onTripRemainingRouteDistanceUpdated()
。 - 新增了
ConsumerTripCallback.onTripRemainingRouteUpdated()
。 - 將 Guava 傳回類型 (
ImmutableSet
、ImmutableList
) 替換為java.util
同等類別。 套件名稱變更:
- com.google.android.libraries.ridesharing.common.AuthTokenContext -> com.google.android.libraries.ridesharing.consumer.auth.AuthTokenContext
- com.google.android.libraries.ridesharing.common.AuthTokenFactory -> com.google.android.libraries.ridesharing.consumer.auth.AuthTokenFactory
com.google.android.libraries.ridesharing.common.FleetEngineServiceType -> com.google.android.libraries.ridesharing.consumer.auth.FleetEngineServiceType - com.google.android.libraries.ridesharing.common.model.Trip
-> com.google.android.libraries.ridesharing.consumer.model.Trip - com.google.android.libraries.ridesharing.common.model.Vehicle -> com.google.android.libraries.ridesharing.consumer.model.Vehicle
導入方式異動
- 修正競爭狀況,即 SDK 在地圖準備就緒前與地圖互動時可能會當機。
- SDK 不再包含未經模糊處理的
io.grpc
副本。 - 修正特定裝置發生交通折線閃爍錯誤。流量區段現在會以圓角結尾。
0.9.15 版 (2020 年 10 月 7 日)
API 變更
- 這個版本推出了車流量感知折線功能。- 新增了
TripInfo.getActiveRouteTraffic()
和TripInfo.getRemainingRouteTraffic()
。- 新增
ConsumerTripCallback.onTripActiveRouteTrafficUpdated()
和ConsumerTripCallback.onTripRemainingRouteTrafficUpdated()
,用於指出流量變更的時間。 - 新增
PolylineStyleOptions
以自訂流量 (setTrafficEnabled()
、setTrafficColorNoData()
、setTrafficColorNormal()
、setTrafficColorSlow()
、setTrafficColorTrafficJam()
)。 - 已公開
PolylineStyleOptions.TRAFFIC_Z_INDEX_ADDITION
。 - 新增了
TripWaypoint.getTrafficData()
。 - 已新增
TrafficData
資料類型。 - 已新增《
ConsumerController.hideAllSessions()
》。ConsumerController.showSession()
不再接受空值做為引數。
- 新增
0.9.9 版 (2020 年 7 月 15 日)
API 變更
- 這是一項重大變更,其導入的模組化架構在純資料層層 (例如
ConsumerTripManager
) 和使用者介面層 (例如JourneySharingSession
) 之間的關係更明確。如要瞭解如何遷移至新架構,請參閱模組化遷移指南。-ConsumerTrip
物件現在是從ConsumerTripManager.getTrip()
取得。ConsumerTrip.unregisterCallback
已重新命名為ConsumerTrip.unregisterTripCallback
。ConsumerTrip.isCallbackRegistered
已重新命名為ConsumerTrip.isTripCallbackRegistered
。- 新增
ConsumerTrip.setConsumerTripOptions()
和ConsumerTrip.getConsumerTripOptions()
。 - 已移除
ConsumerTrip.setAutoRefreshInterval()
。
- 移除非旅程分享 API。
- 已移除車輛密度地圖。
- 移除行程預覽狀態。
- 已移除上車選項狀態。
- 已移除下車點選取狀態。
- 已移除下列標記類型:
SELECTED_PICKUP_POINT
、SUGGESTED_PICKUP_POINT
、HIGHLIGHTED_PICKUP_POINT
和SELECTED_DROPOFF_POINT
。
- 將
OnConsumerMarkerClickCallback
和ConsumerMapReadyCallback
從介面變更為抽象類別。 - 新增了
ConsumerController.getCameraUpdate()
、ConsumerController.isAutoCameraEnabled()
和ConsumerController.enableAutoCamera()
。 - 移除自訂 FAB 及其相關方法 (
ConsumerController.isMyLocationFabEnabled
和ConsumerController.setMyLocationFabEnabled
)。
導入方式異動
- 無論是否已註冊
LifecycleOwner
,ConsumerTripCallback
都不會再自動取消註冊TripStatus.COMPLETE
或TripStatus.CANCELED
。 - 自動相機現在預設為啟用,且絕不會自行重新啟用或停用。
先前,AutoCamera 會在
TripStatus.ARRIVED_AT_PICKUP
上自動重新啟用,並在使用者在分享歷程期間與地圖互動時,自動停用。 - 我們對行程共用車輛動畫進行了以下改善:
- 瀏覽歷程分享動畫現在會處理車輛在已週遊路線上合法返回的情況。
- 如果系統透過演算法判斷出適合的地點,車輛現在會以直線方式呈現直線,而不是路徑在各個點之間進行內插。
FINE_LOCATION
權限不再需要。
其他變更
- 已更新下列依附元件版本:
- com.google.android.datatransport:transport-api:2.2.0
- com.google.android.datatransport:transport-backend-cct:2.2.0
- com.google.android.datatransport:transport-runtime:2.2.0
第 0.9.1 版 (2020 年 3 月 23 日)
API 變更
- 已新增
TripInfo.getVehicleId()
、TripInfo.getNumberOfPassengers()
、TripInfo.getIntermediateDestinationIndex()
、TripInfo.getTripActiveRoute()
和TripInfo.getTripRemainingRoute()
。 - 新增
options
類別,用於ConsumerApi
初始化期間,讓FleetEngine
地址可動態設定。如果 API 未以FleetEngine
值呼叫,則會嘗試從 Android 資訊清單擷取該值,否則會改用預設值。
改善項目
- 行程狀態為
ARRIVED_AT_PICKUP
時,系統不會顯示路線多邊形。 - 改善了偏離路線的車輛追蹤功能 (須使用 DriverSDK 1.15):
- 車輛追蹤功能在車輛駛過上車地點後,不會將車輛固定在路線上。
- 車輛追蹤功能可讓您顯示車輛是否在道路上,例如在未繪製的停車場內。
- 當駕駛人的目的地與 Fleet Engine 中的目的地不同時,車輛圖示現在會更新。
v0.8.6 版 (2019 年 12 月 16 日)
API 變更
新增了
TripInfo.getVehicleLocation()
。「
ConsumerMapView
」已非最終定案,
導入方式異動
- 系統現在會使用伺服器距離 (駕駛員回報的距離 + 適用的靜態路線),而非本機對齊功能,來計算有效路段的剩餘距離。這項變更可產生更準確的剩餘距離值。
其他變更
需要新的依附元件。詳情請參閱 .pom 檔案。
- com.google.android.datatransport:transport-api:2.0.0
- com.google.android.datatransport:transport-backend-cct:2.0.2
- com.google.android.datatransport:transport-runtime:2.0.0
新增行程要求延遲時間的記錄。
新增行程回應錯誤的記錄。
附註
- 自 0.8.1 版起,Android 消費者 SDK 會以 Jetified ZIP 封存檔的形式提供。如要進一步瞭解如何取消 Jetify,請參閱「Jetifier:反向模式」。
v0.8.1 (2019 年 9 月 13 日)
新功能
支援 ConsumerMapView。
ODRD 構件現在會送達 Maven 存放區,而非 .aar ZIP 檔案。詳情請參閱「在應用程式中加入 Consumer SDK」。
API 變更
新增
ConsumerController.disableAutoCamera()
做為centerMapForState()
的反向函式。VehicleLocation.getUpdateTime()
現在會傳回代表時間戳記 (以毫秒為單位) 的 Long。簡化
AuthTokenFactory
介面,公開單一方法用於產生符記。將AuthTokenFactory
從介面變更為抽象類別,以便在 Java 7 中啟用回溯相容性。這項變更具有回溯相容性,但用於產生單一服務權杖的舊有方法已淘汰,最終會移除。
實作變更
素材資源現已置於圖示中央,並消除陰影偏移。
setState
至JOURNEY_SHARING onStartTripMonitoring()
,而非等待監控的旅程狀態。即使行程資料不同步,系統仍會一律傳回首次行程資料更新的資料。
將 Android 地圖公用程式新增為提供的依附元件。
修正錯誤
- 修正了針對 grpc keep 的 ProGuard 匯出語法錯誤。
0.7.0 版 (2019 年 8 月 7 日)
新功能
- 支援行程分享的多目的地功能。
API 變更
ConsumerTripCallback
的新方法。onTripIntermediateDestinationsUpdated()
。onTripETAToNextTripWaypointUpdated()
。
新的
ConsumerController
方法。getIntermediateDestinations()
。setIntermediateDestinations(List<TerminalLocation> intermediateDestinations)
。
新的
TripStatuses
。TripStatus.ENROUTE_TO_INTERMEDIATE_DESTINATION
。TripStatus.ARRIVED_AT_INTERMEDIATE_DESTINATION
。
新增
TripWaypoint
getter。getETAMillis()
。getDistanceMeters()
。
新增
TripInfo
類別。- 您可以使用
ConsumerTripManager.getActiveTripInfo()
取得目前行程的TripInfo
。
- 您可以使用
新增了
WaypointType.INTERMEDIATE_DESTINATION
。新增了
MarkerType.TRIP_INTERMEDIATE_DESTINATION
。從已合併的
ConsumerMapStates
ENROUTE_TO_PICKUP
、ARRIVED_AT_PICKUP
、ENROUTE_TO_DROPOFF
和COMPLETE
建立ConsumerMapState.JOURNEY_SHARING
。「
StateChangeCallbacks
」已更新。新增了
onStateJourneySharing()
。已移除
onStateWaitingForPickup()
、onStateDriverArrived()
、onStateEnroute()
和onStateEndofTrip()
。
修正錯誤
修正在行程監控功能開始於行程進行中 (而非路線起點) 時,路線不會裁剪至車輛位置的錯誤。
修正錯誤:在 TripManager 擷取行程資料後,註冊於 Tripmanager 的事件監聽器不會叫用行程回呼。
相機縮放現在只包含有效路線和下一個行程路線點 (屬於行程的路線點)。即使能看到剩餘的路段,縮放功能也不會納入該路段。先前,當車輛在前往接送地點的途中,或已抵達接送地點時,系統會在縮放畫面中加入下車地點。但現在已非如此。
改善項目
使用 Driver 資料填入第 0 個剩餘路線點 (剩餘路線點清單會從
ConsumerTripCallback.onTripRemainingWaypointsUpdated
和TripInfo.getRemainingWaypoints()
傳回)。在清單中的第一個路線控點變更時,更新所有其餘路線控點的預計到達時間。
只在駕駛人抵達上車地點時強制重新啟用自動相機。先前,每次行程狀態變更時,自動相機都會重設為啟用。根據預設,Autocamera 仍會啟用。如果未設定對
startTripMonitoring()
未發出新呼叫,就設定了新的有效行程,自動相機不會重新啟用。
v0.6.1 (2019 年 6 月 26 日)
新功能
- 共乘功能支援行程分享。
API 變更
ConsumerController.getConsumerMapStyle()
現在會傳回ConsumerMapStyle
,而不是Task<ConsumerMapStyle>
。新增了
PolylineStyle.setZIndex()
。
修正錯誤
路線動畫現在只會在路線路段同步時顯示,進而改善使用者體驗。
修正當駕駛人位置更新相近時,在動畫內插動畫期間會「閃爍」。
已修正以下錯誤:在有效行程中途啟動行程監控時,車輛從路線的頭部開始,而不是從最更新的位置啟動。
當使用中的路線與其他路線重疊時,請在其他路線上方顯示使用中的路線折線。
改善項目
- 現在,請使用未經模糊處理的方法公開 gRPC
Status
類別。
0.5.1.01 版 (2019 年 5 月 17 日)
新功能
- 支援連續分享旅程。
API 變更
- 新增
ConsumerController
類別。
PolylineType
舊值 | 新值 |
---|---|
TRIP_PREVIEW_AUTO_ROUTE |
PREVIEW_AUTO_ROUTE |
TRIP_PREVIEW_TAXI_ROUTE |
PREVIEW_TAXI_ROUTE |
TRIP_PREVIEW_TRUCK_ROUTE |
PREVIEW_TRUCK_ROUTE |
TRIP_PREVIEW_TWO_WHEELER_ROUTE |
PREVIEW_TWO_WHEELER_ROUTE |
TRIP_ROUTE |
ACTIVE_ROUTE |
REMAINING_ROUTE |
ConsumerTripCallback
舊值 | 新值 |
---|---|
onTripRouteUpdated |
onTripActiveRouteUpdated |
onTripRemainingDistanceUpdated |
onTripActiveRouteRemainingDistanceUpdated |
onTripRemainingWaypointsUpdated() |
ConsumerController
- 您現在可以設定狀態的回呼,而無須輸入狀態。
方法 | 回撥電話 |
---|---|
startPickupSelection |
setPickupSelectionCallback |
startDropoffSelection |
setDropoffSelectionCallback |
startTripPreview |
setTripPreviewSelectionCallback |
ConsumerController.setLanguage(String languageCode)
可讓您設定 FleetEngine 呼叫使用的語言 (例如上車地點說明)。
改善項目
- 下車地點選取狀態現在有可拖曳的圖釘。
- 已移除
INITIALIZE
狀態中的攝影機動畫。 - 已將
ManagedChannelBuilder
取代為AndroidChannelBuilder
。