Annotation Type PublicApi
Every package listed in privbot/api/public-packages.txt carries this annotation on its
package-info.java. Public types in those packages are covered by the compatibility promise in
the SDK docs, Versioning: a binary-incompatible change needs a new major ApiVersion, and a
removal is deprecated for at least one minor release first. Types and members marked Internal are
excluded from that promise even inside a public package.
Everything outside the listed packages is internal, whether or not it is public in Java.
Plugins that reference it are refused by the strict policy scan and may break on any release.
Retention is CLASS: the marker is in the bytecode (for the API compatibility gate and the
policy scanner) but costs nothing at runtime.