Flutter文件选择插件file_picker_fork的使用

File Picker #

这是一个允许你使用原生文件浏览器选择单个或多个文件的包，并支持扩展名过滤。

目前支持的功能 #

• 使用操作系统默认的原生选择器
• 支持多种平台（移动设备、网页、桌面和Flutter GO）
• 使用自定义格式过滤选择文件——你可以提供一个文件扩展名列表（如pdf、svg、zip等）
• 从云文件中选择文件（如GDrive、Dropbox、iCloud）
• 单个或多个文件选择
• 不同的默认类型过滤（媒体、图像、视频、音频或任何类型）
• 选择目录
• 如果需要，可以立即将文件数据加载到内存中（Uint8List）
• 打开保存文件/另存为对话框（让用户指定文件保存的位置、目录和名称）

如果你有任何希望在这个包中看到的功能，请随时提出建议。🎉

兼容性图表 #

有关详细信息，请参阅 API部分的File Picker Wiki 或 pub.dev上的官方API引用。

文档 #

有关如何安装、设置和使用的详细信息，请参阅File Picker Wiki。

File Picker Wiki #

1. 安装
2. 设置
   • Android
   • iOS
   • Web
   • Desktop (go-flutter)
3. API
   • 过滤器
   • 参数
   • 方法
4. 常见问题解答
5. 故障排除

用法 #

快速简单的使用示例：

单个文件 #

FilePickerResult? result = await FilePicker.platform.pickFiles();
if (result != null) {
File file = File(result.files.single.path);
} else {
// 用户取消了选择
}

多个文件 #

FilePickerResult? result = await FilePicker.platform.pickFiles(allowMultiple: true);
if (result != null) {
List<File> files = result.paths.map((path) => File(path)).toList();
} else {
// 用户取消了选择
}

带扩展名过滤的多个文件 #

FilePickerResult? result = await FilePicker.platform.pickFiles(
  type: FileType.custom,
  allowedExtensions: ['jpg', 'pdf', 'doc'],
);

选择目录 #

String? selectedDirectory = await FilePicker.platform.getDirectoryPath();
if (selectedDirectory == null) {
// 用户取消了选择
}

保存文件/另存为对话框 #

String? outputFile = await FilePicker.platform.saveFile(
  dialogTitle: '请选择输出文件：',
  fileName: 'output-file.pdf',
);
if (outputFile == null) {
// 用户取消了选择
}

加载结果和文件详情 #

FilePickerResult? result = await FilePicker.platform.pickFiles();
if (result != null) {
PlatformFile file = result.files.first;
print(file.name); // 文件名
print(file.bytes); // 文件字节
print(file.size); // 文件大小
print(file.extension); // 文件扩展名
print(file.path); // 文件路径
} else {
// 用户取消了选择
}

使用Flutter Web选择并上传文件到Firebase Storage #

FilePickerResult? result = await FilePicker.platform.pickFiles();
if (result != null) {
Uint8List fileBytes = result.files.first.bytes;
String fileName = result.files.first.name;
// 上传文件
await FirebaseStorage.instance.ref(‘uploads/$fileName’).putData(fileBytes);
}

有关完整的用法细节，请参阅上面的Wiki。

示例应用 #

Android #

iOS #

MacOS #

Linux #

Windows #

开始使用 #

有关如何开始使用Flutter的详细信息，请查看我们的在线 文档。

有关如何编辑插件代码的详细信息，请查看 文档。

完整示例Demo

以下是一个完整的示例Demo，展示了如何使用file_picker_fork插件选择文件并在控制台中打印文件信息。

import 'package:flutter/material.dart';
import 'package:file_picker_example/src/file_picker_demo.dart';
import 'package:file_picker/file_picker.dart';

void main() => runApp(MyApp());

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('File Picker Demo'),
        ),
        body: Center(
          child: ElevatedButton(
            onPressed: () async {
              // 选择文件
              FilePickerResult? result = await FilePicker.platform.pickFiles();

              if (result != null) {
                // 获取文件信息
                PlatformFile file = result.files.first;

                // 打印文件信息
                print('文件名: ${file.name}');
                print('文件字节: ${file.bytes}');
                print('文件大小: ${file.size}');
                print('文件扩展名: ${file.extension}');
                print('文件路径: ${file.path}');
              } else {
                // 用户取消了选择
                print('用户取消了选择');
              }
            },
            child: Text('选择文件'),
          ),
        ),
      ),
    );
  }
}