20、Kotlin注解与API使用详解

Kotlin注解与API使用详解

1. 注解特性

注解通过注解类进行声明，示例如下：

annotation class AnnotationName

注解的特性由元注解描述，常见的元注解有：
- @Target(...) ：指定注解可应用的元素类型。参数是逗号分隔的列表，可选值为 kotlin.annotation.AnnotationTarget 枚举的字段，如 CLASS 、 ANNOTATION_CLASS 等。若未指定，默认目标为 CLASS 、 PROPERTY 等。
- @Retention(...) ：指定注解信息在编译期间的存储位置以及运行时是否可见，可选值为 kotlin.annotation.AnnotationRetention 枚举的字段，如 SOURCE 、 BINARY 、 RUNTIME ，默认是 RUNTIME 。
- @Repeatable ：允许注解多次出现。
- @MustBeDocumented ：使注解显示在公共API文档中。

以下是一个完整的注解声明示例：