PermissionsDispatcher,Android 6.0 运行时权限

image

运行时权限

从 Android 6.0(API 级别 23)开始,用户开始在应用运行时向其授予权限,而不是在应用安装时授予。

系统权限分为两类:

  • 正常权限:只需在你应用的 Androidmanifest.xml 中列出,安装时授权。
  • 危险权限:需要在你应用的 Androidmanifest.xml 中列出,并在运行时授权。

如需了解更多关于正常权限与危险权限可以参阅这里

关于 Android 6.0 运行时权限的详细讲解可以看这篇文章官方文档

运行时权限的加入增加了用户隐私的安全,但同时也给开发者带来了一些负担,因为多了检查权限,请求权限,处理权限请求响应的步骤。

于是就出现了一些框架,用于简化运行时权限的处理,如 PermissionsDispatcherDexterRxPermissionseasypermissions 等。

这里只用过 easypermissions 和 PermissionsDispatcher,最终选择了 PermissionsDispatcher,原因是使用人数最多,api 设计简单易用,兼容性较好,easypermissions 使用起来相对麻烦一些。

PermissionsDispatcher

PermissionsDispatcher 提供简单的基于注解的 api 处理 Android Marshmallow 下的运行时权限(非反射方式)。

项目地址:https://github.com/hotchemi/PermissionsDispatcher

一. 集成说明

注意把 ${latest.version} 改为最新版本

打开命令行,cd 到工程根目录,执行 gradlew -version 或者 gradlew -v 命令查看当前工程 gradle 版本。

根据 gradle 版本进行如下配置:

Android Gradle Plugin >= 2.2

在 app 模块下的 build.gradle 添加下面的配置:

dependencies {
  compile 'com.github.hotchemi:permissionsdispatcher:${latest.version}'
  annotationProcessor 'com.github.hotchemi:permissionsdispatcher-processor:${latest.version}'
}

Android Gradle Plugin < 2.2

在 project-level 下的 build.gradle 添加下面配置:

buildscript {
  dependencies {
    classpath 'com.neenbedankt.gradle.plugins:android-apt:1.8'
  }
}

然后,在 app 模块下的 build.gradle 添加下面配置:

apply plugin: 'android-apt'

dependencies {
  compile 'com.github.hotchemi:permissionsdispatcher:${latest.version}'
  apt 'com.github.hotchemi:permissionsdispatcher-processor:${latest.version}'
}

二. 使用说明

1. 添加注解

注意:注解的方法不能是 private 的。

相关注解说明

注解 是否必须 描述
@RuntimePermissions 注册一个 ActivityFragment 用于处理权限
@NeedsPermission 注解一个方法,说明需要什么权限(一个或多个)
@OnShowRationale 注解一个方法,解释为什么需要这些权限
@OnPermissionDenied 注解一个方法,当用户拒绝授权时将调用该方法
@OnNeverAskAgain 注解一个方法,当用户选择了 "不再提醒" 将调用该方法

示例代码

@RuntimePermissions 
public class MainActivity extends AppCompatActivity {

    // 单个权限
    // @NeedsPermission(Manifest.permission.CAMERA)
    // 多个权限
    @NeedsPermission({ Manifest.permission.CAMERA, Manifest.permission.RECORD_AUDIO })
    void showCamera() {
        getSupportFragmentManager().beginTransaction()
                .replace(R.id.sample_content_fragment, CameraPreviewFragment.newInstance())
                .addToBackStack("camera")
                .commitAllowingStateLoss();
    }
    
    // 向用户说明为什么需要这些权限(可选)
    @OnShowRationale(Manifest.permission.CAMERA)
    void showRationaleForCamera(final PermissionRequest request) {
        new AlertDialog.Builder(this)
            .setMessage(R.string.permission_camera_rationale)
            .setPositiveButton(R.string.button_allow, (dialog, button) -> request.proceed())
            .setNegativeButton(R.string.button_deny, (dialog, button) -> request.cancel())
            .show();
    }

    // 用户拒绝授权回调(可选)
    @OnPermissionDenied(Manifest.permission.CAMERA)
    void showDeniedForCamera() {
        Toast.makeText(this, R.string.permission_camera_denied, Toast.LENGTH_SHORT).show();
    }

