android 权限组件设计

2,606 阅读8分钟

ps:打算从简书搬到掘金来了,简书没讨论氛围,发了好久也不见有人讨论,还是掘金人气旺,氛围好,记得16年刚注册那会还不让发帖呢,申请作家都不给通过...

美女镇楼

有轮子就不要再自己造轮子了,这是行业公认的,我这里不是从头写一个权限库,而是在开源组件上再封装以统一公司内部调用,随时可以替换第三方实现,从开源库再封装这个角度来写文章的很少,我这里带大家领略另一番风景,先说好不喜勿喷啊,我这水平幼儿园都没毕业呢

项目地址:BW_Libs


先看下 Demo 的 代码

不上 gif 了,录这个时间太长,gif 太大网页很卡。Demo 的思路如下,正常的判断权限,有3个回调,用户确认给予权限,用户不给,和用户点选不在显示系统权限弹窗。这里我们在用户不显示弹窗后的回调里启动系统权限设置页,在用户关闭权限设置页面过后,我们再检测下=刚刚用户给没给权限,没给权限的话就自己显示个弹窗,提示用户不给权限就关闭页面

Demo 代码如下:

class PermissionActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_permission)

        btn_permission.setOnClickListener{

            PermissionManage
                    .with(this)
                    .permission(Manifest.permission.CALL_PHONE)
                    .permission(Manifest.permission.CAMERA)
                    .permission(Manifest.permission.READ_PHONE_STATE)
                    .onSuccess { Toast.makeText(this@PermissionActivity, "申请成功", Toast.LENGTH_SHORT).show() }
                    .onDenial { Toast.makeText(this@PermissionActivity, "用户拒绝", Toast.LENGTH_SHORT).show() }
                    .onDontShow { IntentUtils.startSettingActivityForResult(this, 200) }
                    .run()
        }
    }

    override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {

        if (requestCode == 200) {

            var permissions = listOf(Manifest.permission.CALL_PHONE, Manifest.permission.CAMERA, Manifest.permission.READ_PHONE_STATE)
            if (PermissionManage.isHavePermissions(this, permissions)) {
                Toast.makeText(this, "欢迎您给予的权限", Toast.LENGTH_SHORT).show()
            } else {
                showDialog()
            }
        }
    }

    private fun showDialog() {

        var build: AlertDialog.Builder = AlertDialog.Builder(this)
        build.setMessage("缺乏权限,请求您给予权限")
        build.setPositiveButton("申请权限", object : DialogInterface.OnClickListener {
            override fun onClick(dialog: DialogInterface?, which: Int) {
                IntentUtils.startSettingActivityForResult(this@PermissionActivity, 200)
                dialog?.dismiss()
//                dialog?.cancel()
            }
        })
        build.setNegativeButton("不给权限", object : DialogInterface.OnClickListener {
            override fun onClick(dialog: DialogInterface?, which: Int) {
                Toast.makeText(this@PermissionActivity, "对不起,某些权限是必备选择,不给权限不能运行", Toast.LENGTH_SHORT).show()
                dialog?.dismiss()
                this@PermissionActivity.finish()
            }
        })
        build.show()
    }

}

组件封装思路

1. 要好看,响应式函数式编程思想,提供链式调用

这点很重要,组件封装完了是要给小伙伴们和自己用的,用起来费时费力,不好理解,不清不楚的都不行,达不到简单易懂易用的组件都是不合格的,从这点来说,其实 Fresco 的 API 就不是很好,当然 Fresco 是非常复杂的了,但是另一个图片加载的小伙伴 Glide API 就很 Nice 啦

这部分就是我封装的权限组件的 API 了,仿照函数式编程,提供链式调用,这样的代码很好看,非常容易理解逻辑。函数式编程在处理连续复杂逻辑的代码上有天然的优势,其风格以清晰著称,是我们封装工具类组件的不二选择

            PermissionManage
                    .with(this)
                    .permission(Manifest.permission.CALL_PHONE)
                    .permission(Manifest.permission.CAMERA)
                    .permission(Manifest.permission.READ_PHONE_STATE)
                    .onSuccess { Toast.makeText(this@PermissionActivity, "申请成功", Toast.LENGTH_SHORT).show() }
                    .onDenial { Toast.makeText(this@PermissionActivity, "用户拒绝", Toast.LENGTH_SHORT).show() }
                    .onDontShow { IntentUtils.startSettingActivityForResult(this, 200) }
                    .run()
2. 第三方库高度,无痕可替换

我使用的是 AndPermission 这个开源库,来看下我对 AndPermission 的包装

