Android Support Library

最新推荐文章于 2024-06-19 13:30:06 发布

丶如一

最新推荐文章于 2024-06-19 13:30:06 发布

阅读量692

点赞数

分类专栏：实用工具文章标签： android 函数 library

本文链接：https://blog.csdn.net/daisywangyy/article/details/71124719

版权

实用工具专栏收录该内容

43 篇文章 0 订阅

订阅专栏

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的宽高比