Flutter工具类插件saf_util的使用

saf_util 是一个用于处理存储访问框架（SAF）的实用工具包。这个插件主要用于文件和目录的选择、操作等，但不提供读写功能。如需读写功能，请参考 saf_stream。

使用方法

基本功能介绍

以下是 SafUtil 类的一些主要功能：

• 选择文件夹：pickDirectory
• 选择单个文件：pickFile
• 选择多个文件：pickFiles
• 列出目录内容：list
• 从URI获取文件或目录对象：documentFileFromUri
• 检查文件或目录是否存在：exists
• 删除文件或目录：delete
• 创建目录：mkdirp
• 获取子文件或目录：child
• 重命名文件或目录：rename
• 移动文件或目录：moveTo
• 复制文件或目录：copyTo
• 保存缩略图到本地文件：saveThumbnailToFile

示例代码

以下是一个完整的示例演示如何使用 saf_util 插件来选择文件夹和文件，并显示相关信息。

import 'package:flutter/material.dart';
import 'package:saf_util/saf_util.dart';

void main() {
  runApp(const MaterialApp(home: MyApp()));
}

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

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  final _safUtilPlugin = SafUtil();
  var _status = '';
  var _multipleFiles = false;
  late TextEditingController _controller;
  var _initialUri = '';

  @override
  void initState() {
    super.initState();
    _controller = TextEditingController();
  }

  @override
  void dispose() {
    _controller.dispose();
    super.dispose();
  }

  Future<void> _selectFolder() async {
    try {
      final dir = await _safUtilPlugin.pickDirectory(
          writePermission: true, initialUri: _initialUri);
      if (dir == null) {
        return;
      }
      setState(() {
        _status = 'Selected folder: ${dir.name}';
      });
    } catch (err) {
      setState(() {
        _status = 'Error: $err';
      });
    }
  }

  Future<void> _selectFiles() async {
    try {
      final files = await _safUtilPlugin.pickFiles(
          initialUri: _initialUri, multiple: _multipleFiles);
      if (files == null || files.isEmpty) {
        return;
      }
      String summary = 'You have selected ${files.length} files:\n';
      for (final file in files) {
        summary +=
            '${file.name}\nSize: ${file.length}\nUri:${file.uri}\n\n';
      }
      setState(() {
        _status = summary;
      });
    } catch (err) {
      setState(() {
        _status = 'Error: $err';
      });
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('Plugin example app'),
      ),
      body: Padding(
        padding: const EdgeInsets.all(16),
        child: Column(
          children: [
            ElevatedButton(
              onPressed: _selectFolder,
              child: const Text('Select a folder'),
            ),
            const SizedBox(height: 10),
            ElevatedButton(
              onPressed: _selectFiles,
              child: const Text('Select file/files'),
            ),
            const SizedBox(height: 10),
            Text(_status),
            const SizedBox(height: 10),
            Text('Initial URI'),
            const SizedBox(height: 10),
            TextField(
                controller: _controller,
                onChanged: (String value) {
                  setState(() {
                    _initialUri = value;
                  });
                }),
            CheckboxListTile(
                title: const Text('Pick multiple files'),
                value: _multipleFiles,
                onChanged: (value) {
                  setState(() {
                    _multipleFiles = value!;
                  });
                }),
            const SizedBox(height: 10),
          ],
        ),
      ),
    );
  }
}

解释

• 选择文件夹：点击“Select a folder”按钮后，会弹出文件夹选择对话框，用户可以选择一个文件夹。
• 选择文件：点击“Select file/files”按钮后，会弹出文件选择对话框，用户可以选择一个或多个文件（根据复选框的状态）。
• 显示状态：选择后的文件夹或文件信息会显示在界面上。

通过以上示例，您可以快速上手并使用 saf_util 插件进行文件和目录的操作。更多详细的功能和用法请参考插件文档和源码。