PermissionsDispatcher使用詳解

PermissionsDispatcher是一個基于注解肯夏、幫助開發(fā)者簡單處理Android 6.0系統(tǒng)中的運行時權(quán)限的開源庫谐岁。避免了開發(fā)者編寫大量繁瑣的樣板代碼趴久。

開源地址:https://github.com/hotchemi/PermissionsDispatcher

文檔介紹:http://hotchemi.github.io/PermissionsDispatcher/

下面詳細介紹一下如何在Android Studio上使用該開源庫运提。

1、添加依賴

首先在項目工程下的build.gradle文件中加入對maven倉庫依賴引入的支持塘辅。

allprojects {
    repositories {
        jcenter()
        mavenCentral()
    }
}

之后在module下的build.gradle文件中添加兩項依賴:

compile 'com.github.hotchemi:permissionsdispatcher:2.3.1'
annotationProcessor 'com.github.hotchemi:permissionsdispatcher-processor:2.3.1'

并將targetSdkVersion設(shè)為23,即:targetSdkVersion 23

2皆撩、在Activity或Fragment中使用

注解列表:

Annotation Required Description
@RuntimePermissions ? 注解在其內(nèi)部需要使用運行時權(quán)限的Activity或Fragment上
@NeedsPermission ? 注解在需要調(diào)用運行時權(quán)限的方法上扣墩,當用戶給予權(quán)限時會執(zhí)行該方法
@OnShowRationale 注解在用于向用戶解釋為什么需要調(diào)用該權(quán)限的方法上,只有當?shù)谝淮握埱髾?quán)限被用戶拒絕扛吞,下次請求權(quán)限之前會調(diào)用
@OnPermissionDenied 注解在當用戶拒絕了權(quán)限請求時需要調(diào)用的方法上
@OnNeverAskAgain 注解在當用戶選中了授權(quán)窗口中的不再詢問復(fù)選框后并拒絕了權(quán)限請求時需要調(diào)用的方法呻惕,一般可以向用戶解釋為何申請此權(quán)限,并根據(jù)實際需求決定是否再次彈出權(quán)限請求對話框

注意:被注解的方法不能是私有方法滥比。

只有@RuntimePermissions@NeedsPermission是必須的亚脆,其余注解均為可選。當使用了@RuntimePermissions@NeedsPermission之后盲泛,需要點擊菜單欄中Build菜單下的Make Project濒持,或者按快捷鍵Ctrl + F9編譯整個項目,編譯器會在app\build\intermediates\classes\debug目錄下與被注解的Activity同一個包下生成一個輔助類寺滚,名稱為被注解的Activity名稱+PermissionsDispatcher.class弥喉,如圖所示:

生成的輔助類

接下來可以調(diào)用輔助類里面的方法完成應(yīng)用的權(quán)限請求了。

在需要調(diào)用權(quán)限的位置調(diào)用輔助類里面的xxxWithCheck方法玛迄,xxx是被@NeedsPermission注解的方法名由境。如:

MainActivityPermissionsDispatcher.showCameraWithCheck(this);

之后,還需要重寫該Activity的onRequestPermissionsResult()方法,其方法內(nèi)調(diào)用輔助類的onRequestPermissionsResult()方法虏杰,如下:

@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    // NOTE: delegate the permission handling to generated method
    MainActivityPermissionsDispatcher.onRequestPermissionsResult(this, requestCode, grantResults);
}

完整的MainActivity如下所示讥蟆。

  • MainActivity.java
@RuntimePermissions
public class MainActivity extends AppCompatActivity implements View.OnClickListener {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        findViewById(R.id.button_camera).setOnClickListener(this);
        findViewById(R.id.button_contacts).setOnClickListener(this);
    }

    @Override
    public void onClick(@NonNull View v) {
        switch (v.getId()) {
            case R.id.button_camera:
                // NOTE: delegate the permission handling to generated method
                MainActivityPermissionsDispatcher.showCameraWithCheck(this);
                break;
            case R.id.button_contacts:
                // NOTE: delegate the permission handling to generated method
                MainActivityPermissionsDispatcher.showContactsWithCheck(this);
                break;
        }
    }

    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        // NOTE: delegate the permission handling to generated method
        MainActivityPermissionsDispatcher.onRequestPermissionsResult(this, requestCode, grantResults);
    }

    @NeedsPermission(Manifest.permission.CAMERA)
    void showCamera() {
        // NOTE: Perform action that requires the permission. If this is run by PermissionsDispatcher, the permission will have been granted
        getSupportFragmentManager().beginTransaction()
                .replace(R.id.sample_content_fragment, CameraPreviewFragment.newInstance())
                .addToBackStack("camera")
                .commitAllowingStateLoss();
    }

    @NeedsPermission({Manifest.permission.READ_CONTACTS, Manifest.permission.WRITE_CONTACTS})
    void showContacts() {
        // NOTE: Perform action that requires the permission.
        // If this is run by PermissionsDispatcher, the permission will have been granted
        getSupportFragmentManager().beginTransaction()
                .replace(R.id.sample_content_fragment, ContactsFragment.newInstance())
                .addToBackStack("contacts")
                .commitAllowingStateLoss();
    }

    @OnShowRationale(Manifest.permission.CAMERA)
    void showRationaleForCamera(PermissionRequest request) {
        // NOTE: Show a rationale to explain why the permission is needed, e.g. with a dialog.
        // Call proceed() or cancel() on the provided PermissionRequest to continue or abort
        showRationaleDialog(R.string.permission_camera_rationale, request);
    }

    @OnShowRationale({Manifest.permission.READ_CONTACTS, Manifest.permission.WRITE_CONTACTS})
    void showRationaleForContact(PermissionRequest request) {
        // NOTE: Show a rationale to explain why the permission is needed, e.g. with a dialog.
        // Call proceed() or cancel() on the provided PermissionRequest to continue or abort
        showRationaleDialog(R.string.permission_contacts_rationale, request);
    }

    @OnPermissionDenied(Manifest.permission.CAMERA)
    void onCameraDenied() {
        // NOTE: Deal with a denied permission, e.g. by showing specific UI
        // or disabling certain functionality
        Toast.makeText(this, R.string.permission_camera_denied, Toast.LENGTH_SHORT).show();
    }

    @OnNeverAskAgain(Manifest.permission.CAMERA)
    void onCameraNeverAskAgain() {
        Toast.makeText(this, R.string.permission_camera_never_askagain, Toast.LENGTH_SHORT).show();
    }

    public void onBackClick(View view) {
        getSupportFragmentManager().popBackStack();
    }

    private void showRationaleDialog(@StringRes int messageResId, final PermissionRequest request) {
        new AlertDialog.Builder(this)
                .setPositiveButton("允許", new DialogInterface.OnClickListener() {
                    @Override
                    public void onClick(@NonNull DialogInterface dialog, int which) {
                        request.proceed();
                    }
                })
                .setNegativeButton("拒絕", new DialogInterface.OnClickListener() {
                    @Override
                    public void onClick(@NonNull DialogInterface dialog, int which) {
                        request.cancel();
                    }
                })
                .setCancelable(false)
                .setMessage(messageResId)
                .show();
    }
}

