Android Support Library

com.android.support:support-annotations:23.1.1

Nullness注解

• Nullable 作用于函数参数或者返回值，标记参数或者返回值可以为空。
• NonNull 作用于函数参数或者返回值，标记参数或者返回值不可以为空。如果违反，会出现警告

资源类型注解

• AnyRes: 标记整型值是 任何一种资源类型
• AnimatorRes: 标记整型值是 android.R.animator 类型
• AnimRes: 标记整型值是 android.R.anim 类型
• ArrayRes: 标记整型值是 android.R.array类型
• AttrRes: 标记整型值是 android.R.attr 类型
• BoolRes: 标记整型值是 布尔类型
• ColorRes: 标记整型值是 android.R.color类型
• DrawableRes: 标记整型值是 android.R.drawable类型
• FractionRes: 标记整型值是 fraction类型(这个比较少见，这种类型的资源常见于Anumation Xml中，比如50%p,标识占parent的50%)
• IdRes: 标记整型值是 android.R.id类型
• IntegerRes: 标记整型值是 android.R.integer类型
• InterpolatorRes: 标记整型值是 android.R.interpolator类型(插值器)
• LayoutRes: 标记整型值是 android.R.layout类型
• MenuRes: 标记整型值是 android.R.menu类型
• PluralsRes: 标记整型值是 android.R.plurals类型，表示复数字符串类型
• RawRes: 标记整型值是 android.R.raw类型
• StringRes: 标记整型值是 android.R.string类型
• StyleableRes: 标记整型值是 android.R.styleable类型
• StyleRes: 标记整型值是 android.R.style类型
• TransitionRes: 标记整型值是 transition类型(过渡？)
• XmlRes: 标记整型值是 android.R.xml类型

类型定义注解

• @IntDef

// 告知编译器不要在.class文件中存储注解数据
@Retention(RetentionPolicy.SOURCE)
// 定义可以接受的常量
// flag用来识别函数参数或者返回值是否符合某一种模式
@IntDef(flag=true, value={
    A,
    B,
    C
})
public @interface NavigationMode{}

public static final int A =0;
public static final int B =1;
public static final int C =2;

@NavigationMode
public abstract int getNavigationMode();

public abstract void setNavigationMode(@NavigationMode int mode);


// 调用
setNavigationMode(ActionBar.A | ActionBar.B);

线程注解

• @UiThread 标记运行在UI线程。一个UI线程是Activity运行所在的主窗口，对于一个应用而言，可能存在多个UI线程，每个UI线程对应不同的主窗口。
• @MainThread 标记运行在主线程，一个应用只有一个主线程，主线程也是UI线程。
• @WorkerThread 标记运行在后台的线程
• @BinderThread 标记运行在binder的线程

一般情况下，使用@MainThread来注解生命周期相关函数，使用，@UiThread来注解视图相关函数。一般情况下 @MainThread可与@UiThread互换

RGB颜色值注解

• @ColorInt

public void setTextColor(@ColorInt int color){
    mTextColor = ColorStateList.valueOf(color);
    updateTextColors();
}

值范围注解

• @Size： 对于类似数组、集合、字符串之类的参数，可以使用@Size注解来标识这些参数的大小

@Size(min=1) // 可以表示集合不能为空
@Size(max = 23) // 可以表示字符串的最大长度为23
@Size(2) // 可以表示集合的个数为2
@Size(multiple=2) // 可以表示数组大小是2的倍数

• @IntRange: 参数类型是int 或者 long，用法如下

public void setAlpha(@IntRange(from=0, to= 255) int alpha){...}

• FloatRange: 参数类型为 float或者double

public void setAlpha(@FloatRange(from=0.0, to= 1.0) float alpha){...}

权限注解

• RequiresPermission

@RequiresPermission //声明一个权限
@RequiresPermission(anyOf={A,B}) //需要声明至少一个权限
@RequiresPermission(allOf={A,B}) //需要声明所有权限

@RequiresPermission(android.Mainifest.BLUTTOOTH)//Intent权限注解
public static final String ACTION_REQUEST_DISCOVERABLE="android.bluetooth.adapter.action.REQUEST_DISCOVERABLE";

// 对于ContentProvider 相关的权限，可能同时需要读写这两个操作
@RequiresPermission.Read(@RequiresPermission(READ_HISTORY_BOOKMARKS))
@RequiresPermission.Write(@RequiresPermission(WRITE_HISTORY_BOOKMARKS))
public static final Uri BOOKMARKS_URI = Uri.parse("content://browser/bookmarks");

重写函数注解

• @CallSuper 允许调用者重写函数，但同时要求重写函数的时候需要调用被重写的函数，即调用 super()，否则代码可能会错误，这时可以用 这个注释来提醒开发者。

@CallSuper
protected void onCreate(@Nullable Bundle savedInstanceState){...};

返回值注解

• @CheckResult

@VisiableForTesting

• @VisiableForTesting单元测试中不可见的类、函数或变量 对测试可见

@Keep

• @Keep 用来标记在Proguard混淆过程中 不需要混淆的类或方法。 ！！！！！！！很实用

com.android.support:percent:23.2.0

百分比布局

• PercentFrameLayout

• PercentRelativeLayout

• PercentLayoutHelper(百分比逻辑实现)

新增的配置属性

• layout_widthPercent: 用百分比表示宽度
• layout_heightPercent: 用百分比表示高度
• layout_marginPercent: 用百分比表示间隔
• layout_marginLeftPercent: 用百分比表示左间隔
• layout_marginTopPercent: 用百分比表示上间隔
• layout_marginRightPercent: 用百分比表示右间隔
• layout_marginBottomPercent: 用百分比表示下间隔
• layout_marginStartPercent: 用百分比表示距离第一个view 的间隔
• layout_marginEndPercent: 用百分比表示距离最后一个view的间隔
• layout_aspectRatio:用百分比来标识view的宽高比

com.android.support:support-v4:23.1.1

• 略

com.android.support:support-v13:23.1.1

com.android.support:appcompat-v7:23.1.1

• 略

com.android.support:design:23.1.1

com.android.support:gridlayout-v7:23.1.1

com.android.support:mediarouter-v7:23.1.1

com.android.support:cardview-v7:23.1.1

• 卡片view 可圆角 可带阴影。不向下兼容（用于图片带圆角的时候）

com.android.support:palette-v7:23.1.1

com.android.support:recyclerview-v7:23.1.1

• 略

com.android.support:leanback-v17:23.1.1