Android 系统中，那些能大幅提高工作效率的 API 汇总（持续更新中...）

前言

“条条大路通罗马。”工作中，实现某个需求的方式往往不是唯一的，这些不同实现方式不仅表现在代码质量上，还影响着我们的工作效率。就像，在 Android 系统中，总有那么一些鲜为人知的 API 能够减少我们很多零碎的工作量。于是，就想凭着一些经验，整理一些常用的，找个地方归纳总结，也供日后翻阅。

getResources().getIdentifier(String name, String defType, String defPackage)

根据资源名称获取资源 id。正常情况下，我们会在代码中直接根据资源ID获取资源，比如:

1
getResources().getDrawable(R.drawable.ic_launcher);

但有时候，资源并不是固定的，需要根据使用情况从多个同类资源中动态选择，比如根据服务器传递给客户端的接口数据动态设置，怎么办呢？设置一个硬编码的映射关系数组？太繁琐！不妨用上这个方法。

一个完整的资源名为package:type/entry，对应该方法的三个参数：资源名称、资源类型、应用包名。举几个例子：

1
2
3
imageView.setImageResource(getResources().getIdentifier("ic_launcher", "drawable", getPackageName()));
radioGroup.check(getResources().getIdentifier("rb_indicator_" + position, "id", getPackageName()));

实际使用过程中，第一个参数 name，也就是资源名称，根据需要动态设置，这就需要多个资源在命名时保持一定的规范格式。另外，需要注意的是，直接通过 id 获取资源比通过名字的方式效率更高，所以，如果没有这般特殊需求的话，不提倡使用这个方法获取资源。

TextUtils.isEmpty(CharSequence str)

使用频率超高的字符串判空方法，返回一个 boolean 值，内部实现的判断条件为：str == null || str.length() == 0。备受开发人员喜爱的一个 if 字符串判断，系统已经帮我们封装过。

Html.fromHtml()

解析 Html 格式的富文本内容，并返回一个带样式的字符串，供 TextView 等控件显示。可以解决一些含超链接、图文混排等格式的富文本内容的显示问题。

DateUtils.formatDateTime()

利用 Android SDK 提供的这个日期工具类可以将 long 类型的毫秒级时间数据格式化成特定显示格式的字符串。通常我们使用 Java SDK 中的 SimpleDateFormat 格式化日期数据，比如 new SimpleDateFormat("yyyy-MM-dd HH:mm").format()，DateUtils 的作用就是替我们封装了这个过程。格式化结果与当前设备的本地语言环境有关。这里列举几个常用 format 格式（中文环境下）：

  • FORMAT_SHOW_DATE：3月3日
  • FORMAT_SHOW_TIME：10:37
  • FORMAT_SHOW_WEEKDAY：星期五
  • FORMAT_SHOW_YEAR：2017年3月3日
  • FORMAT_NUMERIC_DATE：3/3
  • FORMAT_NO_MONTH_DAY：三月

Formatter.formatFileSize(Context context, long sizeBytes)

格式化文件大小，将字节数据格式化为 B、KB、M 等单位的相应数据。context 参数用于判断返回结果的字符串顺序，right-to-left 还是 left-to-right 形式的。这个工具类免去我们自己转化计算的过程，非常方便，特别适用于应用内文件下载的类似场景。

TypedValue.applyDimension(int unit, float value, DisplayMetrics metrics)

将指定单位的尺寸数据按照当前设备屏幕信息转化为相应的像素值。其中，TypedValue 为第一个参数提供了常用的单位值，比如：

  • COMPLEX_UNIT_PX
  • COMPLEX_UNIT_DIP
  • COMPLEX_UNIT_PT
  • COMPLEX_UNIT_SP

源码如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
public static float applyDimension(int unit, float value, DisplayMetrics metrics){
	switch (unit) {
	case COMPLEX_UNIT_PX:
		return value;
	case COMPLEX_UNIT_DIP:
		return value * metrics.density;
	case COMPLEX_UNIT_SP:
		return value * metrics.scaledDensity;
	case COMPLEX_UNIT_PT:
		return value * metrics.xdpi * (1.0f/72);
	case COMPLEX_UNIT_IN:
		return value * metrics.xdpi;
    case COMPLEX_UNIT_MM:
        return value * metrics.xdpi * (1.0f/25.4f);
    }
    return 0;
}

