Android PermissionUtils:運行時權限工具類及申請權限的正確姿勢
阿新 • • 發佈:2018-09-14
stp 實現 回調 dia contex -s pla info 過去
Android PermissionUtils:運行時權限工具類及申請權限的正確姿勢
ifadai 關註 2017.06.16 16:22* 字數 318 閱讀 3637評論 1喜歡 6PermissionUtil
經常寫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:運行時權限工具類及申請權限的正確姿勢