easypermissions -- 谷歌权限管理框架

是什么？

EasyPermissions是一个包装器库，用于简化针对Android M或更高版本的基本系统权限逻辑。

引入

dependencies {
    //  AndroidX 的应用
    implementation 'pub.devrel:easypermissions:3.0.0'
 
    //  Android 
    implementation 'pub.devrel:easypermissions:2.0.1'
}

使用

基础

要开始使用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);

        // 将结果转发给 EasyPermissions
        EasyPermissions.onRequestPermissionsResult(requestCode, permissions, grantResults, this);
    }
}

请求权限

下面的示例显示了如何同时请求同时具有CAMERA和ACCESS_FINE_LOCATION权限的方法的权限。 有几件事要注意：

• 使用EasyPermissions＃hasPermissions（...）检查应用程序是否已具有所需的权限。 此方法可以将任意数量的权限作为其最终参数。
• 使用EasyPermissions＃requestPermissions请求权限。 此方法将请求系统权限，并在必要时显示提供的基本原理字符串。 提供的请求代码对于该请求应该是唯一的，并且该方法可以将任何数量的权限作为其最终参数。
• 使用AfterPermissionGranted注解。 这是可选的，但为方便起见而提供。 如果授予了给定请求中的所有权限，则将执行所有带有正确请求代码注释的方法（确保具有唯一的请求代码）。 带注释的方法必须为空并且没有输入参数（相反，可以使用onSaveInstanceState来保留被抑制参数的状态）。 这是为了简化在授予所有许可权后需要运行请求方法的常见流程。 也可以通过在onPermissionsGranted回调上添加逻辑来实现。

@AfterPermissionGranted(RC_CAMERA_AND_LOCATION)
private void methodRequiresTwoPermission() {
    String[] perms = {Manifest.permission.CAMERA, Manifest.permission.ACCESS_FINE_LOCATION};
    if (EasyPermissions.hasPermissions(this, perms)) {
        // 已经有权限，进行相关操作
        // ...
    } else {
        // 没有权限，进行权限请求
        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实现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);

        // 将结果转发给 EasyPermissions
        EasyPermissions.onRequestPermissionsResult(requestCode, permissions, grantResults, this);
    }

    @Override
    public void onPermissionsGranted(int requestCode, List list) {
        // 授予权限
        // ...
    }

    @Override
    public void onPermissionsDenied(int requestCode, List list) {
        // 请求权限被拒
        // ...
    }
}

拒绝权限的情况下

在某些情况下，如果没有某些权限，您的应用将无法正常运行。 如果用户使用“不再询问”选项拒绝这些权限，则您将无法从用户那里请求这些权限，因此必须在应用程序设置中进行更改。 您可以使用方法EasyPermissions.somePermissionPermanentlyDenied（...）在这种情况下向用户显示对话框，并将其定向到您应用的系统设置屏幕：

注意：由于Android框架权限API提供的信息的限制，somePermissionPermanentlyDenied方法仅在权限被拒绝并且您的应用程序已收到onPermissionsDenied回调后才有效。 否则，库无法将永久拒绝与“尚未拒绝”情况区分开。

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

    // 可选）检查用户是否拒绝了任何权限并选中了“永不再次询问”。
    //这将显示一个对话框，指导他们启用应用程序设置中的权限。
    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) {
        //用户从应用设置屏幕返回后，执行一些操作，例如显示Toast.
        Toast.makeText(this, R.string.returned_from_app_settings_to_activity, Toast.LENGTH_SHORT)
                .show();
    }
}

与对话框交互

如果要与基本对话框进行交互，请实现EasyPermissions.RationaleCallbacks。

@Override
public void onRationaleAccepted(int requestCode) {
    // 请求权限被允许
    // ...
}

@Override
public void onRationaleDenied(int requestCode) {
    // 请求权限被拒绝
    // ...
}

基本原理回调不一定意味着权限更改。 要检查这些内容，请参见EasyPermissions.PermissionCallbacks。