HarmonyOS自定义权限组件--你真的弄懂了权限控制了吗? 原创 精华

开源夏德旺
发布于 2021-9-7 16:10
浏览
7收藏

前言

    关于HarmonyOS的动态授权的常规操作流程和代码我之前写过一篇文章,请看《鸿蒙动态权限申请完整规范流程和操作详解(https://harmonyos.51cto.com/posts/5165)》。
    权限控制是在进行HarmonyOS应用开发中非常重要的一个环节,几乎所有的商业应用中都会涉及到。我们在曾经使用的Android app应用中经常会遇到一些app会弹出各种敏感权限授权窗口提示用户授权,有些app(特别是流氓应用)经常会在第一次打开app的时候就提醒用户授予所有需要的权限,甚至一些权限跟app功能根本不相关(比如读取通讯录等),如果不授权则直接不让你使用该app,我遇到这类流氓应用一般果断卸载。而真正的开发过程中我们在权限申请的时候一般要遵循以下3个原则:
1、最小权限集,即应用中确实需要的权限才进行申请。
2、需要用到XX权限时才进行申请,即并不是app开始的时候一次性申请所有权限,而是需要用到XX特定功能必须要授权才能使用的时候(比如调用照相机),这个时候才申请该特定权限。
3、未获取用户授权的话依然能使用应用大部分功能,只是必须授权的功能无法使用。

下面我针对敏感权限申请更好的复用,编写了一个第三方开源组件,取名为XdwPermissionsLib
具体项目源码请见https://gitee.com/xdw1019/XdwPermissionsLib

XdwPermissionsLib

介绍

鸿蒙权限请求框架,提供一个符合正规权限调用流程的框架并基于链式调用(这里简称strong模式),同时提供一个并不推荐使用的简单权限框架(简称lazy模式)。

strong模式:正式项目推荐使用该模式。正规权限处理流程,用户需要检验权限并且处理校验结果的回调。

lazy模式:该模式下开发者几乎不用去编写请求权限的代码,特别是不处理回调。该模式不推荐在正式项目中使用,可以用于平时编写某些demo又不想处理权限的场景下。当然有些app不在乎用户体验,只要不授权就不让使用的情况可以使用该模式。

动态申请权限流程图

HarmonyOS自定义权限组件--你真的弄懂了权限控制了吗?-鸿蒙开发者社区

运行效果图展示:

Strong模式下的效果图:

图片待补充

lazy模式下的效果图:

图片待补充

使用说明

Strong模式:

1.引用

方式一: 通过mylibrary模块生成har包,添加har包到libs文件夹内

方式二:maven引入(待后续上传到maven中心仓库再支持)

2.定义权限组,比如

    //定义需要动态申请的权限组,可以是一个或多个权限。这里的权限还必须要在config.json中进行配置
    private String[] permissions = {
            // 存储权限
            SystemPermission.WRITE_USER_STORAGE,
            // 相机权限
            SystemPermission.CAMERA
    };

3.在需要触发权限申请的地方调用如下代码:

//开始动态申请权限,链式调用。
//实际开发中申请权限的动作应该放到需要用到该权限的操作中触发,比如点击某个按钮调起相机    StrongPermissionsUtils.getInstance(this).checkPermissions(this,permissions).setPermissionStateListener(new StrongPermissionsUtils.PermissionStateListener() {
            @Override
            public void onPermissionGranted() {
                //授权成功之后的回调
                //此处根据自己的实际业务编写业务逻辑,此处用toast进行演示
                ToastUtil.toast(getContext(),"授权成功");
            }

            @Override
            public void onPermissionDenied(boolean isDisabledPrompt) {
                //授权拒绝之后的回调
                //此处根据自己的实际业务编写业务逻辑,此处用toast进行演示
                if(isDisabledPrompt){
                    ToastUtil.toast(getContext(),"您之前拒绝了授权并且禁止系统再提示,需要手动进入系统设置页面开启");
                }else{
                    ToastUtil.toast(getContext(),"您拒绝了授权");
                }
            }
        });

4.在当前的ability重写onRequestPermissionsFromUserResult方法,代码如下:

@Override
public void onRequestPermissionsFromUserResult(int requestCode, String[] permissions, int[] grantResults) {
        super.onRequestPermissionsFromUserResult(requestCode, permissions, grantResults);
        //鉴权之后的回调,必须调用
        StrongPermissionsUtils.getInstance(this).onRequestPermissionsResult(requestCode, permissions, grantResults);
    }
Lazy模式:

1.引用

方式一: 通过mylibrary模块生成har包,添加har包到libs文件夹内

方式二:maven引入(待后续上传到maven中心仓库再支持)

2、将需要调用的Ability继承LazyPermissionAblity,如下:

public class MainAbility extends LazyPermissionAblity {

3、在当前Ability中定义权限组,并且在onStart方法的第一行调用setPermissions方法,如下:

public class MainAbility extends LazyPermissionAblity {
    //定义需要动态申请的权限组,可以是一个或多个权限。这里的权限还必须要在config.json中进行配置
    private String[] permissions = {
            // 存储权限
            SystemPermission.WRITE_USER_STORAGE,
            // 相机权限
            SystemPermission.CAMERA
    };
    @Override
    public void onStart(Intent intent) {
        //lazy模式下,setPermissions的代码调用必须放在onStart的第一行
        super.setPermissions(permissions);
        super.onStart(intent);
        super.setMainRoute(MainAbilitySlice.class.getName());
    }
}

工程结构说明

工程中总共有三个module,分别为mylibrary、entry和LazySample。

mylibrary: 自定义的第三方权限库,供外部项目调用。

entry: 用来演示mylibrary库中strong模式下的权限调用。

LazySample: 用来演示mylibrary库中lazy模式下的权限调用。

©著作权归作者所有,如需转载,请注明出处,否则将追究法律责任
标签
XdwPermissionsLib.zip 2.94M 30次下载
已于2021-9-7 16:14:48修改
10
收藏 7
回复
举报
4条回复
按时间正序
/
按时间倒序
红叶亦知秋
红叶亦知秋

现在的应用市场太需要楼主这样优质开发者了。(有的APP要的权限实在太多了)

回复
2021-9-7 17:36:53
开源夏德旺
开源夏德旺 回复了 红叶亦知秋
现在的应用市场太需要楼主这样优质开发者了。(有的APP要的权限实在太多了)

是滴,有些app纯粹是流氓应用,有些app是程序员懒惰,不想精细化控制权限,就是采用我代码里面的那种lazy模式来实现的

回复
2021-9-7 17:39:52
软通动力HOS
软通动力HOS

感谢夏老师的长期分享

回复
2021-9-26 14:09:31
软通田可辉
软通田可辉

感谢夏老师的长期分享

回复
2021-9-26 14:12:26
回复
    相关推荐