Github 精选 #1 | 如何干掉 shape.xml 文件?

·  阅读 816
Github 精选 #1 | 如何干掉 shape.xml 文件?

大家好,我是路遥,每周五给你推荐一个泛移动端优质 Github 项目。

今天的主角是 BackgroundLibrary,通过标签直接生成 shape,无需再写 shape.xml 。

Authorgithub.com/JavaNoober
Urlgithub.com/JavaNoober/…
LanguageJava
Star3.2k
Fork420
Issue5 Open/128 Closed
Commits186
Last Update18 Dec 2021
LicenseApache-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

最后

这一期的介绍就到这里了,我们下周五见。

如果你有好的项目推荐,欢迎给我留言。

分类:
Android
收藏成功!
已添加到「」, 点击更改