是什么？

EasyPermissions是一個包裝器庫，用于簡化針對Android M或更高版本的基本系統(tǒng)權(quán)限邏輯。

引入

dependencies {
    //  AndroidX 的應(yīng)用
    implementation 'pub.devrel:easypermissions:3.0.0'
 
    //  Android 
    implementation 'pub.devrel:easypermissions:2.0.1'
}

使用

基礎(chǔ)

要開始使用EasyPermissions，請讓您的Activity（或Fragment）覆蓋onRequestPermissionsResult方法：

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    }

    @Override
    public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);

        // 將結(jié)果轉(zhuǎn)發(fā)給 EasyPermissions
        EasyPermissions.onRequestPermissionsResult(requestCode, permissions, grantResults, this);
    }
}

請求權(quán)限

下面的示例顯示了如何同時請求同時具有CAMERA和ACCESS_FINE_LOCATION權(quán)限的方法的權(quán)限。 有幾件事要注意：

• 使用EasyPermissions＃hasPermissions（...）檢查應(yīng)用程序是否已具有所需的權(quán)限。 此方法可以將任意數(shù)量的權(quán)限作為其最終參數(shù)。
• 使用EasyPermissions＃requestPermissions請求權(quán)限。 此方法將請求系統(tǒng)權(quán)限，并在必要時顯示提供的基本原理字符串。 提供的請求代碼對于該請求應(yīng)該是唯一的，并且該方法可以將任何數(shù)量的權(quán)限作為其最終參數(shù)。
• 使用AfterPermissionGranted注解。 這是可選的，但為方便起見而提供。 如果授予了給定請求中的所有權(quán)限，則將執(zhí)行所有帶有正確請求代碼注釋的方法（確保具有唯一的請求代碼）。 帶注釋的方法必須為空并且沒有輸入?yún)?shù)（相反，可以使用onSaveInstanceState來保留被抑制參數(shù)的狀態(tài)）。 這是為了簡化在授予所有許可權(quán)后需要運行請求方法的常見流程。 也可以通過在onPermissionsGranted回調(diào)上添加邏輯來實現(xiàn)。

@AfterPermissionGranted(RC_CAMERA_AND_LOCATION)
private void methodRequiresTwoPermission() {
    String[] perms = {Manifest.permission.CAMERA, Manifest.permission.ACCESS_FINE_LOCATION};
    if (EasyPermissions.hasPermissions(this, perms)) {
        // 已經(jīng)有權(quán)限，進(jìn)行相關(guān)操作
        // ...
    } else {
        // 沒有權(quán)限，進(jìn)行權(quán)限請求
        EasyPermissions.requestPermissions(this, getString(R.string.camera_and_location_rationale),
                RC_CAMERA_AND_LOCATION, perms);
    }
}

或者，為了更好地控制對話框，請使用PermissionRequest：

EasyPermissions.requestPermissions(
        new PermissionRequest.Builder(this, RC_CAMERA_AND_LOCATION, perms)
                .setRationale(R.string.camera_and_location_rationale)
                .setPositiveButtonText(R.string.rationale_ask_ok)
                .setNegativeButtonText(R.string.rationale_ask_cancel)
                .setTheme(R.style.my_fancy_style)
                .build());

（可選）為獲得更好的控件，您可以讓Activity / Fragment實現(xiàn)PermissionCallbacks接口。

public class MainActivity extends AppCompatActivity implements EasyPermissions.PermissionCallbacks {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    }

    @Override
    public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);

        // 將結(jié)果轉(zhuǎn)發(fā)給 EasyPermissions
        EasyPermissions.onRequestPermissionsResult(requestCode, permissions, grantResults, this);
    }

    @Override
    public void onPermissionsGranted(int requestCode, List<String> list) {
        // 授予權(quán)限
        // ...
    }

    @Override
    public void onPermissionsDenied(int requestCode, List<String> list) {
        // 請求權(quán)限被拒
        // ...
    }
}

拒絕權(quán)限的情況下

在某些情況下，如果沒有某些權(quán)限，您的應(yīng)用將無法正常運行。 如果用戶使用“不再詢問”選項拒絕這些權(quán)限，則您將無法從用戶那里請求這些權(quán)限，因此必須在應(yīng)用程序設(shè)置中進(jìn)行更改。 您可以使用方法EasyPermissions.somePermissionPermanentlyDenied（...）在這種情況下向用戶顯示對話框，并將其定向到您應(yīng)用的系統(tǒng)設(shè)置屏幕：

注意：由于Android框架權(quán)限API提供的信息的限制，somePermissionPermanentlyDenied方法僅在權(quán)限被拒絕并且您的應(yīng)用程序已收到onPermissionsDenied回調(diào)后才有效。 否則，庫無法將永久拒絕與“尚未拒絕”情況區(qū)分開。

@Override
public void onPermissionsDenied(int requestCode, List<String> perms) {
    Log.d(TAG, "onPermissionsDenied:" + requestCode + ":" + perms.size());

    // 可選）檢查用戶是否拒絕了任何權(quán)限并選中了“永不再次詢問”。
    //這將顯示一個對話框，指導(dǎo)他們啟用應(yīng)用程序設(shè)置中的權(quán)限。
    if (EasyPermissions.somePermissionPermanentlyDenied(this, perms)) {
        new AppSettingsDialog.Builder(this).build().show();
    }
}

@Override
public void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);

    if (requestCode == AppSettingsDialog.DEFAULT_SETTINGS_REQ_CODE) {
        //用戶從應(yīng)用設(shè)置屏幕返回后，執(zhí)行一些操作，例如顯示Toast.
        Toast.makeText(this, R.string.returned_from_app_settings_to_activity, Toast.LENGTH_SHORT)
                .show();
    }
}

與對話框交互

如果要與基本對話框進(jìn)行交互，請實現(xiàn)EasyPermissions.RationaleCallbacks。

@Override
public void onRationaleAccepted(int requestCode) {
    // 請求權(quán)限被允許
    // ...
}

@Override
public void onRationaleDenied(int requestCode) {
    // 請求權(quán)限被拒絕
    // ...
}

基本原理回調(diào)不一定意味著權(quán)限更改。 要檢查這些內(nèi)容，請參見EasyPermissions.PermissionCallbacks。