    // 用户勾选了“不再提醒”时调用(可选)
    @OnNeverAskAgain(Manifest.permission.CAMERA)
    void showNeverAskForCamera() {
        Toast.makeText(this, R.string.permission_camera_neverask, Toast.LENGTH_SHORT).show();
    }
}

2. 调用自动生成的辅助类

注解写好后,Build ——> Make Module ***PermissionsDispatcher 会生成一个 MainActivityPermissionsDispatcher(Activity Name + PermissionsDispatcher),你可以使用它来安全地访问这些受权限保护的方法。

你唯一需要做的一件事是将工作委托给这个辅助类:

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    findViewById(R.id.button_camera).setOnClickListener(v -> {
      // 调用带权限检查的 showCamera 方法
      MainActivityPermissionsDispatcher.showCameraWithCheck(this);
    });
}

@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    // 代理权限处理到自动生成的方法
    MainActivityPermissionsDispatcher.onRequestPermissionsResult(this, requestCode, grantResults);
}

*PermissionDispatcher.*WithCheck 方法对你原来的方法进行了包装,包了一层权限检查的代码,你需要做的就是把原来的方法调用改为 *PermissionDispatcher.*WithCheck。另外,在 onRequestPermissionsResult 中回调 *PermissionsDispatcher.onRequestPermissionsResult 方法。

三. 获取特殊权限

两个特殊权限:

  • Manifest.permission.SYSTEM_ALERT_WINDOW:显示悬浮窗
  • Manifest.permission.WRITE_SETTINGS:读写系统设置

对于这两个权限,在 Android 下默认是需要到 Settings -> Apps 中手动授权的。由于不同 ROM 情况可能还有点不一样。

PermissionsDispatcher 对于两个特殊权限也做了兼容处理(Android6.0+),使用方法如上一样。

如果需要兼容低版本的 Android 系统或者不同 ROM 可以参考这个开源项目

四. maxSdkVersion

<uses-permission> 有一个 maxSdkVersion 属性,PermissionsDispatcher 对它也做了支持。

比如,在 Androidmanifest.xml 中定义了如下权限:

<uses-permission
     android:name="android.permission.WRITE_EXTERNAL_STORAGE"
     android:maxSdkVersion="18" />

注解中添加 maxSdkVersion

@RuntimePermissions
public class MainActivity extends AppCompatActivity {

    @NeedsPermission(value = Manifest.permission.WRITE_EXTERNAL_STORAGE, maxSdkVersion = 18)
    void getStorage() {
        // ...
    }
    
}

PermissionsDispatcher Plugin

PermissionsDispatcher Plugin 是 PermissionsDispatcher 的辅助插件,支持自动生成权限检查相关代码。

项目地址:https://github.com/shiraji/permissions-dispatcher-plugin

安装说明:Android Studio 中打开 Setting,Plugins ——> Browse repositories... 搜索 PermissionsDispatcher plugin,点 Install 下载安装,安装完成后重启生效。

image
image

使用说明:

  1. 在 Activity/Fragment 中,Generate -> Generate Runtime Permissions...
  2. 选择权限并为每个注解输入方法名
  3. 点击 Generate ,完成

使用过程中发现有两个小问题需要注意一下:

  1. 多次生成代码,onRequestPermissionsResult 方法也会被自动添加多次
  2. 代码生成后会提示你是否 rebuild 工程,建议选择取消,Build ——> Make Module *** 相对快些
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 142,461评论 1 300
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 61,089评论 1 256
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 94,078评论 0 212
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 40,938评论 0 175
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 48,698评论 1 255
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 38,733评论 1 175
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 30,340评论 2 268
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 29,138评论 0 165
  • 想象着我的养父在大火中拼命挣扎,窒息,最后皮肤化为焦炭。我心中就已经是抑制不住地欢快,这就叫做以其人之道,还治其人...
    爱写小说的胖达阅读 28,949评论 6 229
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 32,493评论 0 213
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 29,269评论 2 214
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 30,591评论 1 229
  • 白月光回国,霸总把我这个替身辞退。还一脸阴沉的警告我。[不要出现在思思面前, 不然我有一百种方法让你生不如死。]我...
    爱写小说的胖达阅读 24,216评论 0 31
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 27,107评论 2 213
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 31,485评论 3 204
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 25,615评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,006评论 0 167
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 33,496评论 2 230
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 33,572评论 2 230

推荐阅读更多精彩内容