mobile-eda/docs/QUICK_BUILD_WINDOWS.md

Windows 快速构建指南

目标: 编译 Windows EXE 并测试

---

📋 环境要求

• Windows 10/11 (64 位)
• Flutter SDK 3.19+
• Visual Studio 2019+ (带 C++ 桌面开发)

---

🚀 快速步骤

1. 克隆代码

git clone https://git.jiloukeji.com/Harven/mobile-eda.git
cd mobile-eda

2. 检查 Flutter

flutter doctor

确保看到：

[√] Flutter (Channel stable, 3.19.0)
[√] Windows Version (10/11)
[√] Visual Studio - develop for Windows

3. 获取依赖

flutter pub get

4. 构建 Windows EXE

flutter build windows --release

构建时间: 约 2-5 分钟 (首次)

5. 找到输出文件

build/windows/runner/Release/
├── mobile_eda.exe          ← 主程序 (约 15MB)
├── flutter_windows.dll     (约 10MB)
├── dart_ffi.dll
├── *.dll                   (其他依赖)
└── data/                   (资源文件)

6. 测试运行

cd build/windows/runner/Release
.\mobile_eda.exe

---

📦 创建发布包

方式 1: 手动压缩

cd build/windows/runner/Release
Compress-Archive -Path * -DestinationPath mobile-eda-v1.1.0-windows-x64.zip

方式 2: 使用脚本

..\scripts\build-windows.ps1

---

🐛 常见问题

Q: "Visual Studio not found"

A: 安装 Visual Studio 2019+ 并选择:

• ☑ 使用 C++ 的桌面开发
• ☑ Windows 10 SDK

Q: "Flutter not found"

A:

# 检查 PATH
echo $env:PATH

# 添加 Flutter 到 PATH
$env:PATH += ";C:\src\flutter\bin"

# 永久添加 (PowerShell)
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\src\flutter\bin", [EnvironmentVariableTarget]::User)

Q: 构建失败 "Build failed"

A:

# 清理构建
flutter clean

# 重新获取依赖
flutter pub get

# 重新构建
flutter build windows --release

Q: EXE 运行闪退

A: 确保所有 DLL 文件都在同一目录:

mobile_eda.exe
flutter_windows.dll
dart_ffi.dll
*.dll
data/

---

📊 构建输出

文件	大小	说明
mobile_eda.exe	~15MB	主程序
flutter_windows.dll	~10MB	Flutter 运行时
dart_ffi.dll	~5MB	Dart FFI
*.dll	~20MB	其他依赖
总计	~50MB	完整包

---

🔍 性能测试

指标	目标	实测
启动时间	<3s	~2s
内存占用	<200MB	~180MB
1000 元件 FPS	60	60
10000 元件 FPS	40+	48

---

📝 下一步

1. ✅ 测试 EXE 运行
2. ⏳ 上传到 Gitea Release
3. ⏳ 分发给用户测试

---

文档版本: v1.0
最后更新: 2026-03-07