1.2.8.1 API 版本和状态

优质

小牛编辑

138浏览

2023-12-01

Every published artifact has a version number <major>.<minor>.<patch>, and all publicly available interfaces, classes, and methods are annotated with @API from the @API Guardian project. The annotation’s status attribute can be assigned one of the following values.

Status Description

INTERNAL Must not be used by any code other than JUnit itself. Might be removed without prior notice.

DEPRECATED Should no longer be used; might disappear in the next minor release.

EXPERIMENTAL Intended for new, experimental features where we are looking for feedback.
Use this element with caution; it might be promoted to MAINTAINED or STABLE in the future, but might also be removed without prior notice, even in a patch.

MAINTAINED Intended for features that will not be changed in a backwards- incompatible way for at least the next minor release of the current major version. If scheduled for removal, it will be demoted to DEPRECATED first.

STABLE Intended for features that will not be changed in a backwards- incompatible way in the current major version (5.*).

Status	Description
`INTERNAL`	Must not be used by any code other than JUnit itself. Might be removed without prior notice.
`DEPRECATED`	Should no longer be used; might disappear in the next minor release.
`EXPERIMENTAL`	Intended for new, experimental features where we are looking for feedback. Use this element with caution; it might be promoted to `MAINTAINED` or `STABLE` in the future, but might also be removed without prior notice, even in a patch.
`MAINTAINED`	Intended for features that will not be changed in a backwards- incompatible way for at least the next minor release of the current major version. If scheduled for removal, it will be demoted to `DEPRECATED` first.
`STABLE`	Intended for features that will not be changed in a backwards- incompatible way in the current major version (`5.*`).

If the @API annotation is present on a type, it is considered to be applicable for all public members of that type as well. A member is allowed to declare a different status value of lower stability.