在Android上优雅的申请权限

最新推荐文章于 2024-09-12 17:41:43 发布

2401_84912049

最新推荐文章于 2024-09-12 17:41:43 发布

阅读量372

点赞数 3

分类专栏：程序员文章标签： android

本文链接：https://blog.csdn.net/2401_84912049/article/details/138976969

版权

程序员专栏收录该内容

57 篇文章 0 订阅

订阅专栏

Snackbar.LENGTH_INDEFINITE)
.setAction(“确定”) {
requestPermissions(arrayOf(Manifest.permission.CALL_PHONE), REQUEST_PERMISSION_CODE_CALL_PHONE)
}.setDuration(3000)
.show()
}

/**

用户点击拨打电话按钮，先进行申请权限
*/
private fun requestPermmission(context: Context) {

// 判断是否需要运行时申请权限
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M && ContextCompat.checkSelfPermission(context, Manifest.permission.CALL_PHONE) != PackageManager.PERMISSION_GRANTED) {
// 判断是否需要对用户进行提醒，用户点击过拒绝&&没有勾选不再提醒时进行提示
if (ActivityCompat.shouldShowRequestPermissionRationale(this, Manifest.permission.CALL_PHONE)) {
// 给用于予以权限解释, 对于已经拒绝过的情况，先提示申请理由，再进行申请
showPermissionRationale(“需要打开电话权限直接进行拨打电话，方便您的操作”)
} else {
// 无需说明理由的情况下，直接进行申请。如第一次使用该功能（第一次申请权限），用户拒绝权限并勾选了不再提醒
// 将引导跳转设置操作放在请求结果回调中处理
requestPermissions(arrayOf(Manifest.permission.CALL_PHONE), REQUEST_PERMISSION_CODE_CALL_PHONE)
}
} else {
// 拥有权限直接进行功能调用
callPhone()
}
}

/**

权限申请回调
*/
@TargetApi(Build.VERSION_CODES.M)
override fun onRequestPermissionsResult(requestCode: Int, permissions: Array, grantResults: IntArray) {
// 根据requestCode判断是那个权限请求的回调
if (requestCode == REQUEST_PERMISSION_CODE_CALL_PHONE) {
// 判断用户是否同意了请求
if (grantResults.size == 1 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
callPhone()
} else {
// 未同意的情况
if (ActivityCompat.shouldShowRequestPermissionRationale(this, Manifest.permission.CALL_PHONE)) {
// 给用于予以权限解释, 对于已经拒绝过的情况，先提示申请理由，再进行申请
showPermissionRationale(“需要打开电话权限直接进行拨打电话，方便您的操作”)
} else {
// 用户勾选了不再提醒，引导用户进入设置界面进行开启权限
Snackbar.make(view, “需要打开权限才能使用该功能，您也可以前往设置->应用。。。开启权限”,
Snackbar.LENGTH_INDEFINITE)
.setAction(“确定”) {
val intent = Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS)
intent.data = Uri.parse(“package:$packageName”)
startActivityForResult(intent,REQUEST_SETTINGS_CODE)
}
.show()
}
}
} else {
super.onRequestPermissionsResult(requestCode, permissions, grantResults)
}
}

public override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
super.onActivityResult(requestCode, resultCode, data)
if (requestCode == REQUEST_SETTINGS_CODE) {
Toast.makeText(this, “再次判断是否同意了权限，再进行自定义处理”,
Toast.LENGTH_LONG).show()
}
}

}

EasyPermissions使用及存在问题

上面介绍了单一权限的申请，简单的一个申请代码量其实已经不小了，对于某一个功能需要多个权限更是需要复杂的逻辑判断。google给我们推出了一个权限申请的开源框架，下面围绕着EasyPermission进行说明。
使用方法不介绍了，看一下demo就可以了，网上也有很多的文章这里引用前人的总结。

blog.csdn.net/hexingen/ar…

我在使用的时候发现了有这样一个问题，使用版本是pub.devrel:easypermissions:2.0.0,在demo中使用多个权限申请的时候同意一个，拒绝一个，没有勾选不在提醒。这个时候，第二次申请权限，在提示用户使用权限时候点击取消，会弹出跳转到设置手动开启的弹框。这个做法是不合适的，用户并没有点击不在提醒，可以在app内部引导用户授权，肯定是哪里的逻辑有问题。先贴图

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

从最后的设置界面也可以看出，app并没有拒绝某些权限，还处于询问状态。
为了了解为什么出现这样的异常情况，那就跟我一起read the XXXX source code吧。
先说结论，在提示用户点击取消的时候会进入下面方法

