What:
系统权限申请库,之所以想整理一下,主要是因为项目中用到了。
事实上,我不太喜欢这个库。为什么呢?
因为这个库其实就是在原来的Android基础权限的机制上再单纯地的套一层,在使用上并没有方便多少,回调还是特别多。因此,有机会我更倾向于换成AddPermission这个库,这个库几乎可以说将回调砍掉了(代码上,实际里面的封装依旧会去处理回调。)从代码的角度出发,配置更加便捷,更加轻松,更加直观。找个时间,整理一下我对AddPermission进一步封装后的代码哈。
还有一款比较推荐的库是郭霖的PermissionX,它与上面两款的区别在于它是基于Fragment的,更轻量(上面两款是基于Activity的),但是,这款目前郭霖还在不断优化中,存在不稳定性。
好了,废话不多说,进入正题。
引入:
dependencies {
// AndroidX 的应用
implementation 'pub.devrel:easypermissions:3.0.0'
// Android
implementation 'pub.devrel:easypermissions:2.0.1'
}
How:
要开始使用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<String> list) {
// 授予权限
// ...
}
@Override
public void onPermissionsDenied(int requestCode, List<String> list) {
// 请求权限被拒
// ...
}
}
拒绝权限的情况下
在某些情况下,如果没有某些权限,您的应用将无法正常运行。 如果用户使用“不再询问”选项拒绝这些权限,则您将无法从用户那里请求这些权限,因此必须在应用程序设置中进行更改。 您可以使用方法EasyPermissions.somePermissionPermanentlyDenied(…)在这种情况下向用户显示对话框,并将其定向到您应用的系统设置屏幕:
注意:由于Android框架权限API提供的信息的限制,somePermissionPermanentlyDenied方法仅在权限被拒绝并且您的应用程序已收到onPermissionsDenied回调后才有效。 否则,库无法将永久拒绝与“尚未拒绝”情况区分开。
@Override
public void onPermissionsDenied(int requestCode, List<String> 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。