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

你可能感兴趣的:(实用工具,android,函数,library)