如何让 Flutter 3.24 在 Windows 7 上运行？

我们最近在 RustDesk 中引入了 Flutter 3.24.5，结果程序无法在 Windows 7 上运行。为解决这个问题，我们尝试修改 Flutter Engine。

在 Windows 7 上运行 Flutter 3.24.5 的解决方案

Flutter 和 Dart 官方已经宣布，Dart 3.3 与 Flutter 3.19 是最后支持 Windows 7 和 8 的版本。因此，Flutter 3.24.5 无法直接在 Windows 7 上运行。要解决这个问题，需要撤销 Dart 中的部分更改以恢复 Windows 7 支持，具体如下。

相关链接：官方公告

1. 修复中文环境中的 Platform.localHostname 问题

Dart 原先使用 gethostname API，这会导致 Platform.localHostname 在中文环境中失败。为解决该问题，Dart 改用了仅在 Windows 8 及更高版本中提供的 GetHostNameW API。为了让 Flutter 在 Windows 7 上运行，需要撤销这项更改。请注意，撤销后会影响中文环境中的 Platform.localHostname 功能。

相关 Issue：Platform.localHostname fails on Chinese Windows

2. 恢复 Windows 7 的展开记录 API 兼容处理

Dart 此前针对 Windows 7 缺少 RtlAddGrowableFunctionTable API 做过兼容处理，但后来删除了这项修改。为了保持 Windows 7 兼容性，需要撤销删除该处理的提交。

相关 Commit：Remove Windows7 handling of unwinding records API

3. 修复 Windows 上目录相对符号链接失效的问题

Dart 曾修复 Windows 上目录相对符号链接无法工作的问题，并修改了 File::GetType 方法。但该修改使用了仅在 Windows 8 及更高版本中提供的 PathCchCombineEx API。为恢复 Windows 7 支持，也需要撤销这项修改。

相关 Commit：Fix a bug where relative symlinks to directories did not work on Windows

总结

要让 Flutter 3.24.5 在 Windows 7 上运行，需要撤销 Dart 中的几项关键修改。这些撤销操作会带来副作用，例如影响中文环境中的 Platform.localHostname，以及目录相对符号链接功能。但对于仍依赖 Windows 7 的用户，这是必要的步骤。

完整实现请参阅我们的 CI。

这里展示了如何在项目中应用修改后的引擎。