大家好，我是路遥，每周五给你推荐一个泛移动端优质 Github 项目。
今天的主角是 BackgroundLibrary，通过标签直接生成 shape，无需再写 shape.xml 。
Author | https://github.com/JavaNoober |
Url | https://github.com/JavaNoober/BackgroundLibrary |
Language | Java |
Star | 3.2k |
Fork | 420 |
Issue | 4 Open/129 Closed |
Commits | 186 |
Last Update | 18 Dec 2021 |
License | Apache-2.0 |
以上数据截止至 2022 年 2 月 12 日。
使用
手写 shape.xml ，selector.xml 的痛苦经验，相信每一个安卓程序员都深有体会。BackgroundLibiary 提供了一种低侵入式的解决方案。
首先，引入依赖。
代码语言：javascript复制allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}
implementation "androidx.appcompat:appcompat:$supportVersion"
implementation 'com.github.JavaNoober.BackgroundLibrary:library:1.6.9'
在 xml 中直接使用 app:bl_xxx 属性即可。下面是一个简单示例。
代码语言：javascript复制<TextView
android:layout_width="130dp"
android:layout_width="130dp"
android:layout_height="36dp"
android:gravity="center"
android:text="TextView"
android:textColor="#8c6822"
android:textSize="20sp"
app:bl_corners_radius="4dp"
app:bl_solid_color="#E3B666"
app:bl_stroke_color="#8c6822"
app:bl_stroke_width="2dp" />
这就等同于
代码语言：javascript复制<shape xmlns:android="http://schemas.android.com/apk/res/android">
<corners android:radius="2dp"/>
<solid android:color="#E3B666"/>
<stroke android:color="#E3B666" android:width="2dp"/>
</shape>
BackgroundLibrary 支持了大量属性，具体列表可以在 wiki 中查看 ：https://github.com/JavaNoober/BackgroundLibrary/wiki/4、所有的bl具体属性 。
除了 xml 中的基本使用外，BackgroundLibrary 还提供了完善的配套支持。
可以通过代码直接生成 Drawable 。
代码语言：javascript复制//设置button圆角背景
Drawable drawable = new DrawableCreator.Builder().setCornersRadius(dip2px(20))
.setGradientAngle(0).setGradientColor(Color.parseColor("#63B8FF"), Color.parseColor("#4F94CD")).build();
btn.setBackground(drawable);
//文字点击变色
tvTest1.setClickable(true);//由于Android源码的原因，必须调用，否则不生效
ColorStateList colors = new DrawableCreator.Builder().setPressedTextColor(Color.RED).setUnPressedTextColor(Color.BLUE).buildTextColor();
tvTest1.setTextColor(colors);
可以配置 Live Templates 进行代码提示，降低使用成本。 使用方法见 wiki ：https://github.com/JavaNoober/BackgroundLibrary/wiki/7、如何进行代码提示 。
提供了预览功能，但是需要把原来的View换成框架内对应的BLView，这存在一定的成本 。
综合来说，还是一个相当不错的工具库，可以摆脱繁杂的 shape.xml 编写工作，但并不可能完全替代。因为使用 BackgroundLibrary 就意味着放弃了复用，所以更多情况还是配合 shape.xml 共同使用。
原理
BackgroundLibrary 的原理还是很巧妙的。两个关键词：自动初始化、自动解析属性 。你可以先不往后看，停下来思考一下如何实现。
自动初始化毫无疑问，肯定是利用了 ContentProvider 。
代码语言：javascript复制public class BackgroundContentProvider extends ContentProvider {
@Override
public boolean onCreate() {
if(getContext() != null && getContext() instanceof Application && BLAutoInjectController.isEnableAutoInject()){
BackgroundLibrary.inject(getContext());
((Application) getContext()).registerActivityLifecycleCallbacks(new BLActivityLifecycleRegister());
}
return true;
}
...
}
registerActivityLifecycleCallbacks(new BLActivityLifecycleRegister()) 监听了所有 Activity 的生命周期。
public class BLActivityLifecycleRegister implements Application.ActivityLifecycleCallbacks {
@Override
public void onActivityCreated(Activity activity, Bundle savedInstanceState) {
BackgroundLibrary.inject(activity);
}
...
}
重点就在 BackgroundLibrary.inject(activity) 。
代码语言：javascript复制public class BackgroundLibrary {
public static LayoutInflater inject(Context context) {
LayoutInflater inflater;
if (context instanceof Activity) {
inflater = ((Activity) context).getLayoutInflater();
} else {
inflater = LayoutInflater.from(context);
}
if (inflater == null) {
return null;
}
if (inflater.getFactory2() == null) {
BackgroundFactory factory = setDelegateFactory(context);
inflater.setFactory2(factory);
} else if (!(inflater.getFactory2() instanceof BackgroundFactory)) {
forceSetFactory2(inflater);
}
return inflater;
}
...
}
如果你知道 AppcompatActivity 是如何 在运行时自动把 xml 文件中的 TextView 转换成 AppcompatTextView 的话，你应该也理解了 BackgroundLibrary 的工作原理。这都归功于 LayoutInflater.Factory 不了解的同学，可以阅读鸿洋的这篇文章：Android 探究 LayoutInflater setFactory ，http://blog.csdn.net/lmj623565791/article/details/51503977。
这一期的介绍就到这里了，我们下周五见。
