Android 11及以上授予文件管理权限

举报
福州司马懿 发表于 2022/12/06 17:34:06 2022/12/06
【摘要】 背景安卓11改变了此前安卓系统对于文件管理的规则,在安卓11上,文件读写变成了特殊权限。应用默认只能读写自己的目录/android/data/包名 gradle配置Android11系统对应用写入权限做了严格的限制。本文介绍如何获取文件读写权限。项目中 build.gradle 的targetSdkVersion >= 29 ,会出现读写问题当targetSdkVersion = 29,通...

背景

安卓11改变了此前安卓系统对于文件管理的规则,在安卓11上,文件读写变成了特殊权限。应用默认只能读写自己的目录/android/data/包名

gradle配置

Android11系统对应用写入权限做了严格的限制。本文介绍如何获取文件读写权限。

项目中 build.gradle 的targetSdkVersion >= 29 ,会出现读写问题

  • 当targetSdkVersion = 29,通过设置requestLegacyExternalStorage=“true”,还能解决
  • 当targetSdkVersion = 30后,需要申请所有文件权限才能获取到写入权限

为了能直接usb安装,gradle.properties 需要设置(否则,在安装时会报异常:-15)

android.injected.testOnly=false

AndroidManifest添加权限设置

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<!-- Android11额外添加 -->
<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE"
        tools:ignore="ScopedStorage" />

<application
	...
	android:requestLegacyExternalStorage="true"
	...
	>
...
</application>

语法说明

申请权限,主要用到如下4个函数

  1. 检查权限
int checkSelfPermission(String)
  1. 申请权限
void requestPermissions(int, String...)
  1. 是否应该显示请求权限的说明
boolean shouldShowRequestPermissionRationale(String)
  1. 处理权限结果回调
void onRequestPermissionsResult(int,String[],int[])

上述四个方法中,前三个方法在support-v4的ActivityCompat中都有,建议使用兼容库中的方法。最后一个方法是用户授权或者拒绝某个权限组时系统会回调Activity或者Fragment中的方法。

checkSelfPermission的返回值有如下两种

  1. 已拒绝 PackageManager.PERMISSION_DENIED
  2. 已授权 PackageManager.PERMISSION_GRANTED

动态权限申请

Android 6.0之上Android11以下申请权限

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {// 6.0
	String[] perms = {
			Manifest.permission.READ_EXTERNAL_STORAGE,
			Manifest.permission.WRITE_EXTERNAL_STORAGE,
			Manifest.permission.READ_PHONE_STATE};
	for (String p : perms) {
		int ret = ContextCompat.checkSelfPermission(activity, p);
		if (ret != PackageManager.PERMISSION_GRANTED) {
			//TODO 跳转到权限页,请求权限
			return;
		}
	}
}

Android11申请权限

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
    //判断是否有管理外部存储的权限
	if (!Environment.isExternalStorageManager()) {
		//TODO 跳转到权限页,请求权限
	}
}

跳转系统授权页面

跳转到“应用信息”页面

安卓默认只能跳转到 "应用信息"页面,但是国内手机厂商大多支持各自自定义的Intent,直接跳到应用程序权限页面

/**
 * 当前应用详情页面(在该页面单击权限,进入的是权限组页面)
 */
public static void goAppDetailsSettings(Context context) {
    Intent intent = new Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS);
    intent.setData(Uri.fromParts("package", context.getPackageName(), null));
    context.startActivity(intent);
}

图片.png

跳转到应用信息页面,页面包含如下内容

  1. 存储
  2. 电量
  3. 流量
  4. 通知
  5. 权限
  6. 默认打开

需要手动点击“权限”按钮,进入“应用权限”页面,然后开始设置相应的数据

图片.png

图片.png

跳转到“所有文件访问权限”

谷歌官方的安卓11在“应用权限”页面隐藏了对“存储”权限的设置(当然,很多国产机,即使到了安卓12,依旧支持原先的存储权限;但也存在部分不支持的,比如:OPPO Reno9 Pro+)

