转自:http://blog.csdn.net/maosidiaoxian/article/details/50452706
Android Support库是官方出的支持扩展库,包含了丰富的组件、工具类等,通过在Android SDK Manager中勾选以下两项来获取到。
其中,Android Support Library
下载的是对应的源码或jar包,在使用Eclipse时会从这里拷贝出需要的文件到项目中。而Android Support Repository
下载的是这个support库所对应的本地Maven库。如果你是使用Gradle进行构建(如Android Studio),并通过远程依赖的方式来使用support库的话,则需要下载它,才能获取到对应的依赖。
如上面所说,Android support库包含了众多有用的类库,包括目前基本在项目中都会用到的support-v4包。而本序列第一篇要讲的是,除此support-v4库之外,我们用得特别多的一个库:android-support-annotations。
由于我所使用的是Android Studio,所以对于Eclipse相关的知识在本篇及后续博客中都会略过不谈。
android-support-annotations是Android官方提供的一个注解库,它提供了许多有用的注解,这些注解的生命周期为源码时期,也就是在编译之后则不再保留,通常用于辅助代码上的静态检查。
在Gradle中引入这个库的方式通常如下:
compile 'com.android.support:support-annotations:23.1.1'
- 1
但是如果你已经通过这种方式依赖了support-v4库的话,则不必再显式声明依赖它,因为support-v4也依赖于这个库,由于Gradle的传递依赖的特性,你的项目如果依赖了support-v4库的话,也会依赖到这个注解库。
通过使用support-annotations的注解,我们可以限定一些变量、方法参数或者是方法返回值的范围,这些注解涵盖的使用范围如下:
22个资源类注解:
-
AnimatorRes
:指出一个integer
的参数,成员变量,或方法返回值是一个animator
资源的引用。 -
AnimRes
:指出一个integer
的参数,成员变量,或方法返回值是一个anim
资源的引用。 -
AnyRes
:指出一个integer
的参数,成员变量,或方法返回值是一个任意资源类型的引用。 -
ArrayRes
:指出一个integer
的参数,成员变量,或方法返回值是一个array
资源类型的引用。 -
AttrRes
:指出一个integer
的参数,成员变量,或方法返回值是一个attr
资源的引用。 -
BoolRes
:指出一个integer
的参数,成员变量,或方法返回值是一个boolean
资源的引用。 -
ColorRes
:指出一个integer
的参数,成员变量,或方法返回值是一个color
资源的引用。 -
DimenRes
:指出一个integer
的参数,成员变量,或方法返回值是一个dimen
资源的引用。 -
DrawableRes
:指出一个integer
的参数,成员变量,或方法返回值是一个drawable
资源的引用(包括@mipmap
)。 -
FractionRes
:指出一个integer
的参数,成员变量,或方法返回值是一个fraction
资源的引用。 -
IdRes
:指出一个integer
的参数,成员变量,或方法返回值是一个id
资源的引用。 -
IntegerRes
:指出一个integer
的参数,成员变量,或方法返回值是一个integer
资源的引用。 -
InterpolatorRes
:指出一个integer
的参数,成员变量,或方法返回值是一个interpolator
资源的引用。 -
LayoutRes
:指出一个integer
的参数,成员变量,或方法返回值是一个layout
资源的引用。 -
MenuRes
:指出一个integer
的参数,成员变量,或方法返回值是一个menu
资源的引用。 -
PluralsRes
:指出一个integer
的参数,成员变量,或方法返回值是一个plurals
资源的引用。 -
RawRes
:指出一个integer
的参数,成员变量,或方法返回值是一个raw
资源的引用。 -
StringRes
:指出一个integer
的参数,成员变量,或方法返回值是一个string
资源的引用。 -
StyleableRes
:指出一个integer
的参数,成员变量,或方法返回值是一个styleable
资源的引用。 -
StyleRes
:指出一个integer
的参数,成员变量,或方法返回值是一个style
资源的引用。 -
TransitionRes
:指出一个integer
的参数,成员变量,或方法返回值是一个transition
资源的引用。 -
XmlRes
:指出一个integer
的参数,成员变量,或方法返回值是一个xml
资源的引用。
颜色注解:
假如我们定义了一个方法用来设置颜色,但是因为表示颜色用的是int类型,这样就会导致使用的人无法区分是要传一个表示颜色的资源还是颜色值,对于这种情况,support-annotations给我们提供了以下这个注解:
-
ColorInt
:指出一个被注解的元素,是一个int颜色值,表示的是AARRGGBB
。
4个线程相关的注解:
-
BinderThread
:指出被注解的方法应该只在binder线程中被调用。 -
MainThread
:指出被注解的方法应该只在主线程中被调用。 -
WorkerThread
:指出被注解的方法应该只在工作线程中被调用。 -
UiThread
:指出被注解的方法应该只在UI线程中被调用。
关于这四个注解的差异,可参见stackoverflow的回答:Difference between MainThread, UiThread, WorkerThread, BinderThread in Android Annotation
其他方法相关的注解:
-
CallSuper
:指出一个方法如果被重写了,它必须也被调用。比如Activity的生命周期方法onCreate
方法等。 -
CheckResult
:指出一个方法返回的结果通常是否为一个忽略的错误。比如删除文件:new File("xx").delete();
-
Keep
:指出一个方法在被混淆的时候应该被保留。
取值范围的注解:
-
FloatRange
:指出一个被注解的元素应该是一个给定范围内的float值或double值。比如:
@FloatRange(from=0.0,to=1.0)
public float getAlpha() {
...
}
- 1
- 2
- 3
- 4
-
IntRange
:指出一个被注解的元素应该是一个给定范围内的int值或long值。 -
IntDef
:指出一个int类型的元素,它表示的是一个逻辑上的类型,并且它的值必须是被明确声明的常量之一。官方常使用这种方式使int类型代替enum类型。 -
StringDef
:指出一个String类型的元素,它表示的是一个逻辑上的类型,并且它的值必须是被明确声明的常量之一。
空指针检查
通常我们如果对一个变量进行主动的赋值为null,编译器可能会进行可能引发空指针异常的警告,我们可以使用以下注解对这种行为进行控制。
- NonNull
:指出一个参数,变量,或方法返回值永远不可为null。
- Nullable
:指出一个参数,变量,或方法返回值可能为null。
其他注解:
-
Size
:表示一个被注解的元素应该有一个给定的大小或长度。 -
VisibleForTesting
:可注解一个类,方法,或变量,表示有更宽松的可见性,这样它能够有更宽泛的可见性,使代码可以被测试。
本文原创,转载请注明出处。
关于博文内容,如有遗误错讹,欢迎指出。如果你觉得写得还可以,欢迎微信扫描左侧栏底部二维码进行打赏。
相关推荐
最新android-support-v4 .jar,android-support-annotations.jar
android-support-annotations.jar.zip
support-annotations-28.0.0,自己用的eclipse的jar包,方便用户使用!
android support兼容包,版本v23.2.0,提取自官方sdk,包含v4 v7 v13 v14 v17
android-support-annotations-25.3.1.jar 最近版本jar包,可直接导入使用。
Android Support 包之一的 support-annotations 是通过静态编译检测来提高代码质量的一个注解工具。里面包含了 Android 开发中常用的代码检测注解,帮助开发者提高代码质量。
gradle编译报错说23.3.3找不到时,把这个包解压放到sdk的extras\android\m2repository\com\android\support\support-annotations即可
Android注解支持,Android support library从19.1版本开始引入了一个新的注解库,support-annotations.zip
android-support-annotations.jar android-support-v4.jar android-support-v7-appcompat.jar ... android-support-v7-recyclerview android-support-v13.jar
这里我把5个包合并为一个大包,注意大包里面没包含android-support-annotations-25.3.1 android-support-v4-25.3.1(由下面的5个小包合并) v4-support-compat-25.3.1 v4-support-core-ui-25.3.1 v4-support-core-...
support-annotations-23.1.0.jar
最全的,解压后是jar文件,用于解决eclipse中 无法加载android.support.annotations的问题
Android Support Annotations 这里对Android Support Annotations注解的资料做了详细整理大家可以参考下: 注解 解释 @AnimatorRes 表示该参数、字段或者函数返回值应该是一个 Animator 类型的资源 @AnimRes ...
support-annotations-23.0.1-sources.jar
support-annotations-28.0.0.jar
android-support-core-utils android-support-fragment support-annotations support-compat android-support-media-compat android-support-core-ui 版本26+ 全
绝对是最新最完成的annotations.jar包!放心下载吧!
包含android-support-v4.jar ,android-support-annotations.jar两个库