【一】背景

6.0運(yùn)行時(shí)申請(qǐng)權(quán)限已經(jīng)是一個(gè)老生常談的內(nèi)容了，最近項(xiàng)目TargetSDKVersion升到23以上，所以我們也需要做權(quán)限管理，我想到的需求是這樣的：

1、支持單個(gè)權(quán)限、多個(gè)權(quán)限申請(qǐng)

2、運(yùn)行時(shí)申請(qǐng)

3、無(wú)侵入式申請(qǐng)，無(wú)需關(guān)注權(quán)限申請(qǐng)的邏輯

4、除了Activity、Fragment之外，還需要支持Service中申請(qǐng)

5、對(duì)國(guó)產(chǎn)手機(jī)做兼容處理

第一、二點(diǎn)，Google都有對(duì)應(yīng)的API；

第三點(diǎn)可以通過(guò)自定義注解+AOP切面方式來(lái)解決。為什么采用AOP方式呢？首先看AOP定義: 面向切面編程(Aspect-Oriented Programming)。如果說(shuō)，OOP（面向?qū)ο螅┤绻前褑?wèn)題劃分到單個(gè)模塊的話(huà)，那么AOP就是把涉及到眾多模塊的某一類(lèi)問(wèn)題進(jìn)行統(tǒng)一管理。 因?yàn)槲覀兩暾?qǐng)權(quán)限的邏輯都是基本一樣的，所以可以把申請(qǐng)權(quán)限的邏輯統(tǒng)一管理。

第四點(diǎn)稍微有點(diǎn)麻煩，因?yàn)镚oogle提供的API只支持在Activity和Fragment中去申請(qǐng)權(quán)限，Service中并沒(méi)有相應(yīng)的API，比如項(xiàng)目中的某個(gè)Service里需要拿到當(dāng)前位置信息，并且不能確定定位權(quán)限已經(jīng)給了，所以在定位之前仍然需要判斷有沒(méi)有定位權(quán)限，按照常規(guī)邏輯好像是行不通了。腫么辦呢？先說(shuō)一下我想到的辦法：通過(guò)一個(gè)透明的Activity去申請(qǐng)權(quán)限，并且把申請(qǐng)結(jié)果返回來(lái)，最后實(shí)踐也是這么做的，具體思路請(qǐng)往下看。

第五點(diǎn)也比較麻煩，如果都按Google標(biāo)準(zhǔn)來(lái)，那就不用考慮兼容問(wèn)題了，但是國(guó)產(chǎn)安卓手機(jī)碎片化比較嚴(yán)重，且基本都修改了ROM，導(dǎo)致申請(qǐng)權(quán)限的API跟期望返回的結(jié)果不一致，這種的可能就需要特殊處理了。

調(diào)研了一下比較流行的三方庫(kù)，如PermissionsDispatcher 、RxPermissions ，做了一個(gè)簡(jiǎn)單的總結(jié)：

RxPermissions是基于RX的思想，支持鏈?zhǔn)秸{(diào)用，簡(jiǎn)單方便，但是他不支持Service調(diào)用；PermissionsDispatcher使用了編譯時(shí)解析注解的方式，通過(guò)apt自動(dòng)生成.class方式幫我們?nèi)?xiě)申請(qǐng)權(quán)限的邏輯，很好很強(qiáng)大，并且適配了小米手機(jī)，但是它也不支持Service中去申請(qǐng)權(quán)限?？紤]到我們項(xiàng)目中的應(yīng)用場(chǎng)景并且借鑒了PermissionsDispatcher的申請(qǐng)權(quán)限的邏輯，決定基于AOP方式手動(dòng)擼一個(gè)權(quán)限管理庫(kù)出來(lái)。

【二】效果圖

先上一下最終的效果圖：

效果圖有點(diǎn)模糊，可以下載源碼運(yùn)行一下看效果

【三】整體思路

首先，先定義一個(gè)說(shuō)法，彈出系統(tǒng)權(quán)限彈窗，用戶(hù)沒(méi)有給權(quán)限，并且選中不再提示，這種情況稱(chēng)為權(quán)限被拒絕；如果用戶(hù)沒(méi)有給權(quán)限，但是沒(méi)有選中不再提示，這種情況稱(chēng)為權(quán)限被取消。申請(qǐng)權(quán)限、權(quán)限被取消、權(quán)限被拒絕都是采用注解的形式，分別為@NeedPermission、@PermissionCanceled、@PermissionDenied，注解都是聲明在Method級(jí)別上的。在我們的Activity、Fragment及Service中聲明注解，然后在AOP中解析我們的注解，并把申請(qǐng)的權(quán)限傳遞給一個(gè)透明的Activity去處理，并把處理結(jié)果返回來(lái)。這就是整體思路，可能會(huì)遇到的問(wèn)題：