2.1 - 抽取接口 第三方权限库是干嘛的,就是提供权限申请验证的,抽泣其公共功能,就是1个,给参数然后执行,就是这么简单,为什么,因为功能单一呗,即使请求验证权限

interface IPermissionExecuter {

    fun run(permissionConfig: PermissionConfig)
}

2.2 - 实现接口 ,包装第三方库

class AndPermissinExecuterImpl : IPermissionExecuter {

    override fun run(permissionConfig: PermissionConfig) {
        AndPermission.with(permissionConfig.context)
                .permission(permissionConfig.permissions.toTypedArray())
                // 用户给权限了
                .onGranted({ permissions: List<String> -> permissionConfig.onSuccessAction() })
                // 用户拒绝权限,包括不再显示权限弹窗也在此列
                .onDenied({ permissions: List<String> ->
                    // 判断用户是不是不再显示权限弹窗了,若不再显示的话进入权限设置页
                    if (AndPermission.hasAlwaysDeniedPermission(permissionConfig.context, permissions)) {
                        // 打开权限设置页
                        permissionConfig.onDontShowAction()
                        return@onDenied
                    }
                    permissionConfig.onDenialAction()
                })
                .start()
    }
}

第三方权限库需要的参数基本都一样,不管有什么,我们都包装到 PermissionConfig 里面,然后通过PermissionConfig 把参数传进来执行,这样我们想要替换 第三方实现时,只要再写一个 IPermissionExecuter 的实现类就行了

2.3 - 提供一个工厂类,实现切换管理

这个就不用说了吧,工厂模式,打击都熟悉的套路了

object ExecuterFactor {

    @JvmField
    val AND_PERMISSION = "AND_PERMISSION"

    @JvmField
    val RX_PERMISSION = "RX_PERMISSION"

    @JvmField
    val DEFAULT_EXECUTER = AND_PERMISSION

    @JvmStatic
    fun getInstance(): IPermissionExecuter {
        return getInstance(DEFAULT_EXECUTER)
    }

    @JvmStatic
    private fun getInstance(type: String): IPermissionExecuter {

        return when (type) {
            AND_PERMISSION -> AndPermissinExecuterImpl()
            DEFAULT_EXECUTER -> AndPermissinExecuterImpl()
            else -> AndPermissinExecuterImpl()
        }
    }
}
3. 抽取公共参数,使用 build 构建

上面我们把第三方所需参数包装成了一个类 PermissionConfig,我们来看看这个类

class PermissionConfig {

    lateinit var context: Context
    // 权限申请成功时回调
    var onSuccessAction: () -> Unit = {}
    // 权限申请失败时回调
    var onDenialAction: () -> Unit = {}
    // 用户设置不显示权限申请弹窗时回调
    var onDontShowAction: () -> Unit = {}
    // 权限集合
    var permissions = mutableListOf<String>()

    private var type: String = ExecuterFactor.DEFAULT_EXECUTER

    /**
     * 添加权限
     */
    fun addPermission(permission: String) {
        if (!permission.isEmpty()) permissions.add(permission)
    }

    /**
     * 设置类型
     */
    fun setType(type: String): PermissionConfig {
        if (!type.isEmpty()) this.type = type
        return this
    }

    /**
     * 执行操作
     */
    fun run() {
        ExecuterFactor.getInstance().run(this)
    }
}

抽取出来的参数没几个,很好理解,所需要的参数,用集合来接收因为可能有多个嘛,然后是3个回调,同意,不同意,关闭权限弹窗,借助 kotlin 的语言,我们不要再像 java 一样去写一个接口了,直接声明成空实现就行,也没有 null 的问题,然后提供设置这几个参数的方法即可

但是吧,我们不能就这么直接使用 PermissionConfig ,因为以后随着时间推移有变化,我们需要一个统一的地方来统一构建参数包装对象,这就是大家熟悉的 build 模式啦

class PermissionBuild(var context: Context) {

    var permissionConfig: PermissionConfig = PermissionConfig()

    init {
        permissionConfig.context = this.context
    }

    /**
     * 设置类型
     */
    fun type(type: String): PermissionBuild {
        if (!type.isEmpty()) permissionConfig.setType(type)
        return this
    }

    /**
     * 添加权限
     */
    fun permission(permission: String): PermissionBuild {
        if (!permission.isEmpty()) permissionConfig?.addPermission(permission)
        return this
    }

