已过时 API(Web IMLib)
本页列出 Web IMLib 中已标记为「已过时」的类、方法与枚举。判定依据是 IDL 中的 deprecated 标记,而不是文档人工备注。
当前 IDL 无已过时 API
冻结 IDL v1.0.0 中没有任何 operation 或 schema 字段带 deprecated 标记;因此本页当前为空清单。这不是省略,而是生成器对全部 103 个语义操作逐项检查后的结论。
检查范围
| 对象 | 数量 | 检查方式 | 结果 |
|---|---|---|---|
| IDL 语义操作 | 103 | sdk-imlib.json → operations[].deprecated | 0 个已过时 |
| 平台绑定签名 | 103 | sdk-bindings.json → bindings.web.imlib.methodMap | 与 IDL 一一对应,无孤立签名 |
| 数据结构字段 | 214 | domain.json → schemas[].fields[].deprecated | 0 个已过时 |
| 枚举 | 14 | domain.json → enums / errors.json → codes | 0 个已过时 |
已过时 API 列表
没有已过时 API。
当前平台的全部类、方法、枚举与数据字段均为现行契约。
过时策略
为了让「已过时 API」在文档中心始终可用且诚实,本项目采用如下约定:
- 在 IDL 中标记
在
sdk-imlib.json的 operation 上增加"deprecated": true,可选"deprecatedReason"与"replacedBy";schema 字段同理。 - 自动生成到本页
生成器逐项扫描 IDL:带标记的方法会出现在本页清单,并在类页的详细成员说明中显示「已过时」徽标与替代方案。
- 绑定保持兼容
平台绑定在下一个主版本前保留原签名;新增替代方法属于 additive 变更,旧调用继续可用。
- 版本与公告
给接入方
升级 SDK 前先查看本页与更新日志;出现「已过时」徽标的方法不会立即删除,但不会再增加新能力。