1、 不同型號(hào)的手機(jī)兼容問(wèn)題（申請(qǐng)權(quán)限、跳設(shè)置界面）

2、AOP解析注解以及傳值問(wèn)題

上面說(shuō)了很多，其實(shí)用一個(gè)圖來(lái)表示更清晰一些：

UML時(shí)序圖.png

OK，通過(guò)上面的圖是不是更清晰了呢？其實(shí)最關(guān)鍵的地方就是AOP解析注解及傳值。AOP面向切面編程是一種編程思想，而AspectJ是對(duì)AOP編程思想的一個(gè)實(shí)踐，本文采用AspectJ來(lái)實(shí)現(xiàn)切面編程，簡(jiǎn)單介紹AspectJ的幾個(gè)概念：

1. JPoint：代碼可注入的點(diǎn)，比如一個(gè)方法的調(diào)用處或者方法內(nèi)部，對(duì)于本文來(lái)說(shuō)即是注解作用的方法。
2. Pointcut：用來(lái)描述 JPoint 注入點(diǎn)的一段表達(dá)式。見(jiàn)下面例子
3. Advice：常見(jiàn)的有 Before、After、Around 等，表示代碼執(zhí)行前、執(zhí)行后、替換目標(biāo)代碼，也就是在 Pointcut 何處編織代碼。
4. Aspect：切面，Pointcut 和 Advice 合在一起稱(chēng)作 Aspect。

關(guān)于AspectJ的介紹及用法的文章很多，不了解的朋友可以去google下，直接列一下AOP切面代碼：

@Aspect
public class PermissionAspect {

  private static final String PERMISSION_REQUEST_POINTCUT =
      "execution(@com.ninetripods.aopermission.permissionlib.annotation.NeedPermission * *(..))";

  @Pointcut(PERMISSION_REQUEST_POINTCUT + " && @annotation(needPermission)")
  public void requestPermissionMethod(NeedPermission needPermission) {
  }

  @Around("requestPermissionMethod(needPermission)")
  public void AroundJoinPoint(final ProceedingJoinPoint joinPoint, NeedPermission needPermission) {

    Context context = null;
    final Object object = joinPoint.getThis();
    if (object instanceof Context) {
      context = (Context) object;
    } else if (object instanceof Fragment) {
      context = ((Fragment) object).getActivity();
    } else if (object instanceof android.support.v4.app.Fragment) {
      context = ((android.support.v4.app.Fragment) object).getActivity();
    }
    if (context == null || needPermission == null) return;

    PermissionRequestActivity.PermissionRequest(context, needPermission.value(),
        needPermission.requestCode(), new IPermission() {
          @Override
          public void PermissionGranted() {
            try {
              joinPoint.proceed();
            } catch (Throwable throwable) {
              throwable.printStackTrace();
            }
          }

          @Override
          public void PermissionDenied(int requestCode, List<String> denyList) {
            Class<?> cls = object.getClass();
            Method[] methods = cls.getDeclaredMethods();
            if (methods == null || methods.length == 0) return;
            for (Method method : methods) {
              //過(guò)濾不含自定義注解PermissionDenied的方法
              boolean isHasAnnotation = method.isAnnotationPresent(PermissionDenied.class);
              if (isHasAnnotation) {
                method.setAccessible(true);
                //獲取方法類(lèi)型
                Class<?>[] types = method.getParameterTypes();
                if (types == null || types.length != 1) return;
                //獲取方法上的注解
                PermissionDenied aInfo = method.getAnnotation(PermissionDenied.class);
                if (aInfo == null) return;
                //解析注解上對(duì)應(yīng)的信息
                DenyBean bean = new DenyBean();
                bean.setRequestCode(requestCode);
                bean.setDenyList(denyList);
                try {
                  method.invoke(object, bean);
                } catch (IllegalAccessException e) {
                  e.printStackTrace();
                } catch (InvocationTargetException e) {
                  e.printStackTrace();
                }
              }
            }
          }

          @Override
          public void PermissionCanceled(int requestCode) {
            Class<?> cls = object.getClass();
            Method[] methods = cls.getDeclaredMethods();
            if (methods == null || methods.length == 0) return;
            for (Method method : methods) {
              //過(guò)濾不含自定義注解PermissionCanceled的方法
              boolean isHasAnnotation = method.isAnnotationPresent(PermissionCanceled.class);
              if (isHasAnnotation) {
                method.setAccessible(true);
                //獲取方法類(lèi)型
                Class<?>[] types = method.getParameterTypes();
                if (types == null || types.length != 1) return;
                //獲取方法上的注解
                PermissionCanceled aInfo = method.getAnnotation(PermissionCanceled.class);
                if (aInfo == null) return;
                //解析注解上對(duì)應(yīng)的信息
                CancelBean bean = new CancelBean();
                bean.setRequestCode(requestCode);
                try {
                  method.invoke(object, bean);
                } catch (IllegalAccessException e) {
                  e.printStackTrace();
                } catch (InvocationTargetException e) {
                  e.printStackTrace();
                }
              }
            }
          }
        });
  }
}