其实在实际使用过程中，像素值都是 int 整数类型，而该方法返回的是 float 类型，如果直接强制转换的话，会自动舍去小数部分。所以，如果不用该方法的话，通常我们会这么转换：

1
2
3
4
5
public static int convertDipToPx(Context context, int dip) {
    float scale = context.getResources().getDisplayMetrics().density;
    // 0.5f 用于向上取整
    return (int) (dip * scale + 0.5f * (dip >= 0 ? 1 : -1));
}

Space

官方注释如下：

Space is a lightweight View subclass that may be used to create gaps between components in general purpose layouts.

Space 是一个用于创建视图之间空隙的轻量级 View。在 onDraw() 方法中不执行任何绘制，所以 android:background 属性对他来说不起作用。通常我们使用 View 创建视图间的空隙，在不考虑背景色的情况下，Space 其实效率更高。注意，由于是 API 14 引入的控件，如果需要向前兼容的话，需要使用到 support v4 包。

view.performClick()

自动调用 View 点击事件。通常按钮等控件只有在用户点击时才能触发其点击事件，该方法可以由某些特殊条件触发模拟用户点击行为。类似的还有 performLongClick() 方法。

Log.getStackTraceString(Throwable tr)

Log 类提供的一个公共静态方法，与常见的 Log.i() 等方法打印日志到 logcat 控制台不同的是，该方法从 Throwable 对象中获取错误信息，并以字符串的形式返回。当你需要做错误信息的数据持久化，比如保存至本地存储卡中或者上传至服务器时，利用这个方法就非常方便。

Linkify.addLinks()

我们知道对于 TextView 文本控件中的内容，通过 android:autoLink 属性可以为其添加诸如 web、phone 等固定模版的超链接点击事件。但毕竟系统模版有限，而利用 Linkify.addLinks() 方法可以添加一些应用内自定义模版，比如新浪微博中的 “@XXX” 格式的超链接跳转等，都可以通过自定义正则表达式来匹配处理。

getWindow().addFlags(WindowManager.LayoutParams.FLAG_SECURE)

设置安全窗口，禁用系统截屏。防止 App 中的一些界面被截屏，并显示在其他设备中造成信息泄漏。（常见手机设备系统截屏操作方式为：同时按下电源键和音量键。）

比如支付宝 App 的“向商家付款”的包含付款二维码的界面。（补充说明一点，微信付款界面不是这么做的，采用的是在 onResume() 生命周期方法中实时刷新付款二维码，与支付宝在安全方法采取的手段不同。）

moveTaskToBack(boolean nonRoot)

将当前 Activity 所属的 Task （Activity 栈）移到后台，应用从前台状态变为后台状态。参数为 false 时，表示该方法只作用于 task 的根 Activity；否则，作用于任何 Activity。

1
2
3
4
@Override
public void onBackPressed() {
    moveTaskToBack(false);
}

如果像上面这样，在 Activity 中添加这段代码，便会导致用户使用 Back 键返回桌面，却不会关闭当前应用，而是使之进入后台，就像按下 Home 键一样（实际上与 Home 键的作用有所不同）。

这个技巧厉害了。通常为了防止出现用户误按 Back 键退出 App 的情况，我们会在应用首页的 Activity 中监听返回键操作，使用 Toast 弱提示甚至 Dialog 强提示的方式给到用户一个再次确认的操作，但无法阻止用户通过返回键逐步关闭应用。

然而，如果用这个方法拦截 App 最后一个 Activity（常见为首页界面），既没有阻碍用户操作（回到桌面），又没有关闭掉我们的应用（后台运行中），间接提高 App 的存活时间，真乃暗度陈仓。并且据我实验，微信、支付宝、微博等 App 都是这么做的，大家不妨一试。

其实，像下面这样做也能达到屏蔽 Back 键退出应用的场景：

1
2
3
4
5
6
@Override
public void onBackPressed() {
	Intent launcherIntent = new Intent(Intent.ACTION_MAIN);
	launcherIntent.addCategory(Intent.CATEGORY_HOME);
	startActivity(launcherIntent);
}

