Android使用AOP实现动态权限获取

背景

我们都知道Android项目中包含一项配置，叫做TargetSDKVersion，这里使用不同的版本号，会使用不同Android版本的特性，也需要我们对相应的版本进行兼容。

targetSdkVersion is the main way Android provides forward compatibility

targetSdkVersion 是 Android 系统提供前向兼容的主要手段。这是什么意思呢？随着 Android 系统的升级，某个系统的 API 或者模块的行为可能会发生改变，但是为了保证老 APK 的行为还是和以前兼容。只要 APK 的 targetSdkVersion 不变，即使这个 APK 安装在新 Android 系统上，其行为还是保持老的系统上的行为，这样就保证了系统对老应用的前向兼容性。

最近，部门决定对项目的TargetSDKVersion进行提高，由原来的21提升到27，以应对未来国内市场对TargetSDKVersion的限制。

而当TargetSDKVersion升级到23的时候，Android对权限的进行了调整，我们无法直接使用，在Manifest中声明过的敏感权限。

具体的敏感权限如下：

<!-- CALENDAR 日历组 -->
<uses-permission android:name="android.permission.READ_CALENDAR" />
<uses-permission android:name="android.permission.WRITE_CALENDAR" />
<!-- CAMERA 相机拍照组 -->
<uses-permission android:name="android.permission.CAMERA" />
<!-- CONTACTS 联系人组 -->
<uses-permission android:name="android.permission.READ_CONTACTS" />
<uses-permission android:name="android.permission.WRITE_CONTACTS" />
<uses-permission android:name="android.permission.GET_ACCOUNTS" />
<!-- LOCATION 定位组 -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<!-- MICROPHONE 麦克风组 -->
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<!-- PHONE 组 -->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.CALL_PHONE" />
<uses-permission android:name="android.permission.READ_CALL_LOG" />
<uses-permission android:name="android.permission.WRITE_CALL_LOG" />
<uses-permission android:name="android.permission.USE_SIP" />
<uses-permission android:name="android.permission.PROCESS_OUTGOING_CALLS" />
<!-- SENSORS 传感器组 -->
<uses-permission android:name="android.permission.BODY_SENSORS" />
<!-- SMS 组 -->
<uses-permission android:name="android.permission.SEND_SMS" />
<uses-permission android:name="android.permission.RECEIVE_SMS" />
<uses-permission android:name="android.permission.READ_SMS" />
<uses-permission android:name="android.permission.RECEIVE_WAP_PUSH" />
<uses-permission android:name="android.permission.RECEIVE_MMS" />
<!-- STORAGE 存储组 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

所以，提升后，需要在运行时进行动态权限获取。

目的

让组内开发人员可以方便的在需要获取权限的地方，快速接入判断功能。

实现

使用方法

在想要加入权限判断的方法上面加入以下注解，具体权限根据实际添加。

@NeedPermission({Manifest.permission.WRITE_EXTERNAL_STORAGE,
	Manifest.permission.READ_PHONE_STATE,
	Manifest.permission.READ_CONTACTS})

用户如果拒绝权限，方法内容将不会执行。

如果想要获取到用户的拒绝操作，在检查方法的同一个类中，加入

//方法名随意，可以没有参数，或者包含一个List<String>类型参数用来获取被拒绝的权限
@PermissionDenied
public void denyPermission(List<String> permissions) {
	for (String p:permissions) {
		Log.d("AOPMonitor", p);
	}
}

注意：

方法所在类必须是Activity或者Fragment
NeedPermission不要加在Activity的生命周期方法上。

原理

首先，我们需要两个注解。

/**
 * API大于等于23时，来对方法进行权限判断的
 */
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface NeedPermission {

    String[] value();

}

/**
 * 用来接收权限被拒绝的通知
 */
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface PermissionDenied {
}

然后对拥有NeedPermission注解方法进行代码织入

@Aspect
public class NeedPermissionAspect {

    private static final int ANDROID_M = 23;

	//定位NeedPermission注解，并获取注解对象
    @Pointcut("execution(@com.tts.android.aopmonitor.annotation.NeedPermission * *(..)) && @annotation(needPermission)")
    public void needPermission(NeedPermission needPermission){}

    @Around("needPermission(needPermission)")
    public void checkPermission(final ProceedingJoinPoint point, NeedPermission needPermission) {
        Context context = null;
        final Object object = point.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) {
            LogUtils.loge("the method is not belong to a activity or fragment, " +
                    "or NeedPermission annotation not found");
            try {
                point.proceed();
            } catch (Throwable throwable) {
                throwable.printStackTrace();
            }
            return;
        }
        /**
         * 小于23的版本不需要动态权限验证
         */
        if (DeviceUtils.getSDKVersionCode() < ANDROID_M) {
            try {
                point.proceed();
            } catch (Throwable throwable) {
                throwable.printStackTrace();
            }
            return;
        }
        //开始检查并获取权限，使用AndPermission框架
        AndPermission.with(context)
                .runtime()
                .permission(needPermission.value())
                .onGranted(new Action<List<String>>() {
                    @Override
                    public void onAction(List<String> data) {
                        try {
                            point.proceed();
                        } catch (Throwable throwable) {
                            throwable.printStackTrace();
                        }
                    }
                })
                .onDenied(new Action<List<String>>() {
                    @Override
                    public void onAction(List<String> data) {
                    	/**
                    	 * 被拒绝后，使用反射，获取PermissionDenied注解的方法，执行内容
                    	 */
                        Class<?> cls = object.getClass();
                        Method[] methods = cls.getDeclaredMethods();
                        if (methods == null || methods.length == 0) {
                            return;
                        }
                        for (Method method : methods) {
                            //过滤不含自定义注解PermissionDenied的方法
                            boolean isHasAnnotation = method.isAnnotationPresent(PermissionDenied.class);
                            if (isHasAnnotation) {
                                method.setAccessible(true);
                                //获取方法参数类型
                                Class<?>[] types = method.getParameterTypes();
                                //获取方法上的注解
                                PermissionDenied aInfo = method.getAnnotation(PermissionDenied.class);
                                if (aInfo == null) {
                                    return;
                                }
                                try {
                                    if (null != types && types.length == 1 ) {
                                        method.invoke(object, data);
                                    }
                                    else {
                                        method.invoke(object);
                                    }
                                } catch (IllegalAccessException e) {
                                    e.printStackTrace();
                                } catch (InvocationTargetException e) {
                                    e.printStackTrace();
                                }
                            }
                        }
                    }
                })
                .start();
    }

由于使用了反射，我们需要对加入注解的方法进行混淆配置。

# 不混淆拥有以下注解的方法
-keepclassmembers class * {
    @com.tts.android.aopmonitor.annotation.NeedPermission <methods>;
    @com.tts.android.aopmonitor.annotation.PermissionDenied <methods>;
}

其他

项目地址

关于AOP技术，项目中使用的是Aspectj，下面这篇介绍的就很不错。

AndroidStudio 配置 AspectJ 环境实现AOP