Android运行时请求权限封装

@

目录

• 1 介绍
• 2 测试用例设计
• 3 实现
• 4 用例测试
• 5 总结

本文目的：“借助透明Activity封装一个易于调用的权限请求模块”

1 介绍

Android权限的校验和申请比较简单，但在实际项目中使用时还要进行系统版本的适配，最不友好的是权限的申请结果需要在 onRequestPermissionsResult 中进行判断，如果项目中有多个地方需要申请权限，或者申请权限的代码在自定义的组件中，而申请结果判断则在activity或fragment中，那代码就会显得很乱，对于后期维护也是很不方便，因此我们就来封装一个简单的权限申请模块。

2 测试用例设计

首页我们还是先设计一个权限申请的测试用例步骤：
1、首先判断所需要的权限是否已经过用户授权；
2、如果没有经过用户授权，则申请权限；
3、如果用户授权，则调用相关功能；
4、如果用户拒绝授权，则提示信息。
解析流程：
输入：需要的权限
输出：授权/拒绝

测试用例的代码实现：

String[] permisstions = new String[];  //申请所需要权限
PermissionHelper.request(context,permisstions,new Listener(){void granted(){//授权后执行}void denied(){//拒绝后执行}
});

测试用例实现了输入、输出，其他步骤就需要在模块中实现，对调用方透明。

3 实现

首先我们先实现PermissionHelper类，功能是判断权限是否被授权，如果没有被授权则申请权限。

/*** 权限帮助类* Created by lidong on 2019/10/25.*/
public class PermissionHelper {/*** 请求权限** @param context     context* @param permissions 权限* @param listener    监听*/public static void request(Context context, String[] permissions, PermissionListener listener) {//判断权限，如果所有权限全被授权，直接返回if (checkPermission(context, permissions)) {if (listener != null) {listener.granted();}return;}//申请权限if (Build.VERSION.SDK_INT < Build.VERSION_CODES.M) {  //6.0以下没有申请权限，直接返回拒绝if (listener != null) {listener.denied();}} else {  //6.0及以上申请权限//为了统一回调需要借用一个activityPermissionActivity.open(context, permissions, listener);}}/*** 校验权限** @param context     context* @param permissions 权限* @return 所有权限已被授权返回true，否则返回false*/protected static boolean checkPermission(Context context, String[] permissions) {for (String per : permissions) {int result = PermissionChecker.checkSelfPermission(context, per);if (result != PermissionChecker.PERMISSION_GRANTED) {return false;}}return true;}/*** 权限监听*/public interface PermissionListener {/*** 所有权限已被授权*/void granted();/*** 一个或多个权限被拒绝*/void denied();}
}

这里为了方便接收申请权限的结果，我们打开一个新的activity，在新activity中进行权限申请，需要将申请的权限和回调监听传入activity中：

public static void open(Context context, String[] permissions, PermissionHelper.PermissionListener listener) {Intent intent = new Intent(context, PermissionActivity.class);intent.putExtra("data", permissions);context.startActivity(intent);mPermissionListener = listener;}

PermissionActivity类：

/*** 权限申请* Created by lidong on 2019/10/25.*/
public class PermissionActivity extends Activity {private static PermissionHelper.PermissionListener mPermissionListener;private String[] permissions;private AlertDialog mAlertDialog;private boolean first = true;@Overrideprotected void onCreate(@Nullable Bundle savedInstanceState) {super.onCreate(savedInstanceState);permissions = getIntent().getStringArrayExtra("data");}private void requestPermissions(){ActivityCompat.requestPermissions(this, permissions, 1);}@Overrideprotected void onResume() {super.onResume();if (first) {first = false;requestPermissions();return;}//切换页面回来重新校验一下showMissingPermissionDefiniteDialog();}/*** 拒绝授权 显示提示对话框*/private void showMissingPermissionDefiniteDialog() {if (mAlertDialog != null && mAlertDialog.isShowing()) {mAlertDialog.dismiss();}List<String> deniedList = new ArrayList<>();for (String permission : permissions) {if (PermissionChecker.checkSelfPermission(this, permission)== PermissionChecker.PERMISSION_GRANTED) {continue;}deniedList.add(permission);}if (deniedList.size() == 0) {granted();return;}List<String> tipList = transformTip(deniedList);StringBuilder tip = new StringBuilder();int i = 0;for (String temp : tipList) {if (i > 0) {tip.append(",");}tip.append(temp);i++;}AlertDialog.Builder builder = new AlertDialog.Builder(PermissionActivity.this);builder.setMessage("应用程序需要以下权限：\n\r" + tip);builder.setNegativeButton("取消", new DialogInterface.OnClickListener() {@Overridepublic void onClick(DialogInterface dialog, int which) {denied();}});builder.setPositiveButton("设置", new DialogInterface.OnClickListener() {@Overridepublic void onClick(DialogInterface dialog, int which) {gotoSetting();}});builder.setCancelable(false);mAlertDialog = builder.show();}private List<String> transformTip(List<String> list) {Map<String, String> permissionList = new HashMap<>();permissionList.put(Manifest.permission.WRITE_EXTERNAL_STORAGE, "「存储空间」");permissionList.put(Manifest.permission.READ_PHONE_STATE, "「电话」");permissionList.put(Manifest.permission.CAMERA, "「相机」");permissionList.put(Manifest.permission.RECORD_AUDIO, "「录音」");permissionList.put(Manifest.permission.ACCESS_FINE_LOCATION, "「位置」");permissionList.put(Manifest.permission.ACCESS_COARSE_LOCATION, "「位置」");List<String> tipList = new ArrayList<>();for (String temp : list) {String tip = permissionList.get(temp);if (!tipList.contains(tip)) {tipList.add(tip);}}return tipList;}@Overridepublic void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {super.onRequestPermissionsResult(requestCode, permissions, grantResults);//判断所有权限是否被授权if (isGranted(grantResults) && PermissionHelper.checkPermission(this, permissions)) {granted();} else {showMissingPermissionDefiniteDialog();}}/*** 授权回调*/private void granted(){if (mPermissionListener != null) {mPermissionListener.granted();}finish();}/*** 拒绝回调*/private void denied(){if (mPermissionListener != null) {mPermissionListener.denied();}finish();}private boolean isGranted(int[] grantResult) {for (int result : grantResult) {if (result != PackageManager.PERMISSION_GRANTED) {return false;}}return true;}/*** 跳转到当前应用对应的设置页面*/private void gotoSetting() {Intent intent = new Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS);intent.setData(Uri.parse("package:" + getPackageName()));startActivity(intent);}@Overridepublic void finish() {super.finish();overridePendingTransition(0, 0);mPermissionListener = null;}public static void open(Context context, String[] permissions, PermissionHelper.PermissionListener listener) {Intent intent = new Intent(context, PermissionActivity.class);intent.putExtra("data", permissions);context.startActivity(intent);mPermissionListener = listener;}
}

在 activity 的 onRequestPermissionsResult 方法中，校验授权结果，如果一个或多个权限未被授权，则显示提示对话框，对话框有“设置”按钮跳转到应用程序详情页面，可以进入权限设置页面修改权限。

为了兼容在程序以外的地方手动修改权限，再切换回当前页面的情况，我们在 onResume 方法里增了页面切换回来后重新判断权限是否被授权。

到这里已经封装完成了。

4 用例测试

现在我们完善一下测试用例：

String[] permissions=new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE,Manifest.permission.CAMERA,Manifest.permission.READ_PHONE_STATE,};PermissionHelper.request(context, permissions, new PermissionHelper.PermissionListener() {@Overridepublic void granted() {showToast("已授权");}@Overridepublic void denied() {showToast("已拒绝");}});

运行测试用例，发现申请权限的activity是白色背景，我们可以在 AndroidManifest.xml 文件中将 activity 设置成全屏透明窗体，用户体验也会好点。

好了，以后无论在哪里需要申请权限，我们只需要这几行代码就够了！

5 总结

申请权限的封装，主要是利用一个透明的activity来完成需要在 activity 中接收结果的情况。其实微信的支付sdk也有用到透明的activity。使用透明activity可以用来将调用和回调代码组装一起，增加代码的可读性和维护性。

END

---

本文的技术设计和实现都是基于作者工作中的经验总结，如有错误，请留言指正，谢谢。