运行在Android 10(API 29)时如何获取DIRECTORY_DOWNLOADS存储权限
问题根因
你遇到的权限报错是Android 10(API 29)的分区存储特性导致的:
- API ≤28:只要申请
WRITE_EXTERNAL_STORAGE权限,就可以通过File API直接读写公共目录 - API =29:分区存储默认生效,即便有权限也无法直接通过File API访问公共目录,除非开启 legacy 兼容标识
- API ≥30:谷歌调整了公共目录访问规则,允许针对下载等公共目录写入应用自有文件,所以你现有代码在API30上可以正常运行
解决方案
提供两种适配方式,可根据你的需求二选一:
方案1:快速兼容方案(无需修改业务逻辑)
直接在AndroidManifest.xml的<application>节点添加属性即可,该属性仅对API29生效,更高版本系统会自动忽略,不影响其他版本运行:
<application <!-- 其他原有application属性,比如android:allowBackup、android:icon等 --> android:requestLegacyExternalStorage="true"> <!-- 其他原有四大组件配置 --> </application>
加完重新打包运行即可,原有业务代码完全不用修改,API29就能正常写入。
方案2:官方标准适配方案(长期兼容,无需legacy标识)
如果不想用临时兼容标识,可针对API29及以上版本改用MediaStore API写入公共下载目录,API≤28版本保留原有逻辑即可,Java代码示例如下:
// 生成fileName的原有逻辑保留,假设你已经得到fileName、要写入的内容、formatDesc变量 String toastText = "Failed to save file"; if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) { // API29及以上用MediaStore写入下载目录 ContentValues values = new ContentValues(); values.put(MediaStore.MediaColumns.DISPLAY_NAME, fileName); values.put(MediaStore.MediaColumns.MIME_TYPE, "text/plain"); values.put(MediaStore.MediaColumns.RELATIVE_PATH, Environment.DIRECTORY_DOWNLOADS); ContentResolver resolver = getContentResolver(); Uri uri = resolver.insert(MediaStore.Downloads.EXTERNAL_CONTENT_URI, values); if (uri != null) { try (OutputStream outputStream = resolver.openOutputStream(uri); BufferedWriter writer = new BufferedWriter(new OutputStreamWriter(outputStream))) { // 此处替换为你原来的输出格式化内容逻辑 writer.write("你要写入的文件内容"); toastText = "File saved as " + formatDesc; } catch (IOException e) { toastText += "\n" + e.getMessage(); } } } else { // API28及以下保留原有逻辑 File outFile = new File(Spine.fileSaveDir, fileName); try (BufferedWriter out = new BufferedWriter(new FileWriter(outFile), 1024)) { // 此处替换为你原来的输出格式化内容逻辑 out.write("你要写入的文件内容"); out.flush(); toastText = "File saved as " + formatDesc; } catch (IOException e) { toastText += "\n" + e.getMessage(); } } // 后续弹出toast的原有逻辑保留
额外说明
原有清单中的WRITE_EXTERNAL_STORAGE权限不用删除,保留给API≤28的设备使用即可,API29及以上该权限自动失效。
内容的提问来源于stack exchange,提问作者Jeff G
相关产品推荐
相关产品推荐

