S苏哈出行开发者文档

授权与交付边界

SDK 为商业授权软件。交付编译库及接入示例,不授予 SDK 实现源码、平台业务系统或运营数据的使用权。具体数据集、额度、有效期和应用范围以实际授权为准。

包含什么

示例源码可以作为客户接入参考;它不是 SDK 实现源码。SDK 的地图渲染、导航页面和语音继续由公共 SDK 提供,客户无需复制自有 App 的实现。

不包含什么

SDK 实现源码、源码包、Source Map、混淆映射、签名密钥、真实客户 Key、生产数据集、后台源码及内部运维材料不交付。Sukha 自有 App 的商户、订单、代理、采集审核、运营入口和专有地点卡片也不包含在客户包内。

普通地图地点名称、地址、坐标、类别、搜索和导航入口属于正常地图能力;不会为区分自有 App 而故意降低道路覆盖、精度或更新能力。编辑客户自己的覆盖物不等于获得修改 Sukha 基础地图的权限。

外卖业务由谁负责

SDK 提供地图、选址、定位、路线、导航与位置展示。客户平台负责订单、骑手身份、租户隔离、状态流转、位置上传与访问权限。

示例连接独立的 24 小时测试转发服务,不连接 Sukha 生产订单系统。公开演示 APK 中的演示 Key 仅用于其绑定应用;客户源码包中只有配置占位符。正式接入须使用自己的授权 Key,并将测试订单及位置转发接口替换为自己的服务。二维码分享的是只读查看凭据,不应包含写入令牌。

主题、语言与权限

SDK 支持中文、英文、缅文及日间、夜间、自动主题。Android 内置导航跟随宿主当前主题;宿主仅支持日间时,导航保持日间,不按时钟强行切换。通用 Android 示例演示宿主主题切换,外卖示例目前采用日间宿主主题。

SDK 授权不包含管理员、商户、代理或订单权限。服务端负责校验授权及业务权限,客户端开关、包名字符串和页面隐藏不能自行授予权限。客户端二进制和 JavaScript 可以被分析,编译和压缩不等于无法逆向。

接入顺序

  1. 下载配套交付包,核对 SHA256、versions.json 与 manifest.json。
  2. 按示例 README 配置自己的应用包名、签名或网页 Origin 和授权 Key。
  3. 先运行通用示例,再按业务需要接入外卖案例;不要混用历史模块。
  4. 配置正式签名和自己的业务接口,在实际设备验证定位、后台运行与导航播报。

下载 SDK 和示例 · 核对交付版本