Annotation Type UnstableApi
-
@Target({ANNOTATION_TYPE,CONSTRUCTOR,METHOD,TYPE,PACKAGE}) @Documented @UnstableApi public @interface UnstableApi
A marker for public classes and methods that are not part of the stable API exposed by an artifact. Even if the artifact itself is stable (i.e., it has a version number with no suffix such as-alpha), the marked API has no stability guarantees. It may be changed in a backwards incompatible manner, such as changing its signature, or removed entirely without any prior warning or period of deprecation. Using the API may also require additional dependency declarations on unstable artifacts.Only use an API marked with
UnstableApiif you are comfortable keeping up with breaking changes. In particular, DO NOT use it in a library that itself has a guarantee of stability, there is no valid use case for it.