Android PermissionUtils:运行时权限工具类及申请权限的正确姿势
PermissionUtil
经常写Android运行时权限申请代码,每次都是复制过来之后,改一下权限字符串就用,把代码搞得乱糟糟的,于是便有了封装工具类的想法,话不多说,先看怎么用:
工具类及Demo:github
简洁版申请权限
申请一个权限:
java">java"> PermissionUtils.checkAndRequestPermission(mContext, PERMISSION_CAMERA, REQUEST_CODE_CAMERA,
new PermissionUtils.PermissionRequestSuccessCallBack() {
@Override
public void onHasPermission() { // 权限已被授予 toCamera(); } });
然后在onRequestPermissionsResult中:
if(PermissionUtils.isPermissionRequestSuccess(grantResults))
{
// 权限申请成功
toCamera();
}
什么?要同时申请多个权限?
java">java"> PermissionUtils.checkAndRequestMorePermissions(mContext, PERMISSIONS, REQUEST_CODE_PERMISSIONS,
new PermissionUtils.PermissionRequestSuccessCallBack() {
@Override
public void onHasPermission() { // 权限已被授予 toCamera(); } });
当然上面这些都不是申请权限的正确姿势,理想的姿势应该是:
- 第一次申请权限:按照正常流程走;
- 如果用户第一次拒绝了权限申请,第二次申请时应向用户解释权限用途;
- 如果用户勾选了“不再询问”选项,应引导用户去设置页手动开启权限。
如图:
于是,引申出了复杂版的权限申请方法:
自定义权限申请:
java">java">PermissionUtils.checkPermission(mContext, PERMISSION_CAMERA,
new PermissionUtils.PermissionCheckCallBack() {
@Override
public void onHasPermission() { // 已授予权限 toCamera(); } @Override public void onUserHasAlreadyTurnedDown(String... permission) { // 上一次申请权限被拒绝,可用于向用户说明权限原因,然后调用权限申请方法。 } @Override public void onUserHasAlreadyTurnedDownAndDontAsk(String... permission) { // 第一次申请权限或被禁止申请权限,建议直接调用申请权限方法。 } });
然后在onRequestPermissionsResult中:
java">java">PermissionUtils.onRequestPermissionResult(mContext, PERMISSION_CAMERA, grantResults, new PermissionUtils.PermissionCheckCallBack() {
@Override
public void onHasPermission() { toCamera(); } @Override public void onUserHasAlreadyTurnedDown(String... permission) { Toast.makeText(mContext, "我们需要"+Arrays.toString(permission)+"权限", Toast.LENGTH_SHORT).show(); } @Override public void onUserHasAlreadyTurnedDownAndDontAsk(String... permission) { Toast.makeText(mContext, "我们需要"+Arrays.toString(permission)+"权限", Toast.LENGTH_SHORT).show(); // 显示前往设置页的dialog showToAppSettingDialog(); } });
基本使用就是这些了,包括前往应用设置页的方法,也在工具类里面,具体使用可以看demo。
工具类及Demo:github
贴一下工具类代码:
package com.fadai.library;
import android.app.Activity;
import android.content.Context;
import android.content.Intent;
import android.content.pm.PackageManager; import android.net.Uri; import android.os.Build; import android.support.v4.app.ActivityCompat; import android.support.v4.content.ContextCompat; import java.util.ArrayList; import java.util.List; /** * <pre> * author : FaDai * e-mail : i_fadai@163.com * time : 2017/06/13 * desc : xxxx描述 * version: 1.0 * </pre> */ public class PermissionUtils { /** * 检测权限 * * @return true:已授权; false:未授权; */ public static boolean checkPermission(Context context, String permission) { if (ContextCompat.checkSelfPermission(context, permission) == PackageManager.PERMISSION_GRANTED) return true; else return false; } /** * 检测多个权限 * * @return 未授权的权限 */ public static List<String> checkMorePermissions(Context context, String[] permissions) { List<String> permissionList = new ArrayList<>(); for (int i = 0; i < permissions.length; i++) { if (!checkPermission(context, permissions[i])) permissionList.add(permissions[i]); } return permissionList; } /** * 请求权限 */ public static void requestPermission(Context context, String permission, int requestCode) { ActivityCompat.requestPermissions((Activity) context, new String[]{permission}, requestCode); } /** * 请求多个权限 */ public static void requestMorePermissions(Context context, List permissionList, int requestCode) { String[] permissions = (String[]) permissionList.toArray(new String[permissionList.size()]); requestMorePermissions(context, permissions, requestCode); } /** * 请求多个权限 */ public static void requestMorePermissions(Context context, String[] permissions, int requestCode) { ActivityCompat.requestPermissions((Activity) context, permissions, requestCode); } /** * 判断是否已拒绝过权限 * * @return * @describe :如果应用之前请求过此权限但用户拒绝,此方法将返回 true; * -----------如果应用第一次请求权限或 用户在过去拒绝了权限请求, * -----------并在权限请求系统对话框中选择了 Don't ask again 选项,此方法将返回 false。 */ public static boolean judgePermission(Context context, String permission) { if (ActivityCompat.shouldShowRequestPermissionRationale((Activity) context, permission)) return true; else return false; } /** * 检测权限并请求权限:如果没有权限,则请求权限 */ public static void checkAndRequestPermission(Context context, String permission, int requestCode) { if (!checkPermission(context, permission)) { requestPermission(context, permission, requestCode); } } /** * 检测并请求多个权限 */ public static void checkAndRequestMorePermissions(Context context, String[] permissions, int requestCode) { List<String> permissionList = checkMorePermissions(context, permissions); requestMorePermissions(context, permissionList, requestCode); } /** * 检测权限 * * @describe:具体实现由回调接口决定 */ public static void checkPermission(Context context, String permission, PermissionCheckCallBack callBack) { if (checkPermission(context, permission)) { // 用户已授予权限 callBack.onHasPermission(); } else { if (judgePermission(context, permission)) // 用户之前已拒绝过权限申请 callBack.onUserHasAlreadyTurnedDown(permission); else // 用户之前已拒绝并勾选了不在询问、用户第一次申请权限。 callBack.onUserHasAlreadyTurnedDownAndDontAsk(permission); } } /** * 检测多个权限 * * @describe:具体实现由回调接口决定 */ public static void checkMorePermissions(Context context, String[] permissions, PermissionCheckCallBack callBack) { List<String> permissionList = checkMorePermissions(context, permissions); if (permissionList.size() == 0) { // 用户已授予权限 callBack.onHasPermission(); } else { boolean isFirst = true; for (int i = 0; i < permissionList.size(); i++) { String permission = permissionList.get(i); if (judgePermission(context, permission)) { isFirst = false; break; } } String[] unauthorizedMorePermissions = (String[]) permissionList.toArray(new String[permissionList.size()]); if (isFirst)// 用户之前已拒绝过权限申请 callBack.onUserHasAlreadyTurnedDownAndDontAsk(unauthorizedMorePermissions); else // 用户之前已拒绝并勾选了不在询问、用户第一次申请权限。 callBack.onUserHasAlreadyTurnedDown(unauthorizedMorePermissions); } } /** * 检测并申请权限 */ public static void checkAndRequestPermission(Context context, String permission, int requestCode, PermissionRequestSuccessCallBack callBack) { if (checkPermission(context, permission)) {// 用户已授予权限 callBack.onHasPermission(); } else { requestPermission(context, permission, requestCode); } } /** * 检测并申请多个权限 */ public static void checkAndRequestMorePermissions(Context context, String[] permissions, int requestCode, PermissionRequestSuccessCallBack callBack) { List<String> permissionList = checkMorePermissions(context, permissions); if (permissionList.size() == 0) { // 用户已授予权限 callBack.onHasPermission(); } else { requestMorePermissions(context, permissionList, requestCode); } } /** * 判断权限是否申请成功 */ public static boolean isPermissionRequestSuccess(int[] grantResults) { if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) return true; else return false; } /** * 用户申请权限返回 */ public static void onRequestPermissionResult(Context context, String permission, int[] grantResults, PermissionCheckCallBack callback) { if (PermissionUtils.isPermissionRequestSuccess(grantResults)) { callback.onHasPermission(); } else { if (PermissionUtils.judgePermission(context, permission)) { callback.onUserHasAlreadyTurnedDown(permission); } else { callback.onUserHasAlreadyTurnedDownAndDontAsk(permission); } } } /** * 用户申请多个权限返回 */ public static void onRequestMorePermissionsResult(Context context, String[] permissions, PermissionCheckCallBack callback) { boolean isBannedPermission = false; List<String> permissionList = checkMorePermissions(context, permissions); if (permissionList.size() == 0) callback.onHasPermission(); else { for (int i = 0; i < permissionList.size(); i++) { if (!judgePermission(context, permissionList.get(i))) { isBannedPermission = true; break; } } // 已禁止再次询问权限 if (isBannedPermission) callback.onUserHasAlreadyTurnedDownAndDontAsk(permissions); else // 拒绝权限 callback.onUserHasAlreadyTurnedDown(permissions); } } /** * 跳转到权限设置界面 */ public static void toAppSetting(Context context) { Intent intent = new Intent(); intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK); if (Build.VERSION.SDK_INT >= 9) { intent.setAction("android.settings.APPLICATION_DETAILS_SETTINGS"); intent.setData(Uri.fromParts("package", context.getPackageName(), null)); } else if (Build.VERSION.SDK_INT <= 8) { intent.setAction(Intent.ACTION_VIEW); intent.setClassName("com.android.settings", "com.android.settings.InstalledAppDetails"); intent.putExtra("com.android.settings.ApplicationPkgName", context.getPackageName()); } context.startActivity(intent); } public interface PermissionRequestSuccessCallBack { /** * 用户已授予权限 */ void onHasPermission(); } public interface PermissionCheckCallBack { /** * 用户已授予权限 */ void onHasPermission(); /** * 用户已拒绝过权限 * * @param permission:被拒绝的权限 */ void onUserHasAlreadyTurnedDown(String... permission); /** * 用户已拒绝过并且已勾选不再询问选项、用户第一次申请权限; * * @param permission:被拒绝的权限 */ void onUserHasAlreadyTurnedDownAndDontAsk(String... permission); } }
工具类及Demo:github