前言

Google在Android6.0版本中添加了一些新特性谚攒，其中之一就是運(yùn)行時請求權(quán)限阳准，用戶可以拒絕應(yīng)用對敏感權(quán)限的請求。而對于android開發(fā)者馏臭，我們只需要將targetSdkVersion配置為23+就能使用該特性野蝇。網(wǎng)上已經(jīng)存在一些流行的解決方案，比如使用注解的PermissionsDispatcher括儒，通過Rxjava實(shí)現(xiàn)的RxPermissions绕沈。前者使用直觀，但是注解過多帮寻，而且對結(jié)果的處理關(guān)于麻煩乍狐，另外需要自己調(diào)用注解生成的類文件。而RxPermissions使用方便（通過Fragment管理權(quán)限相關(guān)的回調(diào)方法）固逗，但在使用上不夠解耦浅蚪，直觀，其對權(quán)限請求結(jié)果的處理也缺少封裝烫罩。根據(jù)自己對Android權(quán)限機(jī)制的理解惜傲，同時參考兩者的優(yōu)點(diǎn)，實(shí)現(xiàn)了RuntimePermission贝攒。

簡介

RuntimePermission提供了注解的方式來實(shí)現(xiàn)權(quán)限請求操漠，雖然大大減少了的模板代碼，但前提饿这，使用者需要知道哪個Activity需要使用敏感權(quán)限浊伙，以及使用哪些敏感權(quán)限，這是運(yùn)行時授權(quán)的基本要求长捧。

RuntimePermission覆蓋了大部分權(quán)限操作的場景嚣鄙，盡量減少權(quán)限對代碼的耦合，apt生成的權(quán)限邏輯處理代碼通過反射去調(diào)取串结，在最樂觀的條件下哑子，僅需要在對于Activity上加上需要使用權(quán)限的注解，然后在代碼中手動執(zhí)行下RuntimePermission.tryPermissionByAnnotation(Activity.this)即可:

@PermissionActivity(Manifest.permission.ACCESS_COARSE_LOCATION)
public class MainActivity extends AppCompatActivity {

    ...
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        ...

        RuntimePermission.tryPermissionByAnnotation(MainActivity.this);

    }
}

在需要處理成功授權(quán)后的操作肌割，只要在Activity中添加一個無參方法卧蜓，加上對應(yīng)注解：

    @PermissionGranted
    public void initLocation(){
        Toast.makeText(this, "ACCESS_COARSE_LOCATION is granted", Toast.LENGTH_SHORT).show();
    }

使用

1.添加依賴

在project下的build.gradle添加maven地址：

allprojects {
        repositories {
            ...
            maven { url 'https://jitpack.io' }
        }
    }

在你app的build.gradle中添加如下依賴，version為對應(yīng)的最新版本號：

dependencies {
    implementation 'com.github.booqin.RuntimePermissions:runtime-permission:version'
    annotationProcessor 'com.github.booqin.RuntimePermissions:compiler:version'
}

2.添加權(quán)限

在你需要設(shè)置權(quán)限的app中添加相應(yīng)權(quán)限到manifest中把敞，如camera:

<uses-permission android:name="android.permission.CAMERA"/>

在需要使用對應(yīng)權(quán)限的Activity中設(shè)置注解：

@PermissionActivity(Manifest.permission.CAMERA)
public class MainActivity extends AppCompatActivity {
    ……
}

注解@PermissionActivity支持字符串?dāng)?shù)組弥奸，所以你可以通過一下方式添加多個權(quán)限：

@PermissionActivity({Manifest.permission.READ_CONTACTS, Manifest.permission.CAMERA})

3.權(quán)限回調(diào)

在RuntimePermission中可以通過注解@PermissionGranted完成授權(quán)結(jié)果的回調(diào)。注解在于其簡潔奋早，RuntimePermission只提供了權(quán)限許可時的注解@PermissionGranted盛霎，因?yàn)樵谑褂蒙显撟⒔饪梢詽M足絕大部分開發(fā)赠橙，同時過多的注解回導(dǎo)致代碼的混亂，從而適得其反愤炸。
　　對于你需要做的期揪，只要在需要回調(diào)的方法（無參方法）上添加該備注，同時聲明對應(yīng)的權(quán)限即可：

    @PermissionGranted(Manifest.permission.CAMERA)
    public void initCamera(){
        ……
    }

如果需要所有權(quán)限都被授權(quán)后规个，再做回調(diào)處理凤薛，可以通過一個無參注解來實(shí)現(xiàn)：

    @PermissionGranted
    public void allGranted(){
        ……
    }

后續(xù)可能會開放更多注解回調(diào)。

4.開啟請求

完成以上的代碼后诞仓，可以通過RuntimePermission執(zhí)行權(quán)限的動態(tài)申請枉侧，必傳參數(shù)為acticity，該方法默認(rèn)強(qiáng)制需要授權(quán)所有權(quán)限后才能運(yùn)行該Activity狂芋。注解回調(diào)的請求:

    RuntimePermission.tryPermissionByAnnotation(Activity activity);

如果不需要強(qiáng)制授權(quán)榨馁，可以通過如下方法，設(shè)置false即可：

    RuntimePermission.tryPermissionByAnnotation(final Activity activity, boolean isMustGranted);

在特殊情況下帜矾，可能需要處理權(quán)限被拒絕后的事件翼虫，或者添加自定義Rationale下的提醒文本，RuntimePermission中預(yù)覽了自定義接口來暴露以上事件：

    RuntimePermission.tryPermissionByAnnotation(final Activity activity, boolean isMustGranted, final PermissionsDeniedResultListener permissionsDeniedResultListener)

當(dāng)需要指定請求某權(quán)限時屡萤，使用如下方法：

    RuntimePermission.tryPermissionByAnnotation(final Activity activity, String... permissions);

TODO

添加對Fragment的支持
~~對在多個權(quán)限中根據(jù)需求執(zhí)行單個權(quán)限的請求~~已在v1.0.1中添加

注意事項(xiàng)

由于動態(tài)權(quán)限申請的結(jié)果回調(diào)到onRequestPermissionsResult中珍剑，而該方法存在與Activity中，所以@PermissionActivity只適用與Activity死陆，同時為了最大程度的精簡代碼招拙，只提供了@PermissionGranted來實(shí)現(xiàn)權(quán)限被許可情況下的回調(diào)的一個無參方法，@PermissionGranted需要在@PermissionActivity注解下的Activity中才生效措译，這種依賴關(guān)系可以通過lint來提示開發(fā)者别凤，這里暫時不做處理。

Android SDK提供了注解功能的支持包领虹，其中可以合理的使用@RequiresPermission注解规哪，該注解會檢查在manifest中是否聲明該權(quán)限，并會顯示對應(yīng)的警告塌衰。

RuntimePermissions-動態(tài)權(quán)限