Flutter文件目录访问插件open_dir_linux的使用

open_dir_linux

Linux实现的open_dir插件。

使用方法

此包是官方推荐的联邦插件，因此你只需要添加open_dir包即可。或者你可以直接添加此包来使用。

以下是一个完整的示例代码，展示如何在Flutter应用中使用open_dir_linux插件打开指定的文件夹。

示例代码

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:open_dir_linux/open_dir_linux.dart'; // 导入open_dir_linux插件

void main() {
  runApp(const MyApp()); // 运行应用
}

class MyApp extends StatefulWidget {
  const MyApp({super.key}); // 构造函数

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState(); // 创建状态类
}

class _MyAppState extends State<MyApp> {
  final _openDirPlugin = OpenDirLinux(); // 初始化插件实例

  // 控制器用于管理文本框输入
  final _tfDirPathController = TextEditingController();
  final _tfHighlightedFilenameController = TextEditingController();
  final _messengerKey = GlobalKey<ScaffoldMessengerState>(); // 用于显示消息

  [@override](/user/override)
  void dispose() {
    // 销毁时释放资源
    _tfDirPathController.dispose();
    _tfHighlightedFilenameController.dispose();
    super.dispose();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      scaffoldMessengerKey: _messengerKey, // 设置全局消息控制器
      home: Scaffold(
        appBar: AppBar(
          title: const Text('打开文件夹示例'), // 应用标题
        ),
        body: Center(
          child: Container(
            margin: const EdgeInsets.symmetric(horizontal: 16.0), // 添加边距
            child: Column(
              mainAxisAlignment: MainAxisAlignment.center, // 主轴居中
              children: [
                TextField(
                  controller: _tfDirPathController, // 绑定路径输入框
                  decoration: InputDecoration(
                    hintText: '输入文件夹路径', // 提示文本
                    hintStyle: TextStyle(color: Colors.grey.withOpacity(0.8)), // 提示文本样式
                  ),
                ),
                TextField(
                  controller: _tfHighlightedFilenameController, // 绑定高亮文件名输入框
                  decoration: InputDecoration(
                    hintText: '选择文件名（可选）', // 提示文本
                    hintStyle: TextStyle(color: Colors.grey.withOpacity(0.8)), // 提示文本样式
                  ),
                ),
                const SizedBox(height: 16.0), // 增加间距
                ElevatedButton(
                  onPressed: () => _openNativeDirectory( // 点击事件处理
                    path: _tfDirPathController.text,
                    highlightedFileName: _tfHighlightedFilenameController.text,
                  ),
                  child: const Padding(
                    padding: EdgeInsets.all(8.0),
                    child: Text('打开文件夹'), // 按钮文本
                  ),
                ),
              ],
            ),
          ),
        ),
      ),
    );
  }

  // 打开文件夹的方法
  _openNativeDirectory({
    required String path, // 文件夹路径
    String? highlightedFileName, // 高亮文件名
  }) async {
    try {
      final result = await _openDirPlugin.openNativeDir(
        path: path, // 路径参数
        highlightedFileName: highlightedFileName, // 高亮文件名参数
      );

      if (result != null && result) {
        // 如果成功打开文件夹且高亮文件名不为空
        if (highlightedFileName != null && highlightedFileName.isNotEmpty) {
          debugPrint(
            '已打开文件夹: $path 并选中文件名: $highlightedFileName', // 日志记录
          );
          return;
        }
        debugPrint('已打开文件夹: $path'); // 日志记录
      } else if (result == null || !result) {
        debugPrint('无法打开文件夹: $path'); // 日志记录
        if (mounted) {
          // 显示错误提示
          _messengerKey.currentState?.showSnackBar(SnackBar(
            duration: const Duration(seconds: 1),
            content: Text('无法打开文件夹: $path'),
          ));
        }
      }
    } on PlatformException catch (e) {
      debugPrint('打开文件夹失败: ${e.message}'); // 捕获平台异常
    }
  }
}