semantic-versioning - "public api"在语义版本控制中意味着什么？

Question

我正在学习如何使用 http://semver.org/ 中名为“语义版本控制”的规则来分配和增加版本号。 .

在其所有规则中，第一条是:

Software using Semantic Versioning MUST declare a public API. This API could be declared in the code itself or exist strictly in documentation. However it is done, it should be precise and comprehensive"

我对“公共(public) API”感到困惑。它指的是什么？

Answer 1

公共(public) API 是指外部世界(用户、其他程序和/或程序员等)对您的软件的“访问点”。

例如，如果您正在开发一个库，则公共(public) API 是可以对您的库进行的所有方法调用的集合。

据了解，除非主要版本发生更改，否则您的 API 将向后兼容，即在某个版本上有效的所有调用都将在更高版本上有效。您可以阅读这些规则的第 9 点:

Major version X (X.y.z | X > 0) MUST be incremented if any backwards incompatible changes are introduced to the public API.