但是需要注意，与使用 moveTaskToBack() 方法不同的是，该写法下的 Back 键作用和按下 Home 键一样！如果你了解应用抽屉概念的话，该写法导致直接回到设备桌面首页，而不是二级应用抽屉界面。而使用 moveTaskToBack() 就不会，符合用户从哪儿来回哪儿去的较好用户体验。所以，更推荐使用 moveTaskToBack() 方法实现屏蔽 Back 键使应用进入后台的功能。

ThumbnailUtils

缩略图工具类，可以根据本地视频文件源、Bitmap 对象生成缩略图，常用的公共静态方法为：

  • createVideoThumbnail(String filePath, int kind)
  • extractThumbnail(Bitmap source, int width, int height)

bitmap.extractAlpha()

从源 bitmap 中根据 alpha 获取一个新的 bitmap 对象。比较绕口，通常 App 中的 Icon 多数是纯色透明像素背景组成，利用这个方法可以对该图的非透明区域着色，有多种使用场景，常见如 Button 的 pressed 状态，View 的阴影状态等。举个例子：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
private static Bitmap getDropShadow(ImageView iv, Bitmap src, float radius, int color) {
    
    final Paint paint = new Paint(Paint.ANTI_ALIAS_FLAG);
    paint.setColor(color);
    
    final int width = src.getWidth(), height = src.getHeight();
    final Bitmap dest = Bitmap.createBitmap(width, height, Bitmap.Config.ARGB_8888);
    final Canvas canvas = new Canvas(dest);
    final Bitmap alpha = src.extractAlpha();
    canvas.drawBitmap(alpha, 0, 0, paint);
    
    final BlurMaskFilter filter = new BlurMaskFilter(radius, BlurMaskFilter.Blur.OUTER);
    paint.setMaskFilter(filter);
    canvas.drawBitmap(alpha, 0, 0, paint);
    iv.setImageBitmap(dest);
    
    return dest;
}

ArgbEvaluator

系统提供的一个 TypeEvaluator ，我们只需要提供两个起始颜色值和一个分值，系统会通过特定的算法计算得出一个新的颜色中间值。利用这个类，我们至少可以做两件事情。

第一，用于属性动画中。由于其实现了 TypeEvaluator 接口，可以用来做自定义属性动画的求值器，改变 View 的显示状态。比如：

1
2
3
4
5
6
7
8
9
10
11
12
int colorStart = ContextCompat.getColor(this, R.color.black);
int colorEnd = ContextCompat.getColor(this, R.color.green);
ValueAnimator valueAnimator = ValueAnimator
	.ofObject(new ArgbEvaluator(), colorStart, colorEnd)
	.setDuration(3000);
valueAnimator.addUpdateListener(new AnimatorUpdateListener() {
	@Override
	public void onAnimationUpdate(ValueAnimator animation) {
		textView.setTextColor((Integer) animation.getAnimatedValue());
	}
});
valueAnimator.start();

第二，利用该类提供的颜色求值算法，配合 ViewPager 提供的滑动偏离值使用。这种场景常见于使用 ViewPager 实现的引导页，其背景色随着滑动距离动态改变；使用 ViewPager 实现的 Tab 样式菜单页面，Tab 中文本内容随着滑动距离动态改变字体颜色（可以参考安卓版微信）。这两种使用都使得 ViewPager 页面切换过渡得很自然，体验极佳。如：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
viewPager.addOnPageChangeListener(new OnPageChangeListener() {
	@Override
	public void onPageScrolled(int position, float positionOffset, int positionOffsetPixels) {
		new ArgbEvaluator().evaluate(positionOffset, startColor, endColor);
	}
	@Override
	public void onPageSelected(int position) {
	}
	@Override
	public void onPageScrollStateChanged(int state) {
	}
});

另外，关于颜色差值的计算，Google Sample 里有另一种算法，可参考 SlidingTabStrip.java 文件源码，核心方法内容如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
 
