鸿蒙开源三方组件(soul-permission)--权限检查、请求-51CTO.COM

[[414377]]

想了解更多内容，请访问：

51CTO和华为官方合作共建的鸿蒙技术社区

https://harmonyos.51cto.com

1. 介绍

soul-permission是一个权限组件，主要对权限的检查及请求。方法级权限适配、解耦FractionAbility和Fraction、不再需要Context、不再需要onPermissionResult,支持特殊权限(Notification[通知]、SystemAlert[应用悬浮窗]、UNKNOW_SOURCE[未知来源应用安装]、

WRITE_SYS_SETTINGS[写入系统设置])的检查与请求。

2. 效果展示

3. 依赖

(1). 在工程的build.gradle的allprojects中，添加HAR所在的Maven仓地址

repositories { 
    maven { 
        url 'https://s01.oss.sonatype.org/content/repositories/releases/' 
    } 
}

(2). 在应用模块的build.gradle的dependencies闭包中，添加如下代码:

dependencies { 
        implementation 'io.github.dzsf:soul-permission:1.0.0' 
    }

4. 使用说明

(1). 一句话版本完成自动判断、权限检查、请求、后续操作：

SoulPermission.getInstance().checkAndRequestPermission(SystemPermission.LOCATION, 
        //if you want do noting or no need all the callbacks you may use SimplePermissionAdapter instead 
        new CheckRequestPermissionListener() { 
            @Override 
            public void onPermissionOk(Permission permission) { 
                Utils.showMessage(ApiGuideAbility.this, permission.toString() + "\n is ok , you can do your operations"); 
            } 
 
            @Override 
            public void onPermissionDenied(Permission permission) { 
                Utils.showMessage(ApiGuideAbility.this, permission.toString() + " \n is refused , you can not do next things"); 
            } 
        });

(2). 也可以一次请求多项权限

SoulPermission.getInstance().checkAndRequestPermissions( 
           Permissions.build(SystemPermission.CAMERA, SystemPermission.WRITE_USER_STORAGE), 
           //if you want do noting or no need all the callbacks you may use SimplePermissionsAdapter instead 
           new CheckRequestPermissionsListener() { 
               @Override 
               public void onAllPermissionOk(Permission[] allPermissions) { 
                   Utils.showMessage(ApiGuideAbility.this, allPermissions.length + "permissions is ok" + " \n  you can do your operations"); 
               } 
 
               @Override 
               public void onPermissionDenied(Permission[] refusedPermissions) { 
                   Utils.showMessage(ApiGuideAbility.this, refusedPermissions[0].toString() + " \n is refused , you can not do next things"); 
               } 
           });

(3). 包含shouldShowRequestPermissionRationale的情形

SoulPermission.getInstance().checkAndRequestPermission(SystemPermission.READ_CONTACTS, 
          new CheckRequestPermissionListener() { 
              @Override 
              public void onPermissionOk(Permission permission) { 
                  Utils.showMessage(ApiGuideAbility.this, permission.toString() + "\n is ok , you can do your operations"); 
              } 
 
              @Override 
              public void onPermissionDenied(Permission permission) { 
                  // see CheckPermissionWithRationaleAdapter 
                  if (permission.shouldRationale()) { 
                      Utils.showMessage(ApiGuideAbility.this, permission.toString() + " \n you should show a explain for user then retry "); 
                  } else { 
                      Utils.showMessage(ApiGuideAbility.this, permission.toString() + " \n is refused , you can not do next things"); 
                  } 
              } 
          });

(4). 检查某项权限

//you can also use checkPermissions() for a series of permissions 
  Permission checkResult = SoulPermission.getInstance().checkSinglePermission(SystemPermission.LOCATION);

(5). 检查特殊权限[通知权限]

boolean checkResult = SoulPermission.getInstance().checkSpecialPermission(Special.NOTIFICATION);

(6). 检查并请求特殊权限[未知应用安装]

//if you want do noting or no need all the callbacks you may use SimpleSpecialPermissionAdapter instead 
  SoulPermission.getInstance().checkAndRequestPermission(Special.UNKNOWN_APP_SOURCES, new SpecialPermissionListener() { 
              @Override 
              public void onGranted(Special permission) { 
                  Utils.showMessage(ApiGuideAbility.this, "install unKnown app  is enable now "); 
              } 
 
              @Override 
              public void onDenied(Special permission) { 
                  Utils.showMessage(ApiGuideAbility.this, "install unKnown app  is disable yet"); 
              } 
          });

(7). 跳转到应用设置页

SoulPermission.getInstance().goApplicationSettings(data -> { 
           //if you need to know when back from app detail 
           Utils.showMessage(ApiGuideAbility.this, "back from go appDetail"); 
       });

(8). 注意事项：

SoulPermission内部使用contentProvider自动初始化， 
   如果你项目中使用了通过替换Application方式从而可能会导致SoulPermission内部初始化失败的框架(如Tinker，腾讯乐固等)， 
   请手动在你的Application类中调用init即可（通过设置debug，可以看到错误日志打印和相关Toast）。 
   // invoke init in your application when auto init failed 
   public class MyApplication extends AbilityPackage { 
    
       @Override 
       public void onInitialize() { 
           super.onInitialize(); 
           SoulPermission.setDebug(true); 
       } 
   }