大家好,我是路遥,每周五给你推荐一个泛移动端优质 Github 项目。
今天的主角是 BackgroundLibrary,通过标签直接生成 shape,无需再写 shape.xml 。
Author | github.com/JavaNoober |
Url | github.com/JavaNoober/… |
Language | Java |
Star | 3.2k |
Fork | 420 |
Issue | 5 Open/128 Closed |
Commits | 186 |
Last Update | 18 Dec 2021 |
License | Apache-2.0 |
以上数据截止至 2022 年 2 月 12 日。
使用
手写 shape.xml ,selector.xml 的痛苦经验,相信每一个安卓程序员都深有体会。BackgroundLibiary 提供了一种低侵入式的解决方案。
首先,引入依赖。
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 属性即可。下面是一个简单示例。
<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" /> 复制代码
这就等同于
<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 中查看 : github.com/JavaNoober/… 。
除了 xml 中的基本使用外,BackgroundLibrary 还提供了完善的配套支持。
可以通过代码直接生成 Drawable 。
//设置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 : github.com/JavaNoober/… 。
提供了预览功能,但是需要把原来的View换成框架内对应的BLView,这存在一定的成本 。
综合来说,还是一个相当不错的工具库,可以摆脱繁杂的 shape.xml 编写工作,但并不可能完全替代。因为使用 BackgroundLibrary 就意味着放弃了复用,所以更多情况还是配合 shape.xml 共同使用。
原理
BackgroundLibrary 的原理还是很巧妙的。两个关键词:自动初始化、自动解析属性 。你可以先不往后看,停下来思考一下如何实现。
自动初始化毫无疑问,肯定是利用了 ContentProvider 。
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) 。
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 。
最后
这一期的介绍就到这里了,我们下周五见。
如果你有好的项目推荐,欢迎给我留言。