OpenHarmony开发者论坛

标题: API一致性与文档更新 [打印本页]

作者: yangws 时间: 2024-4-9 19:44
标题: API一致性与文档更新
随着OpenHarmony版本的迭代，GPIO相关的API是否保持了良好的向后兼容性？对于已弃用或即将变更的API，官方如何及时通知开发者并提供迁移指南？现有的GPIO驱动开发文档是否涵盖了所有最新的特性和最佳实践？如果开发者发现文档与实际代码存在出入，应通过何种渠道反馈以促进文档的及时更新？

作者: dragon 时间: 2024-4-10 13:42
标题: API一致性与文档更新
好问题！
我从轻量系统角度回答。

随着OpenHarmony版本的迭代，GPIO相关的API是否保持了良好的向后兼容性？
-- 在OH 1.0时期，IoT接口是完善的。但是从1.0.1开始，到现在，IoT接口是残缺的。例如，IoSetFunc()函数；再比如，ADC相关API。但是从1.0.1到现在，IoT接口基本没变。可以认为“保持了良好的兼容性”。

对于已弃用或即将变更的API，官方如何及时通知开发者并提供迁移指南？
-- 目前并没有主动推送功能，把变更及时推送到开发者。官方迁移指南目前我没有看到，但是我总结了从1.X到4.0的适配指南。

现有的GPIO驱动开发文档是否涵盖了所有最新的特性和**实践？
-- 官网文档基本涵盖最新特性。**实践参考：https://growing.openharmony.cn/mainPlay/learnPath/?developmentRole=1

如果开发者发现文档与实际代码存在出入，应通过何种渠道反馈以促进文档的及时更新？
-- 这种情况很常见。可以提交issue。
(, 下载次数: 3)

欢迎光临 OpenHarmony开发者论坛 (https://forums.openharmony.cn/)