Android下如何将文件写入允许访问的外部目录？

需求：导出存档文件到应用私有目录（/Android/com.app/files）之外的用户易找路径，同时避免使用MANAGE_EXTERNAL_STORAGE权限导致Play Store审核失败。

当前实现细节：

• Dart代码：

if (!(await Permission.storage.request().isGranted)) return;

final String? exportPath = await FilePicker.platform.getDirectoryPath();

if (exportPath == null) return;

File exportFile = await File(
  "$exportPath/zs_tracker_data.sav",
).create(recursive: true);

• Gradle配置：

android.useAndroidX=true
android.enableJetifier=true

• AndroidManifest权限：

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>

• 编译SDK版本：33
• 报错信息：

Unhandled Exception: FileSystemException: Cannot create file, path = '/storage/emulated/0/Backups/zs_tracker_data.sav' (OS Error: Operation not permitted, errno = 1)

1. 直接写入公共Downloads目录（无需特殊权限） #

Android 13+允许应用直接写入公共Downloads目录，无需申请WRITE_EXTERNAL_STORAGE权限，这是最简便的方案：

步骤1：配置FileProvider（可选，用于文件可见性） #

如果需要让用户在系统文件管理器中直接看到导出的文件，在AndroidManifest.xml添加以下配置：

<application>
    <provider
        android:name="androidx.core.content.FileProvider"
        android:authorities="${applicationId}.fileprovider"
        android:exported="false"
        android:grantUriPermissions="true">
        <meta-data
            android:name="android.support.FILE_PROVIDER_PATHS"
            android:resource="@xml/file_paths" />
    </provider>
</application>

在res/xml目录创建file_paths.xml：

<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <external-downloads-path name="downloads" path="." />
</paths>

步骤2：修改Dart代码写入Downloads #

使用path_provider包获取Downloads目录路径（需先添加依赖：path_provider: ^2.1.1）：

import 'package:path_provider/path_provider.dart';

// 获取公共Downloads目录
final downloadsDir = await getDownloadsDirectory();
if (downloadsDir == null) return;

// 创建导出文件
final exportFile = File("${downloadsDir.path}/zs_tracker_data.sav");
await exportFile.create(recursive: true);

// 写入备份数据（替换为你的实际数据写入逻辑）
await exportFile.writeAsString(yourBackupContent);

// 提示用户操作完成
ScaffoldMessenger.of(context).showSnackBar(
  const SnackBar(content: Text("存档已导出到Downloads目录")),
);

2. 让用户自定义保存位置（通过SAF合规实现） #

如果需要支持用户选择任意保存路径，不要直接通过路径写入，而是使用系统文件选择器的保存对话框，通过SAF获取临时写入权限：

import 'package:file_picker/file_picker.dart';

// 调用系统保存对话框
final savePath = await FilePicker.platform.saveFile(
  dialogTitle: "选择存档保存位置",
  fileName: "zs_tracker_data.sav",
);

if (savePath != null) {
  // 通过Uri写入文件，无需额外权限
  final exportFile = File(savePath);
  await exportFile.writeAsString(yourBackupContent);
}

这种方式完全符合Android 13+的存储规则，无需申请特殊权限，Play Store审核无风险。

失败原因说明 #

Android 13+对存储权限做了严格限制：即使申请了WRITE_EXTERNAL_STORAGE，应用也无法直接写入公共目录（除了自身私有目录和Downloads等特定目录），必须通过SAF框架或者直接写入允许的公共目录。

内容的提问来源于stack exchange，提问作者Netsu