Commit c3603832 authored by Him188's avatar Him188

Add SinceMirai and MiraiExperimentalAPI annotations

parent 6844b108
package net.mamoe.mirai.utils package net.mamoe.mirai.utils
import kotlin.annotation.AnnotationTarget.*
/** /**
* 标记这个类, 类型, 函数, 属性, 字段, 或构造器为一个仅供 Mirai 内部使用的 API. * 标记为一个仅供 Mirai 内部使用的 API.
* *
* 这些 API 可能会在任意时刻更改, 且不会发布任何预警. * 这些 API 可能会在任意时刻更改, 且不会发布任何预警.
* 我们非常不建议使用这些 API. * 非常不建议在发行版本中使用这些 API.
*/ */
@Experimental(level = Experimental.Level.ERROR) @Experimental(level = Experimental.Level.ERROR)
@Target( @Target(CLASS, TYPEALIAS, FUNCTION, PROPERTY, FIELD, CONSTRUCTOR)
AnnotationTarget.CLASS, internal annotation class MiraiInternalAPI
AnnotationTarget.TYPEALIAS,
AnnotationTarget.FUNCTION, /**
AnnotationTarget.PROPERTY, * 标记这个类, 类型, 函数, 属性, 字段, 或构造器为实验性的.
AnnotationTarget.FIELD, *
AnnotationTarget.CONSTRUCTOR * 这些 API 不具有稳定性, 且可能会在任意时刻更改.
) * 不建议在发行版本中使用这些 API.
annotation class InternalAPI */
\ No newline at end of file @Experimental(level = Experimental.Level.ERROR)
@Target(CLASS, TYPEALIAS, FUNCTION, PROPERTY, FIELD, CONSTRUCTOR)
internal annotation class MiraiExperimentalAPI
/**
* 标记这个 API 是自 Mirai 某个版本起才受支持.
*/
@Target(CLASS, PROPERTY, FIELD, CONSTRUCTOR, FUNCTION, PROPERTY_GETTER, PROPERTY_SETTER, TYPEALIAS)
@Retention(AnnotationRetention.BINARY)
@MustBeDocumented
internal annotation class SinceMirai(val version: String)
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment