android權限管理,PermissionsDispatcher使用詳解

0.前言

PermissionsDispatcher提供了一個簡單的基於注釋的API來處理運行時權限。該庫減輕了編寫一堆檢查語句（無論是否已授予您權限）帶來的負擔，以保持您的代碼干凈安全。

地址:https://github.com/permissions-dispatcher/PermissionsDispatcher

1.安裝

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

 

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

 

將PermissionsDispatcher添加到您的項目，請在您的應用程序模塊 build.gradle文件中包括以下內容

 

dependencies {
  implementation "org.permissionsdispatcher:permissionsdispatcher:${latest.version}"
  annotationProcessor "org.permissionsdispatcher:permissionsdispatcher-processor:${latest.version}"
}

 

 

2.用法

0.准備AndroidManifest

將需要用到的權限添加到AndroidManifest.xml：

如相機權限

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

1.附加注釋

PermissionsDispatcher僅引入一些注釋，以保持其常規API的簡潔：

注意：帶注釋的方法不能為private。

注解	需要	描述
@RuntimePermissions	✓	注冊Activity或Fragment處理權限
@NeedsPermission	✓	注釋執行需要一個或多個權限的操作的方法
@OnShowRationale		注釋一種解釋為什么需要權限的方法。它傳入一個PermissionRequest對象，該對象可用於在用戶輸入時繼續或中止當前的權限請求。如果不為該方法指定任何參數，則編譯器將生成process${NeedsPermissionMethodName}ProcessRequest和cancel${NeedsPermissionMethodName}ProcessRequest。您可以使用這些方法代替PermissionRequest（例如：with DialogFragment）
@OnPermissionDenied		注釋如果用戶未授予權限則調用的方法
@OnNeverAskAgain		注釋一個方法，如果用戶選擇讓設備“不再詢問”權限，則調用該方法

 

例:(如下代碼自動彈出授權框)

import androidx.annotation.NonNull;
import androidx.annotation.Nullable;
import androidx.appcompat.app.AppCompatActivity;
import permissions.dispatcher.NeedsPermission;
import permissions.dispatcher.RuntimePermissions;

import android.Manifest;
import android.content.Intent;
import android.net.Uri;
import android.os.Bundle;
import android.provider.MediaStore;
import android.view.View;
import android.widget.Toast;

import com.davemorrissey.labs.subscaleview.ImageSource;
import com.davemorrissey.labs.subscaleview.SubsamplingScaleImageView;

@RuntimePermissions
public class MainActivity extends AppCompatActivity {

    SubsamplingScaleImageView imageView;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        MainActivityPermissionsDispatcher.method_xWithPermissionCheck(this);
        imageView = (SubsamplingScaleImageView)findViewById(R.id.imageView);
        imageView.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                choosePhoto();
            }
        });
    }

    public static final int RC_CHOOSE_PHOTO = 2;

    private void choosePhoto() {
        //調用相冊選取圖像
        Intent intentToPickPic = new Intent(Intent.ACTION_PICK, null);
        intentToPickPic.setDataAndType(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, "image/*");
        startActivityForResult(intentToPickPic, RC_CHOOSE_PHOTO);
    }
    @Override
    protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
        //回調選取結果
        super.onActivityResult(requestCode, resultCode, data);
        switch (requestCode) {
            case RC_CHOOSE_PHOTO:
                try{
                    Uri uri = data.getData();
                    imageView.setImage(ImageSource.uri(uri));
                }catch (Exception E){
                    Toast.makeText(this, "出錯", Toast.LENGTH_SHORT).show();
                }
                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.READ_EXTERNAL_STORAGE,Manifest.permission.WRITE_EXTERNAL_STORAGE})
     void method_x() {
        //使用權限
        Toast.makeText(this, "已有權限", Toast.LENGTH_SHORT).show();
    }
}

 

 

 

 

 

 

 

1、添加依賴

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