项目作者: crazyqiang

项目描述 :
AOP方式封装的6.0运行时申请权限的库—A library that request Permissions in an AOP manner.
高级语言: Java
项目地址: git://github.com/crazyqiang/Aopermission.git
创建时间: 2018-03-30T02:42:13Z
项目社区:https://github.com/crazyqiang/Aopermission

开源协议:

下载


Aopermission

AOP方式封装的6.0运行时申请权限的库—A library that request Permissions in an AOP manner.

downloadQR.png
扫描二维码或点此下载APK

更新日志

2019-06-13

  1. 1jcenter升级到1.2.0
  2. 2、修改8.0系统上透明activity引起的bug
  3. 3targetSDK升级到28
  4. 4、支持在util类中的非静态方法中申请权限(方法中的第一个参数传入context,如果参数为空,默认使用的是application)

UML Sequence Chart(UML时序图)

UML时序图.png

How to use

一、配置

1、权限库引入方式,在app模块的build.gradle中引入如下:

  1. apply plugin: 'android-aspectjx'
  2. dependencies {
  3. compile 'com.ninetripods:aop-permission:1.2.0'
  4. ..........其他............
  5. }
  6. //可选配置:include和exclude的规则是去匹配包名,如果找到匹配的包名,则整个jar(即整个库)生效,
  7. //这样做主要是考虑到性能的问题。
  8. aspectjx {
  9. include 'com.ninetripods','使用注解所在的包名'
  10. }

点此查看最新版本:https://jcenter.bintray.com/com/ninetripods/aop-permission/

2、在根目录的build.gradle里面配置如下:

  1. dependencies {
  2. classpath 'com.android.tools.build:gradle:3.0.1'//替换你的gradle版本
  3. classpath 'com.hujiang.aspectjx:gradle-android-plugin-aspectjx:2.0.4'
  4. ................其他................
  5. }

说明:aspectjx:2.0.4目前是最新版本,aspectjx历史版本查看地址:
https://github.com/HujiangTechnology/gradle_plugin_android_aspectjx/blob/master/CHANGELOG.md

3、本项目中在AOP类中用到了反射,如果你的项目中在混淆后导致权限申请失败,将下面的配置加到你的混淆配置中:

  1. -keepclasseswithmembers class * {
  2. @com.ninetripods.aopermission.permissionlib.annotation.NeedPermission <methods>;
  3. }
  4. -keepclasseswithmembers class * {
  5. @com.ninetripods.aopermission.permissionlib.annotation.PermissionCanceled <methods>;
  6. }
  7. -keepclasseswithmembers class * {
  8. @com.ninetripods.aopermission.permissionlib.annotation.PermissionDenied <methods>;
  9. }

二、使用举例

1、申请单个权限

申请单个权限:

  1. btn_click.setOnClickListener(new View.OnClickListener() {
  2. @Override
  3. public void onClick(View v) {
  4. callMap();
  5. }
  6. });
  7. /**
  8. * 申请权限
  9. */
  10. @NeedPermission(value = {Manifest.permission.ACCESS_FINE_LOCATION}, requestCode = 0)
  11. private void callMap() {
  12. Toast.makeText(this, "定位权限申请通过", Toast.LENGTH_SHORT).show();
  13. }

@NeedPermission后面的value代表需要申请的权限,是一个String[]数组;requestCode是请求码,是为了区别开同一个Activity中有多个不同的权限请求,默认是0,如果同一个Activity中只有一个权限申请,requestCode可以忽略不写。

  1. /**
  2. * 权限被取消
  3. *
  4. * @param bean CancelBean
  5. */
  6. @PermissionCanceled
  7. public void dealCancelPermission(CancelBean bean) {
  8. Toast.makeText(this, "requestCode:" + bean.getRequestCode(), Toast.LENGTH_SHORT).show();
  9. }

声明一个public方法接收权限被取消的回调,方法必须有一个CancelBean类型的参数,这点类似于EventBus,CancelBean中有requestCode变量,即是我们请求权限时的请求码。

  1. /**
  2. * 权限被拒绝
  3. *
  4. * @param bean DenyBean
  5. */
  6. @PermissionDenied
  7. public void dealPermission(DenyBean bean) {
  8. Toast.makeText(this,
  9. "requestCode:" + bean.getRequestCode()+ ",Permissions: " + Arrays.toString(bean.getDenyList().toArray()), Toast.LENGTH_SHORT).show();
  10. }

声明一个public方法接收权限被取消的回调,方法必须有一个DenyBean类型的参数,DenyBean中有一个requestCode变量,即是我们请求权限时的请求码,另外还可以通过denyBean.getDenyList()来拿到被权限被拒绝的List。

2、申请多个权限

基本用法同上,区别是@NeedPermission后面声明的权限是多个,如下:

  1. /**
  2. * 申请多个权限
  3. */
  4. @NeedPermission(value = {Manifest.permission.CALL_PHONE, Manifest.permission.CAMERA}, requestCode = 10)
  5. public void callPhone() {
  6. Toast.makeText(this, "电话、相机权限申请通过", Toast.LENGTH_SHORT).show();
  7. }

value中声明了两个权限,一个电话权限,一个相机权限

Thanks To

https://github.com/HujiangTechnology/gradle_plugin_android_aspectjx