代碼有點(diǎn)多，但是思路還是挺清晰的，首先定義@Pointcut（描述的是我們的注解@NeedPermission），接著由Advice(@Around)及Pointcut構(gòu)成我們的切面Aspect， 在切面Aspect中，通過(guò)joinPoint.getThis()根據(jù)不同來(lái)源來(lái)獲得Context，接著跳轉(zhuǎn)到一個(gè)透明Activity申請(qǐng)權(quán)限并通過(guò)接口回調(diào)拿到權(quán)限申請(qǐng)結(jié)果，最后在不同的回調(diào)方法里通過(guò)反射把回調(diào)結(jié)果回傳給調(diào)用方。

【四】使用舉例

為了簡(jiǎn)化AspectJ的各種配置，這里用了一個(gè)三方的gradle插件：

https://github.com/HujiangTechnology/gradle_plugin_android_aspectjx

1、權(quán)限庫(kù)引入方式，在app模塊的build.gradle中引入如下：

apply plugin: 'android-aspectjx'

dependencies {
   compile 'com.ninetripods:aop-permission:1.0.1'
   ..........其他............
}

2、在整個(gè)工程的build.gradle里面配置如下：

dependencies {
  classpath 'com.android.tools.build:gradle:2.3.3'
  classpath 'com.hujiang.aspectjx:gradle-android-plugin-aspectjx:1.0.8'
  ................其他................
}

說(shuō)明： aspectjx:1.0.8不是最新版本，最高支持gradle的版本到2.3.3，如果你的工程里gradle版本是3.0.0以上，請(qǐng)使用aspectjx：1.1.0以上版本，aspectjx歷史版本查看地址：

https://github.com/HujiangTechnology/gradle_plugin_android_aspectjx/blob/master/CHANGELOG.md

3、如果你的項(xiàng)目里使用了混淆，需要在AOP代碼進(jìn)行hook的類(lèi)及方法名不能被混淆,即被注解作用的類(lèi)及方法不能被混淆，需要在混淆配置里keep住, 比如:

package com.hujiang.test;

public class A {

  @NeedPermission
  public boolean funcA(String args) {
    ....
  }
}

//如果你在AOP代碼里對(duì)A#funcA(String)進(jìn)行hook, 那么在混淆配置文件里加上這樣的配置

-keep class com.hujiang.test.A {*;}

4、終于配好了，都閃開(kāi)，我要開(kāi)始舉栗子了：

下面以Activity中申請(qǐng)權(quán)限為例，F(xiàn)ragment、Service中使用是一樣的，就不一一寫(xiě)了，源碼中也有相應(yīng)使用的Demo

4.1 申請(qǐng)單個(gè)權(quán)限

申請(qǐng)單個(gè)權(quán)限：

btn_click.setOnClickListener(new View.OnClickListener() {
  @Override
  public void onClick(View v) {
    callMap();
  }
});

/**
 * 申請(qǐng)權(quán)限
 */
@NeedPermission(value = {Manifest.permission.ACCESS_FINE_LOCATION}, requestCode = 0)
private void callMap() {
  Toast.makeText(this, "定位權(quán)限申請(qǐng)通過(guò)", Toast.LENGTH_SHORT).show();
}

@NeedPermission后面的value代表需要申請(qǐng)的權(quán)限，是一個(gè)String[]數(shù)組；requestCode是請(qǐng)求碼，是為了區(qū)別開(kāi)同一個(gè)Activity中有多個(gè)不同的權(quán)限請(qǐng)求，默認(rèn)是0，如果同一個(gè)Activity中只有一個(gè)權(quán)限申請(qǐng)，requestCode可以忽略不寫(xiě)。

/**
 * 權(quán)限被取消
 *
 * @param bean CancelBean
 */
