授权与交付边界
SDK 为商业授权软件。交付编译库及接入示例,不授予 SDK 实现源码、平台业务系统或运营数据的使用权。具体数据集、额度、有效期和应用范围以实际授权为准。
包含什么
- Android:7 个配套 Maven 模块及依赖描述;地图、定位、搜索、路线、内置导航和配送地图组件通过公开 API 调用。
- JavaScript:npm 编译包、类型声明及可直接部署的 browser 目录;须完整保留 Worker、语音和第三方许可证。
- 通用示例:Android 60 项、JavaScript 57 项功能案例的接入源码。
- 完整外卖配送示例:Android 选取送货点、测试订单、定位上传、取送货导航和二维码分享;H5 只读位置展示、选址和明确标注的模拟配送。
- 示例源码清单、模块版本、逐文件 SHA256 和公开接入文档。
示例源码可以作为客户接入参考;它不是 SDK 实现源码。SDK 的地图渲染、导航页面和语音继续由公共 SDK 提供,客户无需复制自有 App 的实现。
不包含什么
SDK 实现源码、源码包、Source Map、混淆映射、签名密钥、真实客户 Key、生产数据集、后台源码及内部运维材料不交付。Sukha 自有 App 的商户、订单、代理、采集审核、运营入口和专有地点卡片也不包含在客户包内。
普通地图地点名称、地址、坐标、类别、搜索和导航入口属于正常地图能力;不会为区分自有 App 而故意降低道路覆盖、精度或更新能力。编辑客户自己的覆盖物不等于获得修改 Sukha 基础地图的权限。
外卖业务由谁负责
SDK 提供地图、选址、定位、路线、导航与位置展示。客户平台负责订单、骑手身份、租户隔离、状态流转、位置上传与访问权限。
示例连接独立的 24 小时测试转发服务,不连接 Sukha 生产订单系统。公开演示 APK 中的演示 Key 仅用于其绑定应用;客户源码包中只有配置占位符。正式接入须使用自己的授权 Key,并将测试订单及位置转发接口替换为自己的服务。二维码分享的是只读查看凭据,不应包含写入令牌。
主题、语言与权限
SDK 支持中文、英文、缅文及日间、夜间、自动主题。Android 内置导航跟随宿主当前主题;宿主仅支持日间时,导航保持日间,不按时钟强行切换。通用 Android 示例演示宿主主题切换,外卖示例目前采用日间宿主主题。
SDK 授权不包含管理员、商户、代理或订单权限。服务端负责校验授权及业务权限,客户端开关、包名字符串和页面隐藏不能自行授予权限。客户端二进制和 JavaScript 可以被分析,编译和压缩不等于无法逆向。
接入顺序
- 下载配套交付包,核对 SHA256、versions.json 与 manifest.json。
- 按示例 README 配置自己的应用包名、签名或网页 Origin 和授权 Key。
- 先运行通用示例,再按业务需要接入外卖案例;不要混用历史模块。
- 配置正式签名和自己的业务接口,在实际设备验证定位、后台运行与导航播报。