知识卡片

普通读书笔记卡 · 3203.a

公共库优先依赖稳定API

理解等级:高级

公共库一旦把遥测调用编进自身,许多应用会间接依赖该 API。稳定功能适合原生嵌入,让应用装入 SDK 后即可取得埋点;实验功能宜作为可选插件,使其破坏性变更不拖累普通用户升级。这是公共库依赖面的治理原则,是否某功能已稳定仍要按目标语言及版本核对。

这张卡片看不懂?

已有反馈 · 0 / 10 条

    还没有人提交反馈。

    原书出处

    参考来源

    - 位置:《OpenTelemetry 可观测性的未来》第6章《稳定和长期支持》(源文件:_epub-src/index_split_059.html) - 结论依据:原文建议 OSS 库原生仪表只使用稳定 API,实验性集成作为用户另装的可选插件,功能稳定后再考虑原生集成。 - 原始内容:携带原生 OpenTelemetry 仪表的 OSS 库应该只使用稳定的 API,因为实验性功能的改变可能会造成依赖性冲突。……我们建议将与实验性 OpenTelemetry 功能的集成作为可选的插件提供,终端用户必须单独安装才能启用。