@PermissionCanceled
public void dealCancelPermission(CancelBean bean) {
  Toast.makeText(this, "requestCode:" + bean.getRequestCode(), Toast.LENGTH_SHORT).show();
}

聲明一個(gè)public方法接收權(quán)限被取消的回調(diào)， 方法必須有一個(gè)CancelBean類(lèi)型的參數(shù) ，這點(diǎn)類(lèi)似于EventBus，CancelBean中有requestCode變量，即是我們請(qǐng)求權(quán)限時(shí)的請(qǐng)求碼。

/**
 * 權(quán)限被拒絕
 *
 * @param bean DenyBean
 */
@PermissionDenied
public void dealPermission(DenyBean bean) {
    Toast.makeText(this, 
    "requestCode:" + bean.getRequestCode()+ ",Permissions: " + Arrays.toString(bean.getDenyList().toArray()), Toast.LENGTH_SHORT).show();
 }

聲明一個(gè)public方法接收權(quán)限被取消的回調(diào)， 方法必須有一個(gè)DenyBean類(lèi)型的參數(shù) ，DenyBean中有一個(gè)requestCode變量，即是我們請(qǐng)求權(quán)限時(shí)的請(qǐng)求碼，另外還可以通過(guò)denyBean.getDenyList()來(lái)拿到被權(quán)限被拒絕的List。

4.2 申請(qǐng)多個(gè)權(quán)限

基本用法同上，區(qū)別是@NeedPermission后面聲明的權(quán)限是多個(gè)，如下：

/**
 * 申請(qǐng)多個(gè)權(quán)限
 */
@NeedPermission(value = {Manifest.permission.CALL_PHONE, Manifest.permission.CAMERA}, requestCode = 10)
public void callPhone() {
  Toast.makeText(this, "電話(huà)、相機(jī)權(quán)限申請(qǐng)通過(guò)", Toast.LENGTH_SHORT).show();
}

value中聲明了兩個(gè)權(quán)限，一個(gè)電話(huà)權(quán)限，一個(gè)相機(jī)權(quán)限

4.3 跳轉(zhuǎn)到設(shè)置類(lèi)

當(dāng)用戶(hù)拒絕權(quán)限并選中不再提示后，需要引導(dǎo)用戶(hù)去設(shè)置界面打開(kāi)權(quán)限，因?yàn)閲?guó)產(chǎn)手機(jī)各個(gè)設(shè)置界面不一樣，用通用的API可能會(huì)跳轉(zhuǎn)不到相應(yīng)的APP設(shè)置界面，這里采用了策略模式（下圖所示）

跳轉(zhuǎn)到設(shè)置類(lèi).png

如需做兼容，只需要在庫(kù)里修改，調(diào)用方是不需要處理的，調(diào)用方如需跳轉(zhuǎn)到設(shè)置界面，只需像下面這樣調(diào)用就OK了：

【五】總結(jié)

回看一下我們的需求，基本上都實(shí)現(xiàn)了：

1、首先通過(guò)@NeedPermission、@PermissionCanceled、@PermissionDenied三個(gè)注解來(lái)分別定義權(quán)限申請(qǐng)、被取消、被拒絕三種情況，如果不想處理被取消的邏輯就不用使用@PermissionCanceled注解，其他權(quán)限申請(qǐng)的邏輯調(diào)用方不用關(guān)心，是完全解耦的；

2、同時(shí)支持在Activity、Fragment、Service中去申請(qǐng)權(quán)限；

3、最后關(guān)于申請(qǐng)權(quán)限、跳設(shè)置界面的兼容問(wèn)題，因?yàn)樯磉叺氖謾C(jī)有限，不能測(cè)試出所有兼容問(wèn)題，需要后續(xù)優(yōu)化。

關(guān)于在AOP中通過(guò) 反射方式 把權(quán)限申請(qǐng)結(jié)果返回給調(diào)用方，是參考了EventBus的方式，感覺(jué)這樣用起來(lái)更方便一些；之前的做法是在AOP對(duì)應(yīng)的Java類(lèi)中聲明接口，調(diào)用方實(shí)現(xiàn)該接口，然后通過(guò)接口回調(diào)的方式將權(quán)限申請(qǐng)結(jié)果回傳，也能實(shí)現(xiàn)同樣效果，但是感覺(jué)沒(méi)有反射方式更方便。以上就是全部?jī)?nèi)容，后面會(huì)貼出源碼，如有使用不當(dāng)之處，歡迎批評(píng)指正！

【六】源碼

源碼地址： https://github.com/crazyqiang/Aopermission

以上就是本文的全部?jī)?nèi)容，希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。