@Override
public void onPermissionsDenied(int requestCode, @NonNull List perms) {
Log.d(TAG, “onPermissionsDenied:” + requestCode + “:” + perms.size());

// (Optional) Check whether the user denied any permissions and checked “NEVER ASK AGAIN.”
// This will display a dialog directing them to enable the permission in app settings.
if (EasyPermissions.somePermissionPermanentlyDenied(this, perms)) {
new AppSettingsDialog.Builder(this).build().show();
}
}

在判断EasyPermissions.somePermissionPermanentlyDenied()的时候判断出了问题，弹出了dialog（这里的对话框使用Activity实现的）

EasyPermissions源码分析

这里我会跟着demo使用的思路，对源码进行阅读。建议下载源码，上面有链接
在点击两个权限的按钮之后调用如下方法

@AfterPermissionGranted(RC_LOCATION_CONTACTS_PERM)
public void locationAndContactsTask() {
if (hasLocationAndContactsPermissions()) {
// 如果有权限，toast
Toast.makeText(this, “TODO: Location and Contacts things”, Toast.LENGTH_LONG).show();
} else {
// 没有权限，进行申请权限，交由EasyPermission类管理
EasyPermissions.requestPermissions(
this,
getString(R.string.rationale_location_contacts),
RC_LOCATION_CONTACTS_PERM,
LOCATION_AND_CONTACTS);
}
}

按照使用的思路梳理，先不管注解部分。跟进EasyPermissions.requestPermissions

/**

请求多个权限，如果系统需要就弹出权限说明
@param host context
@param rationale 想用户说明为什么需要这些权限
@param requestCode 请求码用于onRequestPermissionsResult回调中确定是哪一次申请
@param perms 具体需要的权限
*/
public static void requestPermissions(
@NonNull Activity host, @NonNull String rationale,
int requestCode, @Size(min = 1) @NonNull String… perms) {
requestPermissions(
new PermissionRequest.Builder(host, requestCode, perms)
.setRationale(rationale)
.build());
}

很明显，调用了内部的requestPermissions()方法，继续跟

public static void requestPermissions(
@NonNull Fragment host, @NonNull String rationale,
int requestCode, @Size(min = 1) @NonNull String… perms) {
requestPermissions(
new PermissionRequest.Builder(host, requestCode, perms)
.setRationale(rationale)
.build());
}

构建者Builder模式创建了一个PermissionRequest.Builder对象，传入真正的requestPermissions()方法，跟吧

public static void requestPermissions(PermissionRequest request) {

// 在请求权限之前检查是否已经包含了这些权限
if (hasPermissions(request.getHelper().getContext(), request.getPerms())) {
// 已经存在了权限，给权限状态数组赋值PERMISSION_GRANTED，并进入请求完成部分。不进行这条处理分支的分析，自己看一下吧
notifyAlreadyHasPermissions(
request.getHelper().getHost(), request.getRequestCode(), request.getPerms());
return;
}

// 通过helper类来辅助调用系统api申请权限
request.getHelper().requestPermissions(
request.getRationale(),
request.getPositiveButtonText(),
request.getNegativeButtonText(),
request.getTheme(),
request.getRequestCode(),
request.getPerms());
}

跟requestPermissions()方法

public void requestPermissions(@NonNull String rationale,
@NonNull String positiveButton,
@NonNull String negativeButton,
@StyleRes int theme,
int requestCode,
@NonNull String… perms) {
// 这里遍历调用系统api ，shouldShowRequestPermissionRationale，是否需要提示用户申请说明
if (shouldShowRationale(perms)) {
showRequestPermissionRationale(
rationale, positiveButton, negativeButton, theme, requestCode, perms);
} else {
// 抽象方法，其实就是在不同的子类里调用系统api
// ActivityCompat.requestPermissions(getHost(), perms, requestCode);方法
directRequestPermissions(requestCode, perms);
}
}

到这里，第一次的请求流程已经结束，与用户交互，按我们上面gif的演示，对一个权限允许，一个权限拒绝。
这时候回到Activity中的回调onRequestPermissionsResult方法中

@Override
public void onRequestPermissionsResult(int requestCode,
@NonNull String[] permissions,
@NonNull int[] grantResults) {
super.onRequestPermissionsResult(requestCode, permissions, grantResults);

// 交给EasyPermissions类进行处理事件
EasyPermissions.onRequestPermissionsResult(requestCode, permissions, grantResults, this);
}

跟进去！

public static void onRequestPermissionsResult(int requestCode,
@NonNull String[] permissions,
@NonNull int[] grantResults,
@NonNull Object… receivers) {
// 创建两个list用于收集请求权限的结果
List granted = new ArrayList<>();
List denied = new ArrayList<>();
for (int i = 0; i < permissions.length; i++) {
String perm = permissions[i];
if (grantResults[i] == PackageManager.PERMISSION_GRANTED) {
granted.add(perm);
} else {
denied.add(perm);
}
}

// 遍历
for (Object object : receivers) {
// 如果有某个权限被同意了，回调到Activity中的onPermissionsGranted方法
if (!granted.isEmpty()) {
if (object instanceof PermissionCallbacks) {
((PermissionCallbacks) object).onPermissionsGranted(requestCode, granted);
}
}

// 如果有某个权限被拒绝了，回调到Activity中的onPermissionsDenied方法

if (!denied.isEmpty()) {
if (object instanceof PermissionCallbacks) {
((PermissionCallbacks) object).onPermissionsDenied(requestCode, denied);
}
}

// 如果请求的权限都被同意了，进入我们被@AfterPermissionGranted注解的方法，这里对注解的使用不进行详细分析了。
if (!granted.isEmpty() && denied.isEmpty()) {
runAnnotatedMethods(object, requestCode);
}
}
}

我们对权限一个允许一个拒绝，所以会回调onPermissionsGranted和onPermissionsDenied。在demo中的onPermissionsDenied方法进行了处理

@Override
public void onPermissionsDenied(int requestCode, @NonNull List perms) {
Log.d(TAG, “onPermissionsDenied:” + requestCode + “:” + perms.size());

做了一个判断，`EasyPermissions.somePermissionPermanentlyDenied，这里回调传入的是一个list，我们来继续分析。跟进去,一直跟！

public static boolean somePermissionPermanentlyDenied(@NonNull Activity host,
@NonNull List deniedPermissions) {
return PermissionHelper.newInstance(host)
.somePermissionPermanentlyDenied(deniedPermissions);
}

又进入了helper辅助类

public boolean somePermissionPermanentlyDenied(@NonNull List perms) {
for (String deniedPermission : perms) {
if (permissionPermanentlyDenied(deniedPermission)) {
return true;
}
}

return false;
}

循环遍历了每一权限。有一个是true就返回true。继续跟！

public boolean permissionPermanentlyDenied(@NonNull String perms) {
// 返回了shouldShowRequestPermissionRationale的非值，就是系统API shouldShowRequestPermissionRationale的非值
return !shouldShowRequestPermissionRationale(perms);
}

这里并没有过滤掉用户已经同意的权限，正常的交互不会进入new AppSettingsDialog.Builder(this).build().show();，但是在Rationale弹框点击取消的时候会出问题，我们看一下关于权限说明的rationale弹框的具体实现。

从demo申请权限requestPermissions方法中，调用的showRequestPermissionRationale方法。在ActivityPermissionHelper类中找到具体的实现

@Override
public void showRequestPermissionRationale(@NonNull String rationale,
@NonNull String positiveButton,
@NonNull String negativeButton,
@StyleRes int theme,
int requestCode,
@NonNull String… perms) {
FragmentManager fm = getHost().getFragmentManager();

// Check if fragment is already showing
Fragment fragment = fm.findFragmentByTag(RationaleDialogFragment.TAG);
if (fragment instanceof RationaleDialogFragment) {
Log.d(TAG, “Found existing fragment, not showing rationale.”);
return;
}
// 创建了一个DialogFragment并显示出来
RationaleDialogFragment
.newInstance(positiveButton, negativeButton, rationale, theme, requestCode, perms)
.showAllowingStateLoss(fm, RationaleDialogFragment.TAG);
}

查看RationaleDialogFragment类，里面代码不多，找到取消按钮的实现。

@NonNull
@Override
public Dialog onCreateDialog(Bundle savedInstanceState) {
// Rationale dialog should not be cancelable
setCancelable(false);

// 创建listener
RationaleDialogConfig config = new RationaleDialogConfig(getArguments());
RationaleDialogClickListener clickListener =
new RationaleDialogClickListener(this, config, mPermissionCallbacks, mRationaleCallbacks);

// 将listener传入dialog中
return config.createFrameworkDialog(getActivity(), clickListener);
}

查看RationaleDialogClickListener代码

@Override
public void onClick(DialogInterface dialog, int which) {
int requestCode = mConfig.requestCode;
if (which == Dialog.BUTTON_POSITIVE) { // 点击确定
String[] permissions = mConfig.permissions;
if (mRationaleCallbacks != null) {
mRationaleCallbacks.onRationaleAccepted(requestCode);
}
if (mHost instanceof Fragment) {
PermissionHelper.newInstance((Fragment) mHost).directRequestPermissions(requestCode, permissions);
} else if (mHost instanceof Activity) {
PermissionHelper.newInstance((Activity) mHost).directRequestPermissions(requestCode, permissions);
} else {
throw new RuntimeException(“Host must be an Activity or Fragment!”);
}
} else { // 点击取消
if (mRationaleCallbacks != null) {
mRationaleCallbacks.onRationaleDenied(requestCode);
}
// 调用下面方法
notifyPermissionDenied();
}
}