如何在Flutter桌面应用中运行可执行文件及启动时调用实现

核心思路 #

Flutter桌面端可通过Dart原生dart:io库或第三方process_run包调用系统可执行文件，启动时自动调用只需在应用初始化阶段执行对应逻辑即可。

方法一：使用Dart原生dart:io库 #

1. 实现可执行文件调用函数 #

import 'dart:io';
import 'dart:convert';

Future<void> runTargetExecutable() async {
  // 根据平台设置可执行文件路径
  final String executablePath;
  if (Platform.isWindows) {
    // Windows路径示例，注意转义反斜杠
    executablePath = r'C:\Tools\my-tool.exe';
  } else if (Platform.isMacOS) {
    // macOS可执行文件路径示例
    executablePath = '/Applications/MyTool.app/Contents/MacOS/MyTool';
  } else if (Platform.isLinux) {
    // Linux可执行文件路径示例
    executablePath = '/usr/local/bin/my-tool';
  } else {
    print('当前平台不支持');
    return;
  }

  try {
    // 启动可执行文件（后台运行，不阻塞Flutter进程）
    final Process process = await Process.start(executablePath, []);

    // 可选：监听可执行文件的标准输出和错误输出
    process.stdout.transform(utf8.decoder).listen((output) {
      print('可执行文件输出: $output');
    });
    process.stderr.transform(utf8.decoder).listen((error) {
      print('可执行文件错误: $error');
    });

    // 可选：等待进程结束并获取退出码
    final int exitCode = await process.exitCode;
    print('可执行文件退出码: $exitCode');
  } catch (e) {
    print('调用可执行文件失败: $e');
  }
}

2. 启动时自动调用 #

在main函数中，可选择两种时机执行调用：

void main() async {
  // 方式1：先调用可执行文件，再启动Flutter应用（可能短暂阻塞UI初始化）
  await runTargetExecutable();
  runApp(const MyApp());

  // 方式2：先启动Flutter应用，UI初始化完成后再调用（避免阻塞）
  // WidgetsFlutterBinding.ensureInitialized();
  // runApp(const MyApp());
  // WidgetsBinding.instance.addPostFrameCallback((_) {
  //   runTargetExecutable();
  // });
}

方法二：使用第三方包process_run #

process_run封装了更简洁的API，支持跨平台路径处理和后台运行：

1. 添加依赖 #

在pubspec.yaml中加入：

dependencies:
  process_run: ^0.12.0

2. 实现调用逻辑 #

import 'package:process_run/process_run.dart';
import 'dart:io';

Future<void> runTargetExecutable() async {
  final String executablePath;
  if (Platform.isWindows) {
    executablePath = r'C:\Tools\my-tool.exe';
  } else {
    executablePath = '/path/to/your/executable';
  }

  try {
    // 直接运行可执行文件
    await run(executablePath);

    // 如需让可执行文件在Flutter关闭后继续运行，使用detached模式
    // await runExecutableArguments(executablePath, [], detached: true);
  } catch (e) {
    print('调用失败: $e');
  }
}

关键注意事项 #

• 路径处理：不同平台路径格式不同，可使用path包（import 'package:path/path.dart' as path;）统一处理路径拼接。
• 权限问题：确保可执行文件具备执行权限——macOS/Linux需执行chmod +x 可执行文件路径，Windows需保证用户有运行权限。
• 进程生命周期：默认情况下，Flutter应用关闭会终止其启动的子进程。如需让可执行文件独立运行，需使用平台特定方式（如Windows的CreateProcess、Linux/macOS的nohup）。
• 错误处理：必须添加try-catch捕获文件不存在、权限不足等异常，避免应用崩溃。

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