取而代之的是“所有文件访问权限”页面,该页面用来授予“所有文件的管理权限”,允许此应用读取、修改和删除此设备或任意已连接存储卷上的所有文件。如果您授予该权限,应用无需明确通知您即可访问文件

/**
 * 进入Android 11或更高版本的文件访问权限页面
 */
private void goManagerFileAccess(AppCompatActivity activity) {
    // Android 11 (Api 30)或更高版本的写文件权限需要特殊申请,需要动态申请管理所有文件的权限
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
        Intent appIntent = new Intent(Settings.ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION);
        appIntent.setData(Uri.parse("package:" + getPackageName()));
        //appIntent.setData(Uri.fromParts("package", activity.getPackageName(), null));
        try {
            activity.startActivity(appIntent);
        } catch (ActivityNotFoundException ex) {
            ex.printStackTrace();
            Intent allFileIntent = new Intent(Settings.ACTION_MANAGE_ALL_FILES_ACCESS_PERMISSION);
            activity.startActivity(allFileIntent);
        }
    }
}

这里面涉及到两个Settings

  1. 当前应用的文件访问权限:ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION
  2. 所有需要文件访问权限的应用:ACTION_MANAGE_ALL_FILES_ACCESS_PERMISSION

切记,不要在安卓11以下调用该Intent,会导致闪退

图片.png

测试存储权限是否授权

安卓11及以后,有如下几个函数判断是否赋予存储权限

  1. 老版读权限
ActivityCompat.checkSelfPermission(context, Manifest.permission.READ_EXTERNAL_STORAGE) == PackageManager.PERMISSION_GRANTED
  1. 老版写权限
ActivityCompat.checkSelfPermission(context, Manifest.permission.WRITE_EXTERNAL_STORAGE) == PackageManager.PERMISSION_GRANTED
  1. 安卓11新出的管理外置存储权限
ActivityCompat.checkSelfPermission(context, Manifest.permission.MANAGE_EXTERNAL_STORAGE) == PackageManager.PERMISSION_GRANTED
  1. 安卓11新出的判断是否是外置存储管理器
Environment.isExternalStorageManager()

具体实验(VIVO Y77,安卓12)

  1. 初始化状态
isExternalStorageManager => false
READ_EXTERNAL_STORAGE   => false
READ_EXTERNAL_STORAGE   => false
MANAGE_EXTERNAL_STORAGE  => false
  1. 仅在“应用权限”页面,打开存储权限中的“允许管理所有文件”
isExternalStorageManager => true
READ_EXTERNAL_STORAGE   => true
WRITE_EXTERNAL_STORAGE   => true
MANAGE_EXTERNAL_STORAGE  => false
  1. 仅在“应用权限”页面,打开存储权限中的“仅允许访问媒体文件”
isExternalStorageManager => false
READ_EXTERNAL_STORAGE   => true
WRITE_EXTERNAL_STORAGE   => true
MANAGE_EXTERNAL_STORAGE  => false
  1. 仅在“所有文件访问权限”页面,授予权限
isExternalStorageManager => true
READ_EXTERNAL_STORAGE   => false
WRITE_EXTERNAL_STORAGE   => false
MANAGE_EXTERNAL_STORAGE  => false

因此,可以得出如下结论

  1. 不要尝试判断 MANAGE_EXTERNAL_STORAGE 权限,因为其永远为false
  2. isExternalStorageManagerACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSIONACTION_MANAGE_ALL_FILES_ACCESS_PERMISSIONAPI,只能在安卓11及以上版本调用(低版本调用会闪退)
  3. “应用权限”页面,打开存储权限中的“允许管理所有文件”会使得isExternalStorageManager变为true;但反之在“所有文件访问权限”页面授予权限,并不会改变WRITE_EXTERNAL_STORAGE的允许情况

因此,为了兼容 安卓4.4-安卓12,在11以下,建议使用checkSelfPermission方法进行存储权限判断;而安卓11及以上使用Environment.isExternalStorageManager即可

【版权声明】本文为华为云社区用户原创内容,转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息, 否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。