已过时 API(Electron IMLib)

本页列出 Electron IMLib 中已标记为「已过时」的类、方法与枚举。判定依据是 IDL 中的 deprecated 标记,而不是文档人工备注。

当前 IDL 无已过时 API

冻结 IDL v1.0.0 中没有任何 operation 或 schema 字段带 deprecated 标记;因此本页当前为空清单。这不是省略,而是生成器对全部 103 个语义操作逐项检查后的结论。

检查范围​

对象数量检查方式结果
IDL 语义操作103sdk-imlib.json → operations[].deprecated0 个已过时
平台绑定签名103sdk-bindings.json → bindings.electron.imlib.methodMap与 IDL 一一对应,无孤立签名
数据结构字段214domain.json → schemas[].fields[].deprecated0 个已过时
枚举14domain.json → enums / errors.json → codes0 个已过时

已过时 API 列表​

没有已过时 API。

当前平台的全部类、方法、枚举与数据字段均为现行契约。

过时策略​

为了让「已过时 API」在文档中心始终可用且诚实,本项目采用如下约定:

  1. 在 IDL 中标记

    在 sdk-imlib.json 的 operation 上增加 "deprecated": true,可选 "deprecatedReason" 与 "replacedBy";schema 字段同理。

  2. 自动生成到本页

    生成器逐项扫描 IDL:带标记的方法会出现在本页清单,并在类页的详细成员说明中显示「已过时」徽标与替代方案。

  3. 绑定保持兼容

    平台绑定在下一个主版本前保留原签名;新增替代方法属于 additive 变更,旧调用继续可用。

  4. 版本与公告

    变更随 IDL 版本冻结,并在 更新日志 与 站点更新日志 中公告。

给接入方

升级 SDK 前先查看本页与更新日志;出现「已过时」徽标的方法不会立即删除,但不会再增加新能力。

相关链接​