/**
* Blend {@code color1} and {@code color2} using the given ratio.
*
* @param ratio of which to blend. 1.0 will return {@code color1}, 0.5 will give an even blend,
*              0.0 will return {@code color2}.
*/
private static int blendColors(int color1, int color2, float ratio) {
	final float inverseRation = 1f - ratio;
	float r = (Color.red(color1) * ratio) + (Color.red(color2) * inverseRation);
	float g = (Color.green(color1) * ratio) + (Color.green(color2) * inverseRation);
	float b = (Color.blue(color1) * ratio) + (Color.blue(color2) * inverseRation);
	return Color.rgb((int) r, (int) g, (int) b);
}

android:weightSum

用于 LinearLayout 中，用于设置 Children weight 的总比重。在 LinearLayout 的 children 中，我们经常会使用 android:layout_weight 按比例分配容器布局的空间，但有时候不一定会分完。以往，有些朋友可能会使用一个空 放在最后来达到末尾占位效果。如果你知道这个属性的话，就能少写一些代码。

android:descendantFocusability

用于 ViewGroup 中，解决作为 Parent 的 ViewGroup 与 Children View 之间的焦点占用问题。最最常见的使用场景就是 list item 中含有一些点击效果的控件，比如 Button、CheckBox 等，相信大家都遇到过。取值有三种，含义就不用再多说了：

  • afterDescendants
  • beforeDescendants
  • blocksDescendants

android:duplicateParentState

是否将 View 自身的 drawable state 交给直接 parent ViewGroup 控制，值为 boolean 类型。比如有一个 item 布局，item 中有一个 button，如果点击 item layout 时，需要 button 呈现对应的点击效果，就可以在 button 中用到这个属性。不过，从设计的角度来讲，这种场景还是比较少见的。知道有这个属性就好，不推荐这种交互设计。

android:fillViewport

ScrollView 的一个属性，用于设置内容部分是否填满屏幕，主要针对内容不足以填满屏幕的情况。这里推荐一个使用技巧，参考我之前写的文章：Android 日常开发中，两个非常实用的布局技巧。

android:adjustViewBounds

使用 ImageView 时，你可能会用 android:scaleType 属性设置图片缩放方式。殊不知，android:adjustViewBounds 属性也能起到类似的效果。但要注意的是，后者需要至少指定 ImageView 宽高中的一个属性，或者 maxHeight 之类的，然后另一个属性随之适配。这个属性用在列表中较为合适，比如 App 中的活动列表页面，图片宽度设置为 match_parent，然后高度设为 wrap_content 使其自适应，这样便能保证从服务获取的高分辨率图片在不同的屏幕中不被拉伸变形。（备注：最好在项目资源文件中放置一个与网络图片相同尺寸的默认图，起到 placeholder 作用，避免图片显示前高度为 0 的较差体验。）

持续更新中…

本文先记这么多吧，日积月累，后续持续更新中，敬请关注…（当然，你有什么高效而又少见的 API，欢迎一起分享交流哦~）

本文由 亦枫 创作并首发于 亦枫的个人博客 ，同步推送微信公众号：安卓笔记侠（androidnotebyyifeng）。

欢迎各种形式地交流与转载，注明作者、出处和微信公众号即可。

本文标题为: Android 系统中，那些能大幅提高工作效率的 API 汇总（持续更新中...）

本文链接为：https://woyifeng.com/2017/03/11/java-and-android-some-effective-apis/

赏

请我喝咖啡，资瓷资瓷~

支付宝
微信
  • 热度 ℃

扫一扫，分享到微信

微信分享二维码

tag:

    缺失模块。
    1、请确保node版本大于6.2
    2、在博客根目录（注意不是yilia根目录）执行以下命令：
    npm i hexo-generator-json-content --save

    3、在根目录_config.yml里添加配置： 

      jsonContent:
    meta: false
    pages: false
    posts:
      title: true
      date: true
      path: true
      text: false
      raw: false
      content: false
      slug: false
      updated: false
      comments: false
      link: false
      permalink: false
      excerpt: false
      categories: false
      tags: true

亦枫，<br/>一名魔都安卓程序员<br/><br/>喜欢深夜执笔，<br/>微信公众号：安卓笔记侠<br/><br/>My Motto,<br/>If you can't fly then run, <br/>can't run then walk, <br/>can't walk then crawl, <br/>keep moving forward.