You need to enable JavaScript to run this app. 运行在Android 10(API 29)时如何获取DIRECTORY_DOWNLOADS存储权限
优惠活动
大模型
产品
解决方案
定价
更多

运行在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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.20 12:54:03