Android 常用注解

1.Nullness注解（作用于函数参数或者返回值）

@Nullable标记参数或者返回值可以为空。 @NonNull标记参数或者返回不可以为空

2.资源类型注解(指定为对应的类型)

@AnimatorRes ----android.R.animator

@AnimRes-----android.R.anim

@ArrayRes----android.R.array

@AttrRes-----android.R.attr

@BoolRes----bool类型

@ColorRes-----android.R.color

@DrawableRes ----android.R.drawable

@IdRes----android.R.id

@IntegerRes----android.R.integer

@LayoutRes----android.R.layout

@MenuRes----android.R.menu

@RawRes----android.R.raw

@StringRes---android.R.string

@StyleableRes----android.R.styleable

@XmlRes---android.R.xml

3.类型定义注解

@IntDef可以创建一个整型类型定义的新注解

//告知编译器不要在.class中存储注解数据

@Retention(RetentionPolicy.SOURCE)

//定义可接受的常量列表

@IntDef（VALUE_1 ,VALUE_2，VALUE_3）

//定义aa注解

public @interface aa()

@aa

public void setValue(@aa int value)

4.线程注解

@UiThread

@MainThread

@WorkerThread (后台线程)

@BinderThread（binder线程）

5.值范围注解

防止传入错误参数，有三种注解

（1）.@Size 类似数组、集合、字符串

@Size（min = 1）//可以表示集合不可为空

@Size（max = 23）//可以表示最大字符个数为23

@Size（2）可以表示数组元素个数为2个

@Size(multiple = 2)//可以表示数组大小是2的倍数

（2）.@IntRange 参数类型为int或者long,    @FloatRange 参数为float或者double

public void setValue(@IntRange(from=0,to= 10) int value){}

6.权限注解

为了在编译期发现权限的缺失 ，可以使用@RequiresPermission注解

（1）.如果调用函数需要声明一个权限

@RequiresPermission(Manifest.permission.SET_WALLPAPER)

public void setWallPaper(Bitmap bit){}

(2).如果调用函数需要声明集合中至少一个权限

@RequiresPermission（anyOf = { Manifest.permission.ACCESS_COARSE_LOCATION,}Manifest.permission.ACCESS_FINE_LOCATION）

(3).如果调用函数需要同时声明多个权限

@RequiresPermission（allOf = {Manifest.permission.ACCESS_COARSE_LOCATION,}Manifest.permission.ACCESS_FINE_LOCATION）

7.重写注解函数

提示某个函数要求被重写 @CallSuper

8.@Keep

用来标记在Proguard混淆过程中不需要混淆的类和方法。

@Keep

puvkuc void doWhat(){}

说明：如果在函数库中使用了注解，并用gradle打包了aar，那么aar中的annotations.zip就是抽取出来的注解信息。