Android PermissionUtils：運行時權限工具類及申請權限的正確姿勢

PermissionUtil

經常寫Android運行時權限申請代碼，每次都是復制過來之後，改一下權限字符串就用，把代碼搞得亂糟糟的，於是便有了封裝工具類的想法，話不多說，先看怎麽用：

工具類及Demo：github

簡潔版申請權限

申請一個權限：

    PermissionUtils.checkAndRequestPermission(mContext, PERMISSION_CAMERA, REQUEST_CODE_CAMERA,
                new PermissionUtils.PermissionRequestSuccessCallBack() {
            @Override
            public void onHasPermission() {
                // 權限已被授予
                toCamera();
            }
        });
 

然後在onRequestPermissionsResult中：

if(PermissionUtils.isPermissionRequestSuccess(grantResults))
                {
                    // 權限申請成功
                    toCamera();
                }

什麽？要同時申請多個權限？

    PermissionUtils.checkAndRequestMorePermissions(mContext, PERMISSIONS, REQUEST_CODE_PERMISSIONS,
                new PermissionUtils.PermissionRequestSuccessCallBack() {
            @Override
            public void onHasPermission() {
                // 權限已被授予
                toCamera();
            }
        });
 

當然上面這些都不是申請權限的正確姿勢，理想的姿勢應該是：

• 第一次申請權限：按照正常流程走；
• 如果用戶第一次拒絕了權限申請，第二次申請時應向用戶解釋權限用途；
• 如果用戶勾選了“不再詢問”選項，應引導用戶去設置頁手動開啟權限。

如圖：

於是，引申出了復雜版的權限申請方法：

自定義權限申請：

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中：

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 : [email protected]
 *     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

Android PermissionUtils：運行時權限工具類及申請權限的正確姿勢