Robin SDK

Appearance

Robin SDK上层 SDK API 文档

面向 Android、iOS、Harmony、PC 的统一接入文档

查看 API 参考
查看接入流程

四端统一 API

Android、iOS、Harmony、PC 对外使用同一套上层 SDK API 语义，平台差异仅存在于语言桥接层。

生命周期明确

文档按 bootstrap、login、业务调用的统一接入链组织，接入方可以清楚知道每个接口的前置条件与状态变化。

能力边界真实

当前页面仅展示 robin-sdk-next 已冻结或已开放的能力范围，区分可接入接口与规划中接口，避免文档先于能力失真。

产品定位 ​

Robin SDK 是面向客户端业务接入的统一能力层。
文档主视角不是底层 transport 或 Rust public facade，而是四端一致的上层 SDK API。

接入方应理解为：

  • 先完成 bootstrap
  • 再完成 login
  • 最后进入账号、联系人、会话、消息、群组、文件等业务能力

接入链路 ​

推荐按以下顺序完成 Robin SDK 接入：

  1. 调用 bootstrap 初始化 SDK 运行时环境。
  2. 调用 login 建立当前用户会话与授权状态。
  3. 登录完成后，再调用资料、联系人、会话、消息、群组、文件等业务接口。

当前开放能力 ​

当前首批上层 SDK API 以统一模块方式提供：

  • 运行时：bootstrap
  • 鉴权登录：login
  • 账号：getProfile
  • 好友：getProfile、list
  • 联系人：resolveDirectory、search
  • 会话：getSnapshot
  • 消息：getTimeline
  • 群组：sync
  • 文件：prepareTransfer

文档阅读方式 ​

阅读单个 API 页面时，重点关注这些信息：

  • 一句话用途说明：这个接口解决什么业务问题
  • 注意事项：调用前提、状态限制和典型误用
  • 支持说明：四端平台可用性与当前开放状态
  • 输入 / 输出：上层 SDK 参数与返回值语义
  • 状态与前置条件：该接口要求先完成什么、成功后进入什么状态