    /**
     * 添加成功操作
     */
    fun onSuccess(onSuccessAction: () -> Unit): PermissionBuild {
        if (onSuccessAction != null) permissionConfig.onSuccessAction = onSuccessAction
        return this
    }

    /**
     * 添加失败操作
     */
    fun onDenial(onDenialAction: () -> Unit): PermissionBuild {
        if (onDenialAction != null) permissionConfig.onDenialAction = onDenialAction
        return this
    }

    /**
     * 添加不显示权限弹窗操作
     */
    fun onDontShow(onDontShowAction: () -> Unit): PermissionBuild {
        if (onDontShowAction != null) permissionConfig.onDontShowAction = onDontShowAction
        return this
    }

    /**
     * 执行操作
     */
    fun run() {
        permissionConfig.run()
    }
}

这里的 build 逻辑很简单,不写也可以,本着练手的原则还是写了,还是得益于 kotlin 的语法,方法可以直接接收函数参数,也不用我们再去写接口了,的确是方便了很多,尤其是在我们写的时候可以一气呵成,不用来回切换类,不会打断思路是非常好的

4. 提供统一入口

作为工具类,要有一个统一的入口,静态的也行,new 对象也行,这里推荐使用静态方法的方式,方便理解

class PermissionManage {

    /**
     * 提供相关静态入口,效仿 Glide 通过 with 绑定上下文
     *
     */
    companion object {

        @JvmStatic
        fun with(context: Context): PermissionBuild {
            return PermissionBuild(context)
        }

        @JvmStatic
        fun isHavePermission(context: Context, permission: String): Boolean {
            return PackageManager.PERMISSION_GRANTED == ContextCompat.checkSelfPermission(context, permission)
        }

        @JvmStatic
        fun isHavePermissions(context: Context, permissions: List<String>): Boolean {

            for (it in permissions) {
                if (!(PackageManager.PERMISSION_GRANTED == ContextCompat.checkSelfPermission(context, it))) return false
            }
            return true
        }
    }
}

类似于 Glide.with 在添加上下文之后返回 PermissionBuild 构建器用于添加数据,另外还提供了其他工具方法,用来查询是否有权限

我是从后向前走的顺序,思路是基于一步步的实现的,中间的类都是基于我要包装第三方库的目的一步步产生的,简单的功能库基本都是基于这个角度来做


看下类结构

这个组件很简单的,其实我之前用 java 写过这个权限组件,同样的思路,地址在这里:简单对权限开源库进行功能性封装 ,一开始我就是想把 java 换成 kotlin ,但是改改写写,最后基本彻底抛弃以前的重新整理思路写了一遍,旧的那个组件现在看来废话太多,我差不多删了一半的类,另外我又重新考虑了一遍命名,也是基本改了一半的,这个命名在我来看是最难的

新版类结构:

老版类结构:

这么一看是不是很简单啊,虽然简单但是很好的完成了我们的目标,包装第三方组件,提供统一 API 实现,动态无缝切换第三放实现

数数我们用了几个套路:

  • 提取相同,抽象不同 - 模板模式 包装第三方实现,抽取 run 执行这个动作,把所以参数包装成统一的配置类

  • 统一切换不同第三方实现 - 工厂模式

  • build 统一构建数据 - 构造者模式

  • 提供统一接口 - 门板模式

上面基本都是套路,权限这个组件功能单一,大家可能体会不到上面这几个套路的神奇,这东西只能靠意淫来理解深化,得自己手把手的写才能有切身体会,才能最终荣辉贯通, UML 类图有时间再放上吧


最后吐槽下

在写这个组件时,测试时尼玛我居然忘了在配置文件里声明所需权限了,我怎么调试怎么都不对,我查了好多遍代码也没找到问题,老打击人了,老郁闷了,让我一天的心情都老差劲了,浪费了2个多小时时间,后来想起来了,尼玛我是抽了自己5分钟的嘴巴子,太丢了

奉劝大家遇到问题时一定要冷静啊,不冷静的后果就是浪费人生,明明很简单的事,代码也写的很好,一次过,就是忘了配置文件这件事,其他都没问题,但是就偏偏好事变坏事,哎,冷静,遇事千万要平常心,要不自己真遭罪

还有就是碎片化这个问题了,小米,魅族,华为手机用公版代码是打不开权限设置页面的,非的要适配,真他妈蛋疼,我又取百度了下,还好直接就找找了,写了工具类,但是考虑了下,这个工具是打开系统页面的,我就没放在权限组件里,从工能上讲风马牛不相及的事不能放一起的,这个类叫:IntentUtils ,具体我就不方了 Demo 里面可以找到这个类