这可能是最精简的Android6.0运行时权限处理,百行代码的工
0x00:前言
对于Android6.0运行时权限的处理方式网上有很多,包括注解,RxJava等等。一直没有正面提到我关心的问题--如果我不在Activity或者Fragment里面,需要运行时权限该怎么去做?导致我开始一直以为运行时权限的处理必需要在Activity或者Fragment之中。
那么:
我有一个录音的自定义控件在很多页面需要使用怎么办?
我有一个联系人列表,要在adapter里面拨打电话怎么办?
我有一个定位的工具类要在多个页面使用怎么办?
等等...
之前我还问过一些同行,他说用回调,回调到Activity或者Fragment,我当时觉得是一种解决方案,但是却很麻烦,如果有多个页面使用,那不是要处理很多次。
直到某一天在github上看到一个分享了简单的工具类MPermissionUtils ,一下子解决了我的疑惑,虽然他也没有明确给出答案,但是我从他的使用上却恍然大悟,原来是一开始我就理解错了。我们只需要把系统回调方法onRequestPermissionsResult
放到BaseActivity里面,当然你所有的用到权限的Activity必需继承自BaseActivity,将处理结果通过工具类调出来,加一个自定义的回调到请求的发起处即可。
因为你要用到运行时权限的地方总要依赖于Activity的存在,如果不再Activity里面或者当前代码获取不到Activity,那就传过去,一切的处理结果都会回到你发起请求所在的Activity。
那么一不做二不休,我们这时候有没有考虑Fragment里面的处理其实是多余的,我们可不可以都放到Activity里面来处理。于是就化繁为简产生了我的XPermissionUtils
0x01:代码实现
public class XPermissionUtils {
private static int mRequestCode = -1;
private static OnPermissionListener mOnPermissionListener;
public interface OnPermissionListener {
void onPermissionGranted();
void onPermissionDenied(String[] deniedPermissions, boolean alwaysDenied);
}
@TargetApi(Build.VERSION_CODES.M)
public static void requestPermissionsAgain(@NonNull Context context, @NonNull String[] permissions,
@NonNull int requestCode) {
if (context instanceof Activity) {
((Activity) context).requestPermissions(permissions, requestCode);
} else {
throw new IllegalArgumentException("Context must be an Activity");
}
}
@TargetApi(Build.VERSION_CODES.M)
public static void requestPermissions(@NonNull Context context, @NonNull int requestCode,
@NonNull String[] permissions, OnPermissionListener listener) {
mRequestCode = requestCode;
mOnPermissionListener = listener;
String[] deniedPermissions = getDeniedPermissions(context, permissions);
if (deniedPermissions.length > 0) {
requestPermissionsAgain(context, permissions, requestCode);
} else {
if (mOnPermissionListener != null) mOnPermissionListener.onPermissionGranted();
}
}
/**
* 请求权限结果,对应Activity中onRequestPermissionsResult()方法。
*/
public static void onRequestPermissionsResult(@NonNull Activity context, int requestCode,
@NonNull String[] permissions, int[] grantResults) {
if (mRequestCode != -1 && requestCode == mRequestCode) {
if (mOnPermissionListener != null) {
String[] deniedPermissions = getDeniedPermissions(context, permissions);
if (deniedPermissions.length > 0) {
boolean alwaysDenied = hasAlwaysDeniedPermission(context, permissions);
mOnPermissionListener.onPermissionDenied(deniedPermissions, alwaysDenied);
} else {
mOnPermissionListener.onPermissionGranted();
}
}
}
}
/**
* 获取请求权限中需要授权的权限
*/
private static String[] getDeniedPermissions(@NonNull Context context, @NonNull String[] permissions) {
List<String> deniedPermissions = new ArrayList();
for (String permission : permissions) {
if (ContextCompat.checkSelfPermission(context, permission) == PackageManager.PERMISSION_DENIED) {
deniedPermissions.add(permission);
}
}
return deniedPermissions.toArray(new String[deniedPermissions.size()]);
}
/**
* 是否彻底拒绝了某项权限
*/
private static boolean hasAlwaysDeniedPermission(@NonNull Context context, @NonNull String... deniedPermissions) {
if (Build.VERSION.SDK_INT < Build.VERSION_CODES.M) return false;
boolean rationale;
for (String permission : deniedPermissions) {
rationale = ActivityCompat.shouldShowRequestPermissionRationale((Activity) context, permission);
if (!rationale) return true;
}
return false;
}
}
0x02:实现思路
在最开始的时候本人的实现没有支持shouldShowRequestPermissionRationale
,是本人的疏忽。因为开始我用的小米手机没有这个功能,后来发现有的手机支持有的不支持。顾名思义这个方法的意思是否需要给用户申请该权限的提示,当用户拒绝权限之后如果没有勾选不再提示,下次申请权限的时候可以加一个自定义的弹窗提示,用户点继续验证可以再次验证权限。
大致实现思路如下:
注意:
1>判断是否需要提示方法
shouldShowRequestPermissionRationale
,只要有一个权限需要提示就返回true2>判断是否彻底禁止权限方法
hasAlwaysDeniedPermission
,只要有一个彻底禁止就返回true3>为了节省代码在发起请求与请求结果中用了同样的方法获取未授权的权限
private static String[] getDeniedPermissions(Context context, String[] permissions) {
List<String> deniedPermissions = new ArrayList<>();
for (String permission : permissions) {
if (ContextCompat.checkSelfPermission(context, permission) == PackageManager.PERMISSION_DENIED) {
deniedPermissions.add(permission);
}
}
return deniedPermissions.toArray(new String[deniedPermissions.size()]);
}
此外在请求结果的时候还可以用另外的方法获取,结果是一样的
private static String[] getDeniedPermissions(String[] permissions, int[] grantResults) {
List<String> deniedPermissions = new ArrayList<>();
for (int i = 0; i < permissions.length; i++) {
if (grantResults[i] != PackageManager.PERMISSION_GRANTED) {
deniedPermissions.add(permissions[i]);
}
}
return deniedPermissions.toArray(new String[deniedPermissions.size()]);
}
0x03:使用方式
以打开相机为例
1、首先AndroidManifest
中配置必要的权限
<uses-permission android:name="android.permission.CAMERA"/>
2、在基类中加上回调方法
@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions,
@NonNull int[] grantResults) {
XPermissionUtils.onRequestPermissionsResult(this, requestCode, permissions, grantResults);
super.onRequestPermissionsResult(requestCode, permissions, grantResults);
}
3、调用工具类方法
XPermissionUtils.requestPermissions(Context context, int requestCode, String[] permissions, OnPermissionListener listener)
这里主要注意这个Context必需是一个Activity
如果在Activity中可以传this
;
如果在Fragment中传getActivity()
;
如果在View中传getContext()
;
等等.....
private void doOpenCamera() {
XPermissionUtils.requestPermissions(this, RequestCode.CAMERA, new String[] { Manifest.permission.CAMERA },
new XPermissionUtils.OnPermissionListener() {
@Override
public void onPermissionGranted() {
if (PermissionHelper.isCameraEnable()) {
Toast.makeText(MainActivity.this, "打开相机操作", Toast.LENGTH_LONG).show();
} else {
DialogUtil.showPermissionManagerDialog(MainActivity.this, "相机");
}
}
@Override
public void onPermissionDenied(final String[] deniedPermissions, boolean alwaysDenied) {
Toast.makeText(context, "获取相机权限失败", Toast.LENGTH_SHORT).show();
if (alwaysDenied) { // 拒绝后不再询问 -> 提示跳转到设置
DialogUtil.showPermissionManagerDialog(MainActivity.this, "相机");
} else { // 拒绝 -> 提示此公告的意义,并可再次尝试获取权限
new AlertDialog.Builder(context).setTitle("温馨提示")
.setMessage("我们需要相机权限才能正常使用该功能")
.setNegativeButton("取消", null)
.setPositiveButton("验证权限", new DialogInterface.OnClickListener() {
@RequiresApi(api = Build.VERSION_CODES.M)
@Override
public void onClick(DialogInterface dialog, int which) {
XPermissionUtils.requestPermissionsAgain(context, deniedPermissions,
RequestCode.CAMERA);
}
})
.show();
}
}
});
}
4、一次申请多个权限
用户可能部分拒绝,因此在onPermissionDenied(String[] deniedPermissions)
回调中返回了请求结果中所有被拒绝的权限,用户可用于比对判断出哪些权限被拒绝,给用户明确的提示
private void doMorePermission() {
XPermissionUtils.requestPermissions(this, RequestCode.MORE,
new String[] { Manifest.permission.WRITE_CONTACTS, Manifest.permission.READ_SMS },
new XPermissionUtils.OnPermissionListener() {
@Override
public void onPermissionGranted() {
Toast.makeText(context, "获取联系人,短信权限成功", Toast.LENGTH_SHORT).show();
}
@Override
public void onPermissionDenied(String[] deniedPermissions, boolean alwaysDenied) {
StringBuilder sBuilder = new StringBuilder();
for (String deniedPermission : deniedPermissions) {
if (deniedPermission.equals(Manifest.permission.WRITE_CONTACTS)) {
sBuilder.append("联系人");
sBuilder.append(",");
}
if (deniedPermission.equals(Manifest.permission.READ_SMS)) {
sBuilder.append("短信");
sBuilder.append(",");
}
}
if (sBuilder.length() > 0) {
sBuilder.deleteCharAt(sBuilder.length() - 1);
}
Toast.makeText(context, "获取" + sBuilder.toString() + "权限失败", Toast.LENGTH_SHORT).show();
if (alwaysDenied) {
DialogUtil.showPermissionManagerDialog(MainActivity.this, sBuilder.toString());
}
}
});
}
0x04:各种运行时权限处理详谈
其实在6.0之前已经存在运行时权限,只不过没有明确提出这个概念,在6.0之前,获取位置、读取通讯录、拍照、录音等都是需要在操作的时候去获取权限的。那么这些权限的区别是6.0以后需要我们去写请求获取权限的代码,而之前是当代码执行到需要权限的地方就会弹出提示框。
那么针对不同的权限可能有不同的处理方式,下面简单列举,如果需要看代码可以在源码的Demo中查看
1、拨打电话
拨打电话在某些手机上(如小米)拒绝之后是每次申请都有提示的,因为他显示的是“拒绝一次”。拨打电话其实如果不是产品要求直接拨出去可以使用调转到拨号页面实现的,这个不需要权限:
Intent intent = new Intent(Intent.ACTION_DIAL);
Uri data = Uri.parse("tel:10010");
intent.setData(data);
startActivity(intent);
2、录音
(1)录音权限在6.0之前是无法判断是否获取权限的,只能通过非常规的方法获取,详见项目Demo
(2)长按按钮录音,在第一次获取权限的时候需要特殊处理,弹出获取权限的提示框之后手指已经离开,不能进行录音的操作。
3、打开相机
相机权限在6.0之前同样也是无法判断是否获取权限的,只能通过非常规的方法获取,详见项目Demo
4、获取位置
(1)首先手机需要开启位置服务,如果没有开启,那么即使app开启获取位置权限也是获取不到的
(2)在6.0以下没有办法判断是否开启位置权限,可以根据具体使用场景进行判断。
(3)(使用系统Api)要注意在室内如果选择Gps定位会获取不到位置,这里可以参考Demo中LocationUtils
的实现思路。
(4)使用百度或者高德地图可能不适用,因为他自己已经带有请求权限的处理,貌似不需要系统权限也能定位,没有深入研究。
5、获取外部存储
这个在有些手机上比较特殊,比如打开图库这样的功能,在小米手机上就不需要运行时权限,华为就需要,这个还是需要在使用的时候主动请求一下。
0x05 特别鸣谢
MPermissionUtils
PermissionGen
AndPermission
如有不足,欢迎指正。最后附上源码地址
XPermissionUtils