商用接入验收
本批交付用于客户接入和现场验收。自动化验证不替代真实卫星信号、手机厂商后台策略和道路播报验收。上线前使用客户自己的 Key、签名和域名,完成下表中的现场项目。
平台能力
| 场景 | Android SDK | JavaScript SDK |
|---|---|---|
| 已确认路线断网后继续 | 默认导航服务持有路线与本地语音,可继续引导 | 页面存活且语音准备为 ready 时,可沿原路线继续前台引导 |
| 离线偏航重算 | 依赖相应离线路网已下载及覆盖范围 | 当前不支持,需要联网 |
| 弱 GPS 或位置停止更新 | 暂停不可靠指引,等待准确位置恢复 | 暂停不可靠播报,恢复后继续 |
| 锁屏、退到后台 | 使用 SDK 前台导航服务及常驻通知;仍需厂商设备验证 | 浏览器可能暂停定位与音频,不承诺连续后台导航 |
| 新区域地图与地点搜索 | 受授权、缓存范围和网络状态限制 | 受授权、缓存范围和网络状态限制 |
| 断网与授权 | 临时断网不等于授权拒绝;缓存有时效,恢复网络后重新验证 | 正式域名需要独立授权;已准备页面不等于永久离线许可证 |
Android 接入步骤见后台导航与缓存。JS 语音预缓存、准备状态和限制见导航指南。地图、路线、语音和离线路网是不同资源,不应把其中一项准备完成显示为“全地图离线就绪”。
自动化与现场验收
本轮自动化覆盖独立应用授权、Android 导航及定位单元回归、JS 语音预缓存与导航恢复;Android 模拟器还检查断网启动已规划路线、弱定位恢复、锁屏后台跨越短期授权续期及恢复联网。实际通过结果随发布验证记录核对。
客户正式上线前应完成:
- 使用正式包名、发布证书或实际 HTTPS Origin 验证独立 Key;错误签名、错误域名、过期或停用授权应得到明确拒绝。
- 真实手机连续导航至少 30 分钟,记录定位精度、转向播报、到达、发热和耗电。
- 出发前完成路线及相应缓存准备,断网后沿线行驶,再测试恢复联网;另行确认偏航位置是否在已缓存路网内。
- 建筑旁或弱信号区域驶回开阔路段,确认不会使用旧位置继续报转弯,且恢复后无需重开导航。
- HOME、锁屏至少 5 分钟再回到页面,确认服务通知、定位与播报继续,结束导航后停止定位。
记录手机型号、系统、APK/SDK 版本、测试时段、预期与实际结果。现场操作由乘客进行;分享日志前去除 Key、令牌及非必要个人信息。真实道路与不同厂商后台行为仍需现场验收,未将模拟器测试标为实车通过。
客户交付边界
下载包提供 SDK 编译制品、公开接口声明、审核过的示例源码和许可证,不提供 SDK 原始实现工程、服务端业务源码、签名私钥或生产数据。浏览器代码和客户端二进制仍可被分析;关键授权与商业机密必须留在服务端。详见授权与交付边界。