2023年3月17日(软件工程日报)

访问公共空间

1．检查App是否开启了指定权限

权限检查需要调用ContextCompat的checkSelfPermission方法，该方法的第一个参数为活动实例，第

二个参数为待检查的权限名称，例如存储卡的写权限名为

Manifest.permission.WRITE_EXTERNAL_STORAGE。注意checkSelfPermission方法的返回值，当它为

PackageManager.PERMISSION_GRANTED时表示已经授权，否则就是未获授权。

2．请求系统弹窗，以便用户选择是否开启权限

一旦发现某个权限尚未开启，就得弹窗提示用户手工开启，这个弹窗不是开发者自己写的提醒对话框，

而是系统专门用于权限申请的对话框。调用ActivityCompat的requestPermissions方法，即可命令系统

自动弹出权限申请窗口，该方法的第一个参数为活动实例，第二个参数为待申请的权限名称数组，第三

个参数为本次操作的请求代码。

3．判断用户的权限选择结果

然而上面第二步的requestPermissions方法没有返回值，那怎么判断用户到底选了开启权限还是拒绝权

限呢？其实活动页面提供了权限选择的回调方法onRequestPermissionsResult，如果当前页面请求弹出

权限申请窗口，那么该页面的Java代码必须重写onRequestPermissionsResult方法，并在该方法内部处

理用户的权限选择结果。

具体到编码实现上，前两步的权限校验和请求弹窗可以合并到一块，先调用checkSelfPermission方法检

查某个权限是否已经开启，如果没有开启再调用requestPermissions方法请求系统弹窗。合并之后的检

查方法代码示例如下，此处代码支持一次检查一个权限，也支持一次检查多个权限：

（完整代码见chapter07\src\main\java\com\example\chapter07\util\PermissionUtil.java）

// 检查某个权限。返回true表示已启用该权限，返回false表示未启用该权限

public static boolean checkPermission(Activity act, String permission, int

requestCode) {

return checkPermission(act, new String[]{permission}, requestCode);

}

// 检查多个权限。返回true表示已完全启用权限，返回false表示未完全启用权限

public static boolean checkPermission(Activity act, String[] permissions, int

requestCode) {

boolean result = true;

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {

int check = PackageManager.PERMISSION_GRANTED;

// 通过权限数组检查是否都开启了这些权限

for (String permission : permissions) {

check = ContextCompat.checkSelfPermission(act, permission);

if (check != PackageManager.PERMISSION_GRANTED) {

break; // 有个权限没有开启，就跳出循环

}

}

if (check != PackageManager.PERMISSION_GRANTED) {

// 未开启该权限，则请求系统弹窗，好让用户选择是否立即开启权限

ActivityCompat.requestPermissions(act, permissions, requestCode);

result = false;

}

}

return result;

}注意到上面代码有判断安卓版本号，只有系统版本大于Android 6.0（版本代号为M），才执行后续的权

限校验操作。这是因为从Android 6.0开始引入了运行时权限机制，在Android 6.0之前，只要App在

AndroidManifest.xml中添加了权限配置，则系统会自动给App开启相关权限；但在Android 6.0之后，

即便事先添加了权限配置，系统也不会自动开启权限，而要开发者在App运行时判断权限的开关情况，

再据此动态申请未获授权的权限。

回到活动页面代码，一方面增加权限校验入口，比如点击某个按钮后触发权限检查操作，其中

Manifest.permission.WRITE_EXTERNAL_STORAGE表示存储卡权限，入口代码如下：

（完整代码见chapter07\src\main\java\com\example\chapter07\MainActivity.java）

if (v.getId() == R.id.btn_file_write) {

if (PermissionUtil.checkPermission(this,

Manifest.permission.WRITE_EXTERNAL_STORAGE, R.id.btn_file_write % 65536)) {

startActivity(new Intent(this, FileWriteActivity.class));

}

}

另一方面还要重写活动的onRequestPermissionsResult方法，在方法内部校验用户的选择结果，若用户

同意授权，就执行后续业务；若用户拒绝授权，只能提示用户无法开展后续业务了。重写后的方法代码

如下所示：

@Override

public void onRequestPermissionsResult(int requestCode, String[] permissions,

int[] grantResults) {

super.onRequestPermissionsResult(requestCode, permissions, grantResults);

// requestCode不能为负数，也不能大于2的16次方即65536

if (requestCode == R.id.btn_file_write % 65536) {

if (PermissionUtil.checkGrant(grantResults)) { // 用户选择了同意授权

startActivity(new Intent(this, FileWriteActivity.class));

} else {

ToastUtil.show(this, "需要允许存储卡权限才能写入公共空间噢");

}

}

}

以上代码为了简化逻辑，将结果校验操作封装为PermissionUtil的checkGrant方法，该方法遍历授权结

果数组，依次检查每个权限是否都得到授权了。详细的方法代码如下所示：

// 检查权限结果数组，返回true表示都已经获得授权。返回false表示至少有一个未获得授权

public static boolean checkGrant(int[] grantResults) {

boolean result = true;

if (grantResults != null) {

for (int grant : grantResults) { // 遍历权限结果数组中的每条选择结果

if (grant != PackageManager.PERMISSION_GRANTED) { // 未获得授权

result = false;

}

}

} else {

result = false;

}

return result;

}代码都改好后，运行测试App，由于一开始App默认未开启存储卡权限，因此点击按钮btn_file_write触

发了权限校验操作，弹出如图7-4所示的存储卡权限申请窗口。

点击弹窗上的“始终允许”，表示同意赋予存储卡读写权限，然后系统自动给App开启了存储卡权限，并执

行后续处理逻辑，也就是跳到了FileWriteActivity页面，在该页面即可访问公共空间的文件了。但在

Android 10系统中，即使授权通过，App仍然无法访问公共空间，这是因为Android 10默认开启沙箱模

式，不允许直接使用公共空间的文件路径，此时要修改AndroidManifest.xml，给application节点添加

如下的requestLegacyExternalStorage属性：

android:requestLegacyExternalStorage="true"

从Android 11开始，为了让应用升级时也能正常访问公共空间，还得修改AndroidManifest.xml，给

application节点添加如下的preserveLegacyExternalStorage属性，表示暂时关闭沙箱模式：

android:preserveLegacyExternalStorage="true"