Zephyr开发指南——API生命周期

API生命周期

使用Zephyr的API的开发人员需要知道他们能相信一个给定的API在未来的版本中不会改变多久。与此同时，维护和扩展Zephyr的api的开发人员需要能够引入尚未完全验证的新api，并可能在旧api不再最优或被底层平台支持时退出它们。

图2API生命周期

所有API及其成熟度级别的最新表可以在API概览页面中找到。

实验

实验api表示最近引入了一个特性，并可能在未来的版本中更改或删除。尝试一下，并通过开发者的邮件列表向社区提供反馈。

以下要求适用于所有新的api：

• API（使用情况）的文档，解释其设计和假设，如何使用它，当前的实现限制，以及未来的潜力，如果合适的话。
• API的引入应该伴随着所述API的至少一个实现(在外围设备API的情况下，这对应于一个驱动程序)
• 至少有一个样本使用新的API（只能构建在一个板上）

外设api（硬件相关）

当为一个新的外围设备或驱动程序子系统引入一个API（带有文档的公共报头文件）时，对API的审查是强制执行的，并由由来自不同供应商的代表组成的API工作组驱动。

当API在不同的硬件平台上至少有两个实现时，应提升为不稳定。

不稳定

API正在解决过程中，但还没有足够的实际测试被