GenaralRoundLayout

项目地址：

minminaya/GenaralRoundLayout

简介： kotlin 封装的通用圆角布局

更多：

作者


提 Bug

标签：

Android 通用圆角布局，可以解决 Android P 版本 xfermode 方案裁剪黑边问题和 xfermode 在列表 view 中使用滑动时 EGL 内存泄露问题

其诞生有 3 个原因

1、之前使用的 XferMode 裁剪方案在 P 版本失效
2、xfermode 圆角裁剪方案在 RecyclerView 中使用，滑动时会出现 EGL 内存泄露问题（系统 api 未做好内存回收），使用 GeneralRound，可以解决 L 版本上的机器
3、希望可以快速将一个 View 装饰包装变成支持裁剪圆角的 View
4、不希望关闭硬件加速去绘制圆角，不希望使用有锯齿的 clipPath API

GETTING STARTED

导入 GeneralRoundLayout 依赖

1、在 Project 的 build.gradle 中

allprojects {
        repositories {
            ...
            maven { url 'https://jitpack.io' }
        }
    }

2、在对应 module 中添加 dependency


dependencies {
            implementation 'com.github.minminaya:GenaralRoundLayout:1.0.0'
    }

3、在你想做裁剪的布局外层包裹


 <com.minminaya.widget.GeneralRoundFrameLayout
            android:layout_width="200dp"
            android:layout_height="200dp"
            android:layout_gravity="center"
            app:corner_radius="30dp">

            <View
                android:layout_width="match_parent"
                android:layout_height="match_parent"
                android:background="@color/colorAccent" />
        </com.minminaya.widget.GeneralRoundFrameLayout>

给自定义 view 加上圆角裁剪特性

GeneralRoundLayout 设计初期是为了方便各种布局的扩展，因此可以使任何一个 view 支持圆角特性，你只需要重写几个方法

1、让你的自定义 view 比如 GeneralRoundImageView 实现 IRoundView 接口


interface IRoundView {
    fun setCornerRadius(cornerRadius: Float)
    fun onLayout(changed: Boolean, left: Int, top: Int, right: Int, bottom: Int)
}

2、定义 attrs 属性

在你的 attrs 的文件中，定义 declare-styleable 属性（为了可以在 xml 文件中输入的时候自动提示）


<declare-styleable name="GeneralRoundImageView">
        <attr name="corner_radius" />
    </declare-styleable>

2、让 GeneralRoundImageView 实现 IRoundView 接口的方法


public class GeneralRoundImageView extends AppCompatImageView implements IRoundView {

    public GeneralRoundImageView(Context context) {
        this(context, null);
    }

    public GeneralRoundImageView(Context context, @Nullable AttributeSet attrs) {
        super(context, attrs);
    }


    public GeneralRoundImageView(Context context, @Nullable AttributeSet attrs, int defStyleAttr) {
        super(context, attrs, defStyleAttr);
    }

    @Override
    public void setCornerRadius(float cornerRadius) {
    }

    @Override
    public void onLayout(boolean changed, int left, int top, int right, int bottom) {
        super.onLayout(changed, left, top, right, bottom);
    }

}

3、在 GeneralRoundImageView 中定义 GeneralRoundViewImpl 对象，本质上是裁剪 view 的 helper 类，让其初始化，并将 view 的实现分发到 GeneralRoundViewImpl


public class GeneralRoundImageView extends AppCompatImageView implements IRoundView {
    private GeneralRoundViewImpl generalRoundViewImpl;

    public GeneralRoundImageView(Context context) {
        this(context, null);
    }

    public GeneralRoundImageView(Context context, @Nullable AttributeSet attrs) {
        super(context, attrs);
        init(this, context, attrs);
    }


    public GeneralRoundImageView(Context context, @Nullable AttributeSet attrs, int defStyleAttr) {
        super(context, attrs, defStyleAttr);
        init(this, context, attrs);
    }

    @Override
    public void setCornerRadius(float cornerRadius) {
        generalRoundViewImpl.setCornerRadius(cornerRadius);
    }

    @Override
    public void onLayout(boolean changed, int left, int top, int right, int bottom) {
        super.onLayout(changed, left, top, right, bottom);
        generalRoundViewImpl.onLayout(changed, left, top, right, bottom);
    }

    private void init(GeneralRoundImageView view, Context context, AttributeSet attrs) {
            generalRoundViewImpl = new GeneralRoundViewImpl(view,
                    context,
                    attrs,
                    R.styleable.GeneralRoundImageView,
                    R.styleable.GeneralRoundImageView_corner_radius);
    }

}

4、重写 dispatchDraw 方法，将实现类的方法包装 super

    @Override
    protected void dispatchDraw(Canvas canvas) {
        generalRoundViewImpl.beforeDispatchDraw(canvas);
        super.dispatchDraw(canvas);
        generalRoundViewImpl.afterDispatchDraw(canvas);
    }

5、在你要使用的地方

 <com.minminaya.genaral.custom.GeneralRoundImageView
            android:layout_width="200dp"
            android:layout_height="200dp"
            android:layout_gravity="center"
            android:layout_marginTop="20dp"
            android:src="@color/colorPrimaryDark"
            app:corner_radius="60dp" />

6、done

如何同时解决 xfermode 内存泄露和 Android P 圆角失效问题

1、P 版本圆角失效问题，具体可见 GcsSloop 大神的

rclayout

，有给出为何失效和解决的方案
2、由于 xfermode 方案会导致内存泄露，所以这里 GeneralRoundLayout 在 L 版本及以上不在使用其进行绘制，转而使用 ViewOutlineProvider 去进行圆角裁剪，当然，4.3 和 4.4 泄露问题不能够解决，基于现在的 18、19 和 20 版本的是用户量，决定保证 L 版本以上不泄露即可
3、为了兼容 18、19 和 20 的圆角可以生效，GeneralRoundViewImpl 内部会进行版本去选择 RoundViewPolicy

什么？，你想快速集成，但又不想要那么多代码？(L 版本及以上)

具体可以参考 GeneralRoundView21Policy 类实现，其实本质上只有几行代码，但是为了写的优雅嘛啊哈，你懂的

1、在你自定义 view 的 dispatchDraw 方法中直接使用 ViewOutlineProvider


    @Override
    @TargetApi(Build.VERSION_CODES.LOLLIPOP)
    protected void dispatchDraw(Canvas canvas) {
        super.dispatchDraw(canvas);
        setClipToOutline(true);
        setOutlineProvider(new ViewOutlineProvider() {
            @Override
            public void getOutline(View view, Outline outline) {
                outline.setRoundRect(0, 0, mContainer.width, mContainer.height, mCornerRadius);
            }
        });
    }