[TOC]
這個(gè)已經(jīng)在用了违寞，記錄下過(guò)程
GitHub地址
使用方式
1.在BaseActivity,BaseFragment中加入:
@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
super.onRequestPermissionsResult(requestCode, permissions, grantResults);
PermissionCat.onRequestPermissionsResult(this,permissions, grantResults);
}
注意：第一個(gè)參數(shù)是當(dāng)前activity/fragment的對(duì)象
2.使用方式有注解or回調(diào)兩種
@PermCat(value = PERMISSION_CAMERA)
public void btn11() {
if(PermissionCat.has(this,PERMISSION_CAMERA)){
//TODO
}else{
PermissionCat.request("拍照用",this,null,PERMISSION_CAMERA);
}
}
- 注解：
- 為方法添加PermCat注解刚盈，值為申請(qǐng)的權(quán)限中的一個(gè)，用于注解沖突過(guò)濾
- has方法判斷是否已經(jīng)授權(quán)栏妖，參數(shù)1：當(dāng)前類(lèi)對(duì)象罗售。參數(shù)2：權(quán)限（字符串或字符串?dāng)?shù)組）
- request申請(qǐng)授權(quán)呐萨，參數(shù)1：當(dāng)被禁用并不再詢問(wèn)時(shí)，彈窗說(shuō)明需要權(quán)限的原因莽囤。
參數(shù)2：當(dāng)前類(lèi)對(duì)象。參數(shù)3：回調(diào)對(duì)象,使用注解方式時(shí)傳null切距。參數(shù)4：權(quán)限朽缎。
public void btn12() {
if(PermissionCat.has(this,PERMISSION_CAMERA)){
//TODO
}else{
PermissionCat.request("拍照用", this, new PermissionCallback() {
@Override
public void onGranted(String[] permissions, List<String> granted) {
if(!granted.isEmpty() && PERMISSION_CAMERA.equals(granted.get(0))){
btn12();
}
}
@Override
public void onDenied(String[] permissions, List<String> denied) {
}
}, PERMISSION_CAMERA);
}
}
- 回調(diào)：
- 回調(diào)方式時(shí)不需要為方法添加注解，request方法第三個(gè)參數(shù)傳入PermissionCallback對(duì)象谜悟。
- 回調(diào)中的第一個(gè)參數(shù)是申請(qǐng)的權(quán)限话肖，第二個(gè)參數(shù)是授予/禁止的權(quán)限列表
Android權(quán)限框架流程圖.png
實(shí)現(xiàn)方式
包含的類(lèi)
- PermCat 注解，標(biāo)記處理完權(quán)限后的回調(diào)方法
- PermissionCat 封裝對(duì)外部提供的靜態(tài)api
- PermissionHelper 為PermissionCat處理權(quán)限的代理類(lèi)
- PermissionCallback 使用監(jiān)聽(tīng)器方式接收權(quán)限處理結(jié)果的回調(diào)
- AppSettingDialog 被拒絕并不再詢問(wèn)后彈出前往設(shè)置頁(yè)的窗
- PermissionAskToSettingActivity 無(wú)界面activity葡幸，彈窗和打開(kāi)設(shè)置頁(yè)的上下文最筒，在onActivityResult中接收結(jié)果，簡(jiǎn)化使用者代碼
是否已授權(quán)權(quán)限
PermissionCat.has(this,PERMISSION_CAMERA)
1.PermissionCat中需要有has()方法蔚叨，判斷是否已授權(quán)該權(quán)限
public static boolean has(Object object, String... perms) {
if (!checkValid(object)) {
throw new NullPointerException("PermissionCat -> object must be Activity or Fragment");
}
return instance.mHelper.has(object, perms);
}
2.具體判斷過(guò)程在代理類(lèi)helper中實(shí)現(xiàn),最終調(diào)用系統(tǒng)api判斷
/**
* 判斷是否允許了全部權(quán)限床蜘，沒(méi)有全部允許就返回false
* @param object
* @param perms
* @return
*/
protected boolean has(Object object, String... perms){
if(Build.VERSION.SDK_INT < Build.VERSION_CODES.M){
return true;
}
for (String perm : perms) {
if(ActivityCompat.checkSelfPermission(target(object),perm) != PackageManager.PERMISSION_GRANTED){
return false;
}
}
return true;
}
3.用戶傳入的上下文已Object接收，可能有3種情況
protected Activity target(Object object) {
Activity activity;
if (object instanceof Fragment) {
activity = ((Fragment) object).getActivity();
} else if (object instanceof android.app.Fragment) {
activity = ((android.app.Fragment) object).getActivity();
} else {
activity = (Activity) object;
}
if (activity == null) {
throw new IllegalStateException("the result of type conversion is null");
}
return activity;
}
判斷完成
申請(qǐng)權(quán)限
1.外部調(diào)用申請(qǐng)方法request(),在PermissionCat中
2.申請(qǐng)的時(shí)候判斷是否已經(jīng)授權(quán)了蔑水，如果已授權(quán)就直接通知授權(quán)成功下發(fā)申請(qǐng)結(jié)果邢锯，否則代理類(lèi)執(zhí)行申請(qǐng)方法
/**
* 重載的請(qǐng)求授權(quán)方法，傳入監(jiān)聽(tīng)器時(shí)搀别，不會(huì)回調(diào)注解方法
* @param reason 要求打開(kāi)權(quán)限的原因
* @param object 上下文丹擎，fragment調(diào)用時(shí)需要傳入fragment對(duì)象V
* @param callback
* @param perms
*/
public static void request(String reason, Object object, PermissionCallback callback, String... perms) {
if (!checkValid(object)) {
throw new NullPointerException("PermissionCat -> object must be Activity or Fragment");
}
instance.objectName = object.getClass().getName();
instance.mPermissionCallback = callback;
instance.reason = reason;
if (has(object, perms)) {
instance.notifyResult(object, perms);
return;
}
instance.mHelper.request(object, perms);
}
3.最終也是調(diào)用系統(tǒng)api完成，has()時(shí)只接受boolean結(jié)果，所以都可以用activity對(duì)象調(diào)用蒂培，這里要接收授權(quán)結(jié)果再愈，所以已傳入的上下文對(duì)象調(diào)用api
/**
* 區(qū)分activity、fragment中操作的回調(diào)
* @param object
* @param perms
*/
protected void request(Object object,String... perms){
if(Build.VERSION.SDK_INT < Build.VERSION_CODES.M){
return;
}
int requestCode = (int) (Math.random() * 100);
if (object instanceof Fragment) {
((Fragment) object).requestPermissions(perms,requestCode);
} else if (object instanceof android.app.Fragment) {
((android.app.Fragment) object).requestPermissions(perms,requestCode);
} else {
((Activity) object).requestPermissions(perms,requestCode);
}
}
4.在使用者的封裝的BaseActivity和BaseFragment中調(diào)用方法护戳，將系統(tǒng)api的授權(quán)結(jié)果傳遞到PermissionCat翎冲，
PermissionCat.onRequestPermissionsResult(this,permissions, grantResults);
/**
* 授予/禁止權(quán)限后的回調(diào)
*
* @param object
* @param permissions
* @param grantResults
*/
public static void onRequestPermissionsResult(Object object, @NonNull String[] permissions, @NonNull int[] grantResults) {
if (!instance.objectName.equals(object.getClass().getName())) return;
List<String> granted = new ArrayList<>();
List<String> denied = new ArrayList<>();
for (int i = 0; i < permissions.length; i++) {
if (grantResults[i] == PackageManager.PERMISSION_GRANTED) {
granted.add(permissions[i]);
} else {
denied.add(permissions[i]);
}
}
if (!denied.isEmpty() && instance.mHelper.noAsk(object, denied)) {
//有權(quán)限被拒絕并不再詢問(wèn)
instance.showAskSetting(object, permissions);
} else {
instance.setPermissionResult(object, permissions, granted, denied);
}
}
5.授權(quán)結(jié)果中包含所有申請(qǐng)的權(quán)限和已經(jīng)授權(quán)的權(quán)限，判斷拒絕的權(quán)限灸异，是否被不再詢問(wèn)府适，需要一個(gè)拒絕權(quán)限列表，所以我們將權(quán)限分為授權(quán)granted肺樟，拒絕denied兩個(gè)集合檐春。
6.1.如果順利進(jìn)行，那么開(kāi)始下發(fā)這次申請(qǐng)的結(jié)果:
private void setPermissionResult(Object object, String[] permissions, List<String> granted, List<String> denied) {
if (!granted.isEmpty() && mPermissionCallback != null) {
//授予回調(diào)
mPermissionCallback.onGranted(permissions, granted);
}
if (!denied.isEmpty() && mPermissionCallback != null) {
//拒絕回調(diào)
mPermissionCallback.onDenied(permissions, denied);
}
if (denied.isEmpty() && mPermissionCallback == null) {
//全部授予么伯，調(diào)用注解方法
reflectMethod(object, permissions);
}
}
- 希望以回調(diào)方式接收
- 希望以注解方式接收
6.2.使用注解時(shí)反射調(diào)用注解方法:
/**
* 反射調(diào)用注解的使用權(quán)限的方法
*
* @param permissions
*/
private void reflectMethod(Object object, String[] permissions) {
Class clz = object.getClass();
Method[] methods = clz.getDeclaredMethods();
for (Method m : methods) {
if (m.isAnnotationPresent(PermCat.class)) {
Annotation[] annotations = m.getDeclaredAnnotations();
PermCat permCat = null;
for (Annotation a : annotations) {
if (a instanceof PermCat) {
permCat = (PermCat) a;
break;
}
}
if (permCat == null) continue;
//檢測(cè)注解,防止注解重名
if (Arrays.asList(permissions).contains(permCat.value())) {
if (m.isAccessible()) {
//如果方法是私有疟暖，設(shè)置為可以訪問(wèn)，否則無(wú)法反射訪問(wèn)
m.setAccessible(true);
}
try {
m.invoke(object);
} catch (Exception e) {
e.printStackTrace();
}
}
}
}
}
7.1.被拒絕的權(quán)限組denied田柔，在代理類(lèi)helper中判斷是否有被選擇不再詢問(wèn)的,也是調(diào)用系統(tǒng)api完成
/**
* 是否對(duì)某個(gè)權(quán)限選擇拒絕并不再詢問(wèn)
* @param object
* @param perms
* @return
*/
protected boolean noAsk(Object object,List<String> perms){
for (String perm:perms) {
if(!ActivityCompat.shouldShowRequestPermissionRationale(target(object),perm)){
return true;
}
}
return false;
}
7.2.如果有被不再詢問(wèn)的權(quán)限俐巴，那么彈出dialog，詢問(wèn)是否去設(shè)置頁(yè)
/**
* 權(quán)限被禁用,彈出詢問(wèn)是否去設(shè)置權(quán)限的對(duì)話框
*
* @param object
* @param perms
*/
private void showAskSetting(Object object, String... perms) {
askPerms = perms;
AppSettingDialog.Builder builder = new AppSettingDialog.Builder(object);
builder
.title("權(quán)限申請(qǐng)")
.content(reason == null ? "應(yīng)用需要該權(quán)限" : reason)
.cancelStr("取消")
.confirmStr("去設(shè)置")
.build()
.show();
}
看著是show了一個(gè)dialog硬爆，實(shí)際上是打開(kāi)了一個(gè)無(wú)界面activity欣舵，再?gòu)棿埃⒔邮赵O(shè)置頁(yè)結(jié)果缀磕，最終回調(diào)到PermissionCat中
/**
* 設(shè)置頁(yè)面退后回調(diào)
*
* @param object
*/
protected void onActivityResult(Object object) {
List<String> granted = new ArrayList<>();
List<String> denied = new ArrayList<>();
String[] perms = askPerms.clone();
askPerms = null;
for (String perm : perms) {
if (has(object, perm)) {
granted.add(perm);
} else {
denied.add(perm);
}
}
setPermissionResult(object, perms, granted, denied);
}
7.3分發(fā)結(jié)果
完成缘圈，已測(cè)試
