本部分包含 Android 版驱动程序 SDK 的版本说明。
v5.0.0(2023 年 9 月 12 日)
依赖项和配置更改
- 将 Navigation SDK 更新到了 v5.x。
- 将
minSdkVersion
升级到了 API 23。 - 将 Kotlin 版本升级到了 1.9.0。
- 为 Room 添加了依赖项。
- 现在,使用驱动程序 SDK 的应用必须采用 API 31 或更高级别的
targetSdkVersion
。 - 使用驱动程序 SDK 的应用现在必须启用 Java 8 库支持。如需了解更新说明,请访问 https://developer.android.com/studio/write/java8-support。
- 使用 Proguard 或 Dexguard 的应用必须迁移到 R8。如需了解详情,请参阅 https://developer.android.com/build/shrink-code。
- 使用驱动程序 SDK 的应用必须启用脱糖。如需了解相关说明,请参阅 https://developer.android.com/studio/write/java8-support#library-desugaring。
bug 修复
- 修复了与 disableLocationTracking 同步相关的问题。
- 引入了新的 DriverStatusListener 接口,可在异常状态更新中报告原因。
- 修复了驱动程序保持不动的问题(从 v4.99.0 开始提供)。
v4.99.0(2023 年 8 月 9 日)
- 支持一系列版本的 NavSDK 依赖项。** 支持 v4.5.0 及更低版本(但不包含 v5.0.0)。
- 防止在车辆静止时缩短预计到达时间。此变更会以实验的形式逐步推出,因此并非所有应用都会同时看到此变更。
v4.5.0(2023 年 5 月 12 日)
- 将 Navigation SDK 依赖项更新为 v4.5。请注意,Navigation SDK 的组 ID 和工件 ID 已更改。
v4.4.3(2023 年 3 月 20 日)
依赖项更改
- 将 Navigation SDK 依赖项升级到 v4.4.1。
v4.4.2(2023 年 2 月 15 日)
bug 修复
缩短了 SDK 遇到临时连接问题时的网络恢复时间。此功能目前处于实验阶段。
舍弃仅包含“原始”位置的
UpdateVehicle
请求。修复了“Route Overview”ALPHA API 中的竞态条件问题。
v4.4.1(2022 年 11 月 18 日)
bug 修复
- 修复了流量上传逻辑中的 bug。
其他更改
- 对请求标头和状态代码报告进行了内部改进。
v4.4.0(2022 年 9 月 21 日)
bug 修复
- 修复了在未清除 API 实例的情况下无法移除“使用 Google 地图驾车”通知的错误。
依赖项更改
- 将 Navigation SDK 依赖项升级到 v4.2.2。
v4.3.0(2022 年 8 月 24 日)
内部改进。
通知:冻结对 Android 5 的支持(2022 年 7 月 21 日)
针对我们的最新 SDK 版本 (v4.2.0),我们将针对在 Android 5 上运行的应用,针对 API 级别 21 和 22 额外延长一年支持时间。
这意味着:
- 在 2023 年 6 月 30 日之前,您的 Android 应用上运行的 Navigation SDK 和驱动程序 SDK 将支持 Android 5(API 级别 21)或更高版本。
- 2023 年 6 月 30 日之后,我们将仅支持 Android API 级别 23 及更高级别。换言之,在该日期之后,我们将停止在所有 SDK 版本中支持 Android API 级别 21 和 22。这意味着,任何 SDK 版本(包括 4.x)中与 Android 21 或 22 相关的 bug 都不会得到修复,并且我们不保证 SDK 会正常运行。
此通知会替换自 2021 年 6 月 21 日起发布的 Android 21 和 Android 22 支持冻结通知,以及自 2021 年 10 月 18 日起对 Android 23、24 和 25 的支持冻结通知。
v4.2.0(2022 年 6 月 8 日)
依赖项更改
- 将 Nav SDK 依赖项升级到 v4.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 更新
在此版本中,Android 版驱动程序 SDK 已更新,并进行了以下更改。
VehicleStops API 更改
VehicleStop
对象现在会引用 TaskInfo
对象的列表,而不是 Task
对象的列表。如果您需要任务状态,建议您在应用代码中跟踪该状态。
已添加新课程:
TaskInfo
将
VehicleStop
的getTasks
函数替换为了getTaskInfoList
函数。将
VehicleStop.Builder
的setTasks
函数替换为了setTaskInfoList
函数。
崩溃监控
添加了崩溃监控和报告,以帮助提升 SDK 的稳定性。此功能默认处于启用状态,但在初始化 SDK 之前,您可以调用 setAbnormalTerminationReportingEnabled()
并向其传递 false
值,从而停用它。
- 向
DriverApi
添加了setAbnormalTerminationReportingEnabled
函数。
异步 getRemainingVehicleStops
- 更改了
DeliveryVehicleReporter
的getRemainingVehicleStops
函数,以返回 Future<List<VehicleStop>>,而不是 List<VehicleStop>。
身份验证
从 AuthTokenContext
接口中移除了不必要的属性。废弃了 ServiceType
。现在,您只需获取所包含的车辆 ID 和任务 ID 的声明,而无需依赖于 ServiceType
。
从
AuthTokenContext
中移除了ServiceType
。从
AuthTokenContext
中移除了getServiceType()
。从
AuthTokenContext.Builder
中移除了setServiceType
。
2021 年 10 月 18 日 - 冻结对 API 级别 23、24 和 25 的支持
阅读 10 月 18 日的公告
为了应对内部依赖项的变化,从 2022 年第三季度开始,新版 Navigation SDK 和适用于 Android 的驱动程序 SDK 将不再支持 Android API 级别 23、24 和 25(Android 6、7.0 和 7.1)。
2022 年第三季度开始发布的适用于 Android 版本的 Navigation SDK 和驱动程序 SDK 将仅支持搭载 Android API 级别 26 或更高级别的设备。
使用 Android 版导航和驱动程序 SDK v4.x 或更低版本构建的应用版本将继续在搭载 Android API 级别 25 及更低版本的设备上使用。
v3.0.4(2021 年 7 月 28 日)
特性
在此版本中,驱动程序 SDK 与 Navigation SDK 已正式分离。如需了解详情,请参阅迁移指南。
API 更新
添加了以下方法:
RidesharingDriverApi.getDriverSdkVersion()
稳定性和问题修复
报告 PERMISSION_DENIED
错误,而不是将其归类为连接错误。
弃用公告(2021 年 6 月 21 日)
本公告介绍了自上述日期起弃用 Android 版驱动程序 SDK 和 Android 版 Navigation SDK 的功能。我们还以重要服务通告 (MSA) 的形式向受影响的客户发送了此通知。
适用于 Android 的导航/驱动程序 SDK 将变为适用于 Android 的 Navigation SDK v3.x 和适用于 Android 的驱动程序 SDK v3.x(拆分二进制文件)
为了简化客户集成并加快提供实用功能的能力,我们将 Navigation SDK for Android 和 Driver SDK for Android 拆分为两个不同的二进制文件:
- Navigation SDK for Android,为您的驱动程序提供导航/路由功能。
- 驱动程序 SDK for Android,可让您利用 Fleet Engine 有状态 Web 服务进行行程或任务进度和分配。
请注意,Android 驱动程序 SDK 必须依赖于 Navigation SDK for Android 才能实现核心路由功能。
有哪些变化?
v3 中的主要变更包括:
- 两个二进制文件,而不是一个。
- 为 Android 版驱动程序 SDK 类提供更清晰的软件包定义。
- Navigation SDK for Android 的软件包中包含 Maps SDK for Android(自 Navigation SDK for Android v2 起)。
- 这样一来,地图和导航功能就可以共存于同一地图上(例如,在 NavigationView 上绘制多段线),而且由于只使用一个地图而不是两个地图,因此可以减少内存用量。
- Navigation SDK for Android 3.0 不具备与 Navigation SDK for Android 完全对等的功能,但 v3.2 可解决此处的大多数问题。如需了解详情,请参阅我该怎么办?以及何时?。
- 通过日志记录功能,我们可以更轻松地调试您可能遇到的问题。
以下方法在 v3 中也已移除,它们之前被标记为已废弃,并且已有替代解决方案:
- 以下 Nav/Driver SDK 方法已在 v1.16 中废弃(于 2020 年 8 月 10 日发布),并在 v3.0 中移除:
Waypoint#fromLatLng(*)
Waypoint#fromPlaceId(*)
Navigator#startGuidance(resumeIntent)
NavigationApi#initForegroundServiceManager(*)
- 为完整和明确起见,请注意,在 v1 到 v2 的过渡中,我们移除了许多方法。其中大部分功能都是整合了 Navigation SDK for Android 和 Maps SDK for Android 之间的重复类。请参阅迁移指南以更好地了解这些变更。
废弃了适用于 Android 的驱动程序 SDK 和适用于 Android 的 Navigation SDK v1.x
Nav/Driver SDK v1 是在 2018 年发布的,v3 版本很快就会发布,因此是时候弃用 v1,以免无法持续支持许多主要版本。
我们不必支持这个额外的版本,从而节省了时间,让我们能够更好地支持最新的主要版本,并构建更多对客户重要的功能。
因此,Nav/Driver SDK v1.x 现已废弃,2022 年 6 月 21 日之后将不再进行维护。
请花点时间了解 SDK 版本弃用机制。
停止支持 Navigation 和 Driver SDK Android 21 和 22
阅读已撤消的通知
即将推出的 4.0 版 Navigation SDK for Android 和适用于 Android 的驱动程序 SDK 将至少支持 [Android 6.0(API 级别 23)](https://developer.android.com/studio/releases/platforms#6.0){: .external}。 目前支持的最低版本是 Android 5.0(API 级别 21)。我们预计在 2021 年第 4 季度发布 4.0 版。这意味着:
- 使用 v4.x 之前的版本构建的应用版本仍可在 Android 21 和 22 设备上使用。集成了我们当前 SDK 的驱动程序应用将继续在搭载 Android 21 及更高版本的设备上运行。这与以前一样。
- 使用 Android 版驱动程序 SDK 和 Navigation SDK for Android v4.x(针对 2021 年第 4 季度,可能会发生变化)及之后使用 Android 2 构建的应用版本无法安装在搭载 Android 21 和 22 的设备上。v4.x 将在搭载 Android 6.0(API 级别 23)或更高版本的设备上运行,因此使用未来版本 4 及更高版本的驱动程序构建的应用版本将同时实现。
下表说明了您要升级到 Android v3 的 Navigation SDK 版本和适用于 Android v3 的驱动程序 SDK 版本,以及这些版本何时推出。
您使用哪些驱动程序平台功能? | 您是否使用这些功能? | 那么,您应该升级到的首个可用版本是... | 预计收到款项的时间 (可能会发生变化) |
迁移链接 |
---|---|---|---|---|
仅限导航 (NavSDK 方法) |
不支持 | NavSDK v3.0.1 | 现在 | 指南 |
是 | NavSDK v3.5(预计) | 2021 年 9 月 | ||
导航和舰队引擎跟踪(NavSDK 和 DriverSDK 方法) | 不支持 | Nav SDK v3.0 和驱动程序 SDK v3.0 | 驱动程序 v3.0 迁移指南已发布 | |
是 | NavSDK v3.x 和 DriverSDK v3.0 |
如需继续使用已移除的方法,您可以继续使用 v1.x,但在 2022 年 6 月 21 日之后不需要获得支持或维护(请参阅下一部分)。
我们建议您迁移到 3.x 版。这意味着:
* v1.x 的最后一次版本将于 2021 年第 4 季度发布(自此之后,v1 便处于“功能冻结”状态)。
* 最后一个版本可在此后 6 个月内进行修补,直至 2022 年 6 月 21 日。 在此之后,我们将无法回复 v1.x 的错误或功能请求。
请花点时间查看下表和 [迁移指南](/maps/documentation/navigation-sdk-android/v2/migration),以便熟悉这些更改。
在什么时间之前我可以做些什么?
如果您目前使用的是... | 您是否使用这些功能? | 立即升级 | 在 2021 年 9 月升级 | 迁移链接 |
---|---|---|---|---|
v1.x (未使用 FleetEngine.java / 驱动程序功能) |
不支持 | NavSDK v3.0 | 指南 | |
是 | 无选项 | NavSDK 3.x | ||
v1.x (使用 FleetEngine.java / 驱动程序功能) |
不支持 | 无选项 | NavSDK 3.x + DriverSDK 3.x |
上述指南,以及发布时提供的驱动程序 v3.0 迁移指南。 |
是 |
我们建议您先通知驱动程序搭载 Android 21 和 22 的设备升级到较新的 Android 版本(最低 Android 6.0),然后再将 Android 版驱动程序 SDK 和 Android 版 Navigation SDK v4.x 及更高版本集成到驱动程序应用中。
v1.15.3(2020 年 10 月 9 日)
API 更新
- 驱动程序 SDK 现在会订阅 Navigation SDK,以获取将发送到 Fleet Engine API 的路况更新信息。
稳定性和问题修复
- 修复了 gRPC 运行时崩溃问题。
v1.15.2
特性
添加了停止常驻通知的功能。如果在 Fleet Engine 实例中停止位置报告,导航会在 Navigator
中停止,所有导航监听器都会取消注册,并且 NavigationFragment
或 NavigationView
会暂停。
稳定性和问题修复
- 修复了在清除 Fleet Engine 实例时导致抛出异常的 bug。
v1.15.1(2020 年 5 月 12 日)
特性
对 1.15.0 数据的初步分析表明,稳定位置报告得到了显著改进(减少了“卡住”的位置)。此补丁修复支持继续改进位置信息报告功能。这次 ANR 问题与这些改进无关。
稳定性和问题修复
- 修复了以下 bug:有时会导致路线起点处有一条直线显示在使用方应用中。
- 修复了在 SDK 报告位置信息时可能会导致 ANR 的 bug。这得益于容易受到锁争用的
onArrival()
改进。我们能够在某些情况下可靠地重现 ANR,并能够验证修复是否解决了问题。在修复此问题后,经过修改的测试应用用于生成 ANR 问题已经运行了 8 小时,没有出现 ANR 错误。
v1.15.0(2019 年 3 月 23 日)
特性
- 针对开始、偏离路线、到达事件引入了导航指导状态,以改进车辆位置跟踪。
- 添加了独立于导航状态继续获取道路被覆盖位置的功能。
- 添加了与道路前贴靠位置有关的更多信息,例如准确度。
稳定性和问题修复
- 将 navsdk 的 minSdkVersion 提高到了 19。
- 修复了导致服务器端反向地理编码失败时不遵循纬度/经度航点名称的 bug。
v1.14.2 版本(2019 年 2 月 2 日)
特性
- 阻止 DriverSDK 向 Fleet Engine 发送 0,0 个位置信息(更好地共享和分配位置信息输入)。
- 添加了额外的日志记录,用于改善卡住位置问题,并减少行程共享的回退。
- 除非间隔时间发生变化,否则忽略对
setLocationReportingInterval()
的重复调用。 - 更新了
setReportingInterval()
方法的 javadocs,旨在阻止以高速率(相对于所使用的时间间隔)重复调用此方法。 - 提高了 API 29 的位置可靠性。
v1.13.0
稳定性和问题修复
- 添加 okhttp 的依赖项,客户端必须将其添加到其 Gradle build 中。
v1.11.7(2019 年 10 月 18 日)
稳定性和问题修复
- 现在,针对给定目的地触发
onArrival()
后,位置信息更新继续。 - 默认通知(自由导航模式下的常量字符串)与为导航通知设置的配色方案一致。如需了解详情,请参阅共享的持久性通知。
- 解决了延迟位置信息更新事件可能导致错误的位置信息更新,进而导致路线起点处出现直线等伪影的问题。
v1.11.6(2019 年 10 月 4 日)
API 更新
- 引入了一系列更改,确保驱动程序 SDK 在发生网络故障后快速恢复位置信息更新。网络连接恢复后,位置信息更新将在下一次计划的位置信息更新时再次启动。
稳定性和问题修复
setVehicleState()
现在会立即返回。FleetEngine 现在的更新在后台线程上进行。解决了应用无响应 (ANR) 问题。- 修复了导致使用旧版消费者 SDK 的行程共享路线显示为直线的问题。确保驱动程序 SDK 不会向路线添加一次性航点。