3、附:危險權(quán)限和權(quán)限組列表

Android官方文檔:https://developer.android.com/guide/topics/security/permissions.html#normal-dangerous

摘錄如下:

權(quán)限組 權(quán)限
CALENDAR READ_CALENDAR
WRITE_CALENDAR
CAMERA CAMERA
CONTACTS READ_CONTACTS
WRITE_CONTACTS
GET_ACCOUNTS
LOCATION ACCESS_FINE_LOCATION
ACCESS_COARSE_LOCATION
PHONE READ_PHONE_STATE
CALL_PHONE
READ_CALL_LOG
WRITE_CALL_LOG
ADD_VOICEMAIL
USE_SIP
PROCESS_OUTGOING_CALLS
SENSORS BODY_SENSORS
SMS SEND_SMS
RECEIVE_SMS
READ_SMS
RECEIVE_WAP_PUSH
RECEIVE_MMS
STORAGE READ_EXTERNAL_STORAGE
WRITE_EXTERNAL_STORAGE

4纺阔、附:Demo下載

http://download.csdn.net/detail/u012939909/9722890

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末瘸彤,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子笛钝,更是在濱河造成了極大的恐慌质况,老刑警劉巖,帶你破解...
    沈念sama閱讀 212,222評論 6 493
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件玻靡,死亡現(xiàn)場離奇詭異结榄,居然都是意外死亡,警方通過查閱死者的電腦和手機囤捻,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 90,455評論 3 385
  • 文/潘曉璐 我一進店門臼朗,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人蝎土,你說我怎么就攤上這事视哑。” “怎么了誊涯?”我有些...
    開封第一講書人閱讀 157,720評論 0 348
  • 文/不壞的土叔 我叫張陵挡毅,是天一觀的道長。 經(jīng)常有香客問我暴构,道長慷嗜,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 56,568評論 1 284
  • 正文 為了忘掉前任丹壕,我火速辦了婚禮庆械,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘菌赖。我一直安慰自己缭乘,他們只是感情好,可當我...
    茶點故事閱讀 65,696評論 6 386
  • 文/花漫 我一把揭開白布琉用。 她就那樣靜靜地躺著堕绩,像睡著了一般。 火紅的嫁衣襯著肌膚如雪邑时。 梳的紋絲不亂的頭發(fā)上奴紧,一...
    開封第一講書人閱讀 49,879評論 1 290
  • 那天,我揣著相機與錄音晶丘,去河邊找鬼黍氮。 笑死唐含,一個胖子當著我的面吹牛,可吹牛的內(nèi)容都是我干的沫浆。 我是一名探鬼主播捷枯,決...
    沈念sama閱讀 39,028評論 3 409
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼专执!你這毒婦竟也來了淮捆?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 37,773評論 0 268
  • 序言:老撾萬榮一對情侶失蹤本股,失蹤者是張志新(化名)和其女友劉穎攀痊,沒想到半個月后,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體拄显,經(jīng)...
    沈念sama閱讀 44,220評論 1 303
  • 正文 獨居荒郊野嶺守林人離奇死亡苟径,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 36,550評論 2 327
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發(fā)現(xiàn)自己被綠了凿叠。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 38,697評論 1 341
  • 序言:一個原本活蹦亂跳的男人離奇死亡嚼吞,死狀恐怖盒件,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情舱禽,我是刑警寧澤炒刁,帶...
    沈念sama閱讀 34,360評論 4 332
  • 正文 年R本政府宣布,位于F島的核電站誊稚,受9級特大地震影響翔始,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜里伯,卻給世界環(huán)境...
    茶點故事閱讀 40,002評論 3 315
  • 文/蒙蒙 一城瞎、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧疾瓮,春花似錦脖镀、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,782評論 0 21
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至肩碟,卻和暖如春强窖,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背削祈。 一陣腳步聲響...
    開封第一講書人閱讀 32,010評論 1 266
  • 我被黑心中介騙來泰國打工翅溺, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 46,433評論 2 360
  • 正文 我出身青樓未巫,卻偏偏與公主長得像窿撬,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子叙凡,可洞房花燭夜當晚...
    茶點故事閱讀 43,587評論 2 350

推薦閱讀更多精彩內(nèi)容