Flutter iOS下载文件夹文件保存及沙盒目录可见方案咨询

一、保存到iOS系统下载文件夹（适配iOS 16+） #

你之前配置的OpenDocumentsInPlace存在拼写错误，正确键应为LSSupportsOpeningDocumentsInPlace，这可能是文件未保存到目标目录的原因之一。以下是完整实现步骤：

1. Info.plist配置与权限 #

在ios/Runner/Info.plist中添加以下配置：

<key>UISupportsDocumentBrowser</key>
<true/>
<key>UIFileSharingEnabled</key>
<true/>
<key>LSSupportsOpeningDocumentsInPlace</key>
<true/>
<key>NSDocumentsFolderUsageDescription</key>
<string>需要访问文档文件夹以保存文件</string>
<key>NSDownloadsFolderUsageDescription</key>
<string>需要访问下载文件夹以保存文件</string>

2. Flutter核心代码实现 #

先在pubspec.yaml添加依赖：

dependencies:
  flutter:
    sdk: flutter
  path_provider: ^2.1.1
  permission_handler: ^10.2.0

然后实现保存逻辑：

import 'dart:io';
import 'package:flutter/material.dart';
import 'package:path_provider/path_provider.dart';
import 'package:permission_handler/permission_handler.dart';

class FileSaverPage extends StatefulWidget {
  const FileSaverPage({super.key});

  @override
  State<FileSaverPage> createState() => _FileSaverPageState();
}

class _FileSaverPageState extends State<FileSaverPage> {
  Future<void> saveToDownloads() async {
    // 请求文件访问权限
    final status = await Permission.storage.request();
    if (!status.isGranted) {
      ScaffoldMessenger.of(context).showSnackBar(
        const SnackBar(content: Text('需授予文件访问权限才能保存')),
      );
      return;
    }

    // 获取系统下载目录
    final downloadsDir = await getDownloadsDirectory();
    if (downloadsDir == null) {
      ScaffoldMessenger.of(context).showSnackBar(
        const SnackBar(content: Text('无法访问下载文件夹')),
      );
      return;
    }

    // 创建并写入文件
    final targetFile = File('${downloadsDir.path}/test_file.txt');
    await targetFile.writeAsString('这是保存到系统下载文件夹的内容');

    ScaffoldMessenger.of(context).showSnackBar(
      const SnackBar(content: Text('文件已保存到下载文件夹')),
    );
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('保存到下载文件夹')),
      body: Center(
        child: ElevatedButton(
          onPressed: saveToDownloads,
          child: const Text('保存测试文件'),
        ),
      ),
    );
  }
}

二、让应用沙盒目录对用户可见的替代方案 #

若直接保存到下载文件夹仍有问题，可通过以下配置让沙盒的Documents目录在「文件」APP中可见：

1. 确保Info.plist已添加：

<key>UIFileSharingEnabled</key>
<true/>
<key>LSSupportsOpeningDocumentsInPlace</key>
<true/>

2. 将文件保存到应用Documents目录：

final documentsDir = await getApplicationDocumentsDirectory();
final visibleFile = File('${documentsDir.path}/user_visible_file.txt');
await visibleFile.writeAsString('沙盒中可被用户查看的文件');

用户打开「文件」APP，在「浏览」标签下找到你的应用名称，即可查看该目录下的所有文件。

三、2023年可用的支持自定义路径的Flutter文件管理器推荐 #

• file_picker：支持自定义路径选择与保存，配合权限处理可访问系统目录，双平台兼容性强，是生态中使用率最高的文件操作工具之一。
• flutter_file_manager：轻量型文件管理器，支持自定义路径浏览、文件增删改操作，适配最新iOS版本。
• path_provider_ex：扩展了官方path_provider的功能，提供更多系统目录的访问接口，方便自定义路径的定位与操作。

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