AnnotationPermission完整代碼
市面上有很多開源框架用于6.0權限請求處理,但是各種框架使用下來,還是感覺不爽,累贅,不直觀。本文介紹的實現方案我認為是使用最簡單,侵入最低的方式。
介紹一下使用方式,竟然說簡單,那就先看看使用怎么個效果先,直接上代碼:
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
}
@Permission(permissions = {Manifest.permission.WRITE_EXTERNAL_STORAGE, Manifest.permission.READ_EXTERNAL_STORAGE}, requestCode = 100)
public void requestPermission(View view) {
Toast.makeText(this, "權限請求成功", Toast.LENGTH_LONG).show();
}
@PermissionCancel
public void requestPermissionCancel() {
Toast.makeText(this, "權限請求取消", Toast.LENGTH_LONG).show();
}
@PermissionDenied
public void requestPermissionDenied() {
Toast.makeText(this, "權限請求被拒絕", Toast.LENGTH_LONG).show();
}
}
如上代碼,只需要在我們處理權限請求的結果方法上面做相應的注解就完事兒。
@Permission:
這個注解是我們關鍵注解,必須存在的,它有兩個作用,第一:注解切入點,只有被注解了的方法才會在方法執行時進行權限請求判斷處理,包含兩個參數,一看就明白的,一個permissions
我們需要請求的權限數組,requestCode
權限請求時的code
;第二:作為我們請求成功的執行方案。
@PermissionCancel:
被注解的方法將在用戶拒絕權限請求并且不再提示的時候觸發。
@PermissionDenied:
被注解的方法將在用戶拒絕權限請求并且下次請求權限會再次觸發。
我們進入思路分析:
根據上面的使用方式,我們可以清晰的分析出我們最終的方案肯定會從注解入手,會在我們觸發
@Permission:
注解的方法的時候去對方法執行前后做一個判斷,看是否獲取權限,如果沒有則請求權限,已經獲取就讓方法繼續執行。然而我們知道權限請求我們是通過activity
發起的,這個時候為了使我們代碼侵入性最小,那我們就不能使用繼承方式去添加發起權限請求的代碼,說好三個注解搞定,就不能多寫一行其他代碼在項目里面。分析這兩個點之后我們首先得考慮怎么對方法進行運行前后監聽,以往我們不難想到用動態代理,確實這是我們android常規的方式,前面文章也有一篇文章ASM框架實現字節碼插樁的方式也可以監聽到我們方法前后,但是今天用一種新方案AspectJ
,其實他的原理和ASM
原理差不多,都是在我們編譯的時候去做處理。當然,我們要獲取注解,對注解做處理肯定也逃不掉反射,通過反射的方式獲取注解參數,那接下來我們就按照上面說的這幾點來寫代碼:
public class PermissionActivity extends AppCompatActivity {
private String[] permissions;
private int requestCode = REQUEST_CODE_DEFALUT;
private static PermissionCallback callback;
@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
View view = new View(this);
view.setBackgroundColor(ContextCompat.getColor(this, android.R.color.transparent));
setContentView(view);
//獲取權限和code
Bundle intent = getIntent().getExtras();
if (intent == null) {
return;
}
if (intent.containsKey(KEY_PERMISSION)) {
permissions = intent.getStringArray(KEY_PERMISSION);
}
if (intent.containsKey(KEY_PERMISSION_CODE)) {
requestCode = intent.getInt(KEY_PERMISSION_CODE, REQUEST_CODE_DEFALUT);
}
if ((permissions == null || permissions.length == 0) && requestCode < 0) {
finish();
return;
}
//判斷是否已經請求,已經請求成功不再重復請求
if (permissions != null && PermissionUtils.hasPermissionRequest(this, permissions)) {
callback.permissionSucess();
finish();
}
//發起權限請求
if (permissions != null) {
ActivityCompat.requestPermissions(this, permissions, requestCode);
}
}
@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
super.onRequestPermissionsResult(requestCode, permissions, grantResults);
if (PermissionUtils.requestPermissionSuccess(grantResults)) {
callback.permissionSucess();
} else if (PermissionUtils.shouldShowRequestPermissionRationale(this, permissions)) {
callback.permissionDenied();
} else {
callback.permissionCancel();
}
finish();
}
@Override
public void finish() {
super.finish();
//去除關閉動畫
overridePendingTransition(0, 0);
}
public static void permission(Context context, String[] permissions, int requestCode, PermissionCallback listener) {
callback = listener;
Intent intent = new Intent(context, PermissionActivity.class);
Bundle bundle = new Bundle();
intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TOP);
bundle.putStringArray(KEY_PERMISSION, permissions);
bundle.putInt(KEY_PERMISSION_CODE, requestCode);
intent.putExtras(bundle);
context.startActivity(intent);
//todo 去除啟動動畫,當fragment啟動的時候未解決
if (context instanceof Activity) {
Activity activity = (Activity) context;
activity.overridePendingTransition(0, 0);
}
}
}
以上代碼主要做了幾件事:
- 一個全新的
activity
用于處理權限請求,此activity
設置全透明,取消所有啟動和關閉動畫; - 創建監聽,用于回調權限請求結果,成功,拒絕,取消;
- 通過
Intent
方式獲取權限參數;
/**
* @Description:權限請求和允許
*/
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface Permission {
String[] permissions();
int requestCode() default REQUEST_CODE_DEFALUT;
}
/**
* @Description:權限取消并且不再提示 拒絕
*/
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface PermissionCancel {
int requestCode() default REQUEST_CODE_DEFALUT;
}
/**
* @Description:權限取消并且不再提示 拒絕
*/
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface PermissionCancel {
int requestCode() default REQUEST_CODE_DEFALUT;
}
public interface PermissionCallback {
void permissionSucess();
void permissionCancel();
void permissionDenied();
}
以上代碼主要做了幾件事:
- 創建我們的回調接口;
- 創建使用的三個注解類文件;
/**
* @Description:編譯時期Aspect api會在編譯同時通過@Aspect處理該類
* @Auther: wangqi
* CreateTime: 2020/8/25.
*/
@Aspect
public class PermissionAspect {
//注解含義,代表監聽被com.kylin.annotationpermission.permission.annotation.Permission類文件并且@annotation(permission)是注解所注解的方法做攔截
@Pointcut("execution(@com.kylin.annotationpermission.permission.annotation.Permission * *(..)) && @annotation(permission)")
public void AccessPoint(Permission permission) {
}
@Around("AccessPoint(permission)")
public void ApproachMethod(final ProceedingJoinPoint point, Permission permission) throws Throwable {
final Context context;
final Object object = point.getThis();
if (object instanceof Context) {
context = (Context) object;
} else if (object instanceof Fragment) {
context = ((Fragment) object).getContext();
} else {
point.proceed();
return;
}
PermissionActivity.permission(context, permission.permissions(), permission.requestCode(), new PermissionCallback() {
@Override
public void permissionSucess() {
try {
point.proceed();//方法繼續執行
} catch (Throwable throwable) {
throwable.printStackTrace();
}
}
@Override
public void permissionCancel() {
PermissionUtils.invokeAnnotation(object, PermissionCancel.class);
}
@Override
public void permissionDenied() {
PermissionUtils.invokeAnnotation(object, PermissionDenied.class);
PermissionUtils.startAndroidSettings(context);
}
});
}
}
以上代碼主要做了幾件事:
- 使用
AspectJ
創建文件,該文件需注意,該文件需要被@aspect
注解,提供切入點方法,處理切入點方法。 - 攔截到方法之后對啟動權限請求界面,通過權限處理結果作出響應。