在上一篇中简单介绍了运行时权限,今天就讲讲怎么去申请权限。这个项目中本来用了一个第三方的权限框架,但是不太好用,我就在github上选择了start最多的PermissionsDispatcher 。这个框架非常好用,下面来了解下它的用法。
配置
首先呢就是在项目的build.gradle文件里添加
dependencies {
compile("com.github.hotchemi:permissionsdispatcher:${latest.version}") {
// if you don't use android.app.Fragment you can exclude support for them
exclude module: "support-v13"
}
annotationProcessor "com.github.hotchemi:permissionsdispatcher-processor:${latest.version}"
}
repositories {
jcenter()
maven { url 'http://oss.jfrog.org/artifactory/oss-snapshot-local/' }
}
其中${latest.version}要换成版本号,当前最新的版本号为3.0.1 。Rebuild一下工程就好了。
介绍
注解 | 是否必须 | 描述 |
---|---|---|
@RuntimePermissions | ✔ | 注册一个 Activity 或 Fragment 用于处理权限 |
@NeedsPermission | ✔ | 注解一个方法,说明需要什么权限(一个或多个) |
@OnShowRationale | 注解一个方法,解释为什么需要这些权限 | |
@OnPermissionDenied | 注解一个方法,当用户拒绝授权时将调用该方法 | |
@OnNeverAskAgain | 注解一个方法,当用户选择了 "不再提醒" 将调用该方法 |
示例
@RuntimePermissions
public class UserInfoTokenActivity extends BaseActivity{
...
@NeedsPermission(Manifest.permission.CAMERA)
void openCamera() {
UtilTools.getImageFromCamera(this);
}
@OnShowRationale(Manifest.permission.CAMERA)
void showRationale(final PermissionRequest request) {
request.proceed();
}
@OnPermissionDenied(Manifest.permission.CAMERA)
void showDeniedForStorage() {
AppUtils.showRequestPermissionDialog(this, String.format(
getString(R.string.camera_permission_message), getString(R.string.app_name)));
}
@OnNeverAskAgain(Manifest.permission.CAMERA)
void showNeverAskForStorage() {
AppUtils.showRequestPermissionDialog(this, String.format(
getString(R.string.camera_permission_message), getString(R.string.app_name)));
}
@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
super.onRequestPermissionsResult(requestCode, permissions, grantResults);
UserInfoTokenActivityPermissionsDispatcher.onRequestPermissionsResult(this, requestCode, grantResults);
}
...
}
注意:
- 类前加RuntimePermissions注解;
- 加注解的方法千万不要写成private
- OnShowRationale注解的方法有参数,开始我没注意,怎么也不能生成UserInfoTokenActivityPermissionsDispatcher这个类;
- 不要直接调用注解的方法,要通过如下方式调用:
UserInfoTokenActivityPermissionsDispatcher.
openCameraWithPermissionCheck(UserInfoTokenActivity.this);
效果
调用需要权限的方法(用NeedsPermission注解的)时,如果已经授予该权限,直接执行这个方法,如果没有该权限,会弹出授权提示框:
点击按钮会执行OnShowRationale注解的方法,我这个里边就让方法继续执行了,即显示拍照。如果点击“拒绝”就会执行OnPermissionDenied注解的方法,我这个方法里是仿照微信写的,弹出提示框,如下:
其中,AppUtils代码如下:
import android.app.AlertDialog;
import android.content.Context;
import android.content.DialogInterface;
import android.content.Intent;
import android.provider.Settings;
import android.support.v4.content.ContextCompat;
/**
* 作者:WangJintao
* 时间:2017/10/13
* 邮箱:wangjintao1988@163.com
*/
public class AppUtils {
public static void showRequestPermissionDialog(final Context context, String message) {
AlertDialog dialog = new AlertDialog.Builder(context).setPositiveButton(context.getString(R.string.go_setting), new DialogInterface.OnClickListener() {
@Override
public void onClick(DialogInterface dialog, int which) {
//打开应用列表
AppUtils.openAppSettingList(context);
dialog.dismiss();
}
})
.setNegativeButton(context.getString(R.string.cancel), new DialogInterface.OnClickListener() {
@Override
public void onClick(DialogInterface dialog, int which) {
dialog.dismiss();
}
})
.setCancelable(false)
.setMessage(message)
.setTitle(R.string.permission_title)
.show();
//设置按钮颜色
dialog.getButton(AlertDialog.BUTTON_NEGATIVE).setTextColor(ContextCompat.getColor(context, R.color.black));
dialog.getButton(AlertDialog.BUTTON_POSITIVE).setTextColor(ContextCompat.getColor(context, R.color.main_color));
}
public static void openAppSettingList(Context context) {
Intent intent = new Intent(Settings.ACTION_APPLICATION_SETTINGS);
intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
context.startActivity(intent);
}
}
点击“不再询问”执行OnNeverAskAgain注解的方法,参考微信执行的也是弹出提示框。
关于应用安装时权限申请的说明
在我这个APP里,定位和电话权限是必须的,所以安装后就必须申请,PermissionsDispatcher可以同时申请多个权限,但是我没这样用,我还是用的一个个申请,先去申请电话权限,如果用户点击“拒绝”弹出提示框,用户再点击提示框中的取消,就关闭这个APP,点击去设置再跳转到设置界面,如果开始用户就点击了“允许”,然后再去申请定位权限,运行效果与微信一致。