添加依赖
使用EasyPermission
框架,需要引入依赖。根据APP的框架选用不同的包,鉴于目前AndroidX为未来的主流,还是建议直接一步到位为好。
dependencies {
// For developers using AndroidX in their applications
implementation 'pub.devrel:easypermissions:3.0.0'
// For developers using the Android Support Library
implementation 'pub.devrel:easypermissions:2.0.1'
}
权限申请
首先权限申请一定要在使用权限的宿主页上覆写onRequestPermissionsResult
方法,将权限请求结果传递给EasyPermission
。
@Override
public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {
super.onRequestPermissionsResult(requestCode, permissions, grantResults);
// 将结果传递给EasyPermission
EasyPermissions.onRequestPermissionsResult(requestCode, permissions, grantResults, this);
}
如果该业务比较简单,也不关心拒绝后的挽回,则可以直接使用注解AfterPermissionGranted
,然后在需要使用的地方调用即可。
@AfterPermissionGranted(PERMISSION_REQUEST_CAMERA)
public void doSomethingWithCamera() {
if (EasyPermissions.hasPermissions(this, Manifest.permission.CAMERA)) {
Toast.makeText(this, "应用获得相机权限", Toast.LENGTH_LONG).show();
} else {
// Ask for one permission
EasyPermissions.requestPermissions(
this,
"给个相机权限吧~",
PERMISSION_REQUEST_CAMERA,
Manifest.permission.CAMERA);
}
}
注解后的入参是权限请求码,跟Handler
的what
一样,只要唯一即可。
如果,在用户拒绝后想要再次解释一下APP使用权限的目的是啥,进而挽回用户,或者在用户永久拒绝后引导客户去系统设置页打开权限,则可以考虑实现EasyPermissions.PermissionCallbacks
,EasyPermissions.RationaleCallbacks
这两个接口。前者是用户对权限是否收入的回调,后者是用户对二次解释后是否授予权限的回调,由于各个厂商对Rationale
的实现机制略有不同,考虑通用性,不建议实现该接口。
@Override
public void onPermissionsGranted(int requestCode, @NonNull List<String> perms) {
Log.d(TAG, "onPermissionsGranted:" + requestCode + ":" + perms.size());
}
@Override
public void onPermissionsDenied(int requestCode, @NonNull List<String> perms) {
Log.d(TAG, "onPermissionsDenied:" + requestCode + ":" + perms.size());
if (EasyPermissions.somePermissionPermanentlyDenied(this, perms)) {
new AppSettingsDialog.Builder(this).build().show();
}
}
@Override
public void onRationaleAccepted(int requestCode) {
Log.d(TAG, "onRationaleAccepted:" + requestCode);
}
@Override
public void onRationaleDenied(int requestCode) {
Log.d(TAG, "onRationaleDenied:" + requestCode);
}
如上,当用户拒绝权限后,我们可以使用EasyPermission
提供的去系统设置弹窗引导用户去开启权限。
系统设置回调
当我们离开了APP去到系统设置页面进行权限设置,而返回APP后不便到onResume
中再次触发一遍权限获取,就比较麻烦了。为了解决这个交互难题,EasyPermission
在AppSettingsDialog
中使用startActivityForResult
方式打开系统设置。这也就是说,只要在宿主页重写onActivityResult
就可以实现,系统设置页面返回后重判权限的效果。
@Override
public void onActivityResult(int requestCode, int resultCode, Intent data) {
super.onActivityResult(requestCode, resultCode, data);
if (requestCode == AppSettingsDialog.DEFAULT_SETTINGS_REQ_CODE) {
Toast.makeText(this, "用户通过系统设置完成了权限设置,相机权限为" + EasyPermissions.hasPermissions(this,
Manifest.permission.CAMERA), Toast.LENGTH_LONG).show();
}
}