实验性 API¶
Electron 的部分 API 在文档中被标记为 _Experimental_。
该标签表示该 API 可能不被视为稳定,并且与其他 API 相比,该 API 可能在较少警告的情况下更频繁地被移除或修改。
API 被标记为实验性的条件¶
任何人在功能 PR 中都可以请求将某个 API 标记为实验性。如果无法在 PR 中解决,关于某个功能实验性质的分歧可以在 API WG 中讨论。
移除实验性标签的流程¶
一旦某个 API 保持稳定,并且至少存在于两个主要稳定版本线中,就可以提名移除其实验性标签。此讨论应在 API WG 会议上进行。讨论/提名时需要考虑的事项:
- 必须满足上述“两个主要稳定版本线”条件
- 在此期间,采用该功能不应导致任何重大 bug / 问题
- 该 API 足够稳定,并且未受到 Chromium 升级的严重影响
- 是否有人在使用该 API?
- 该 API 是否满足了最初提议的使用场景?是否存在任何缺口?
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 el/electron