# Flutter Windows 单文件 EXE 打包指南

## 🎯 目标
将 Flutter Windows 应用打包成单个可执行文件，便于分发和部署。

## 📋 当前状态

### 现有构建输出
```
build/windows/x64/runner/Release/
├── hostexecutor.exe      # 主程序
├── flutter_windows.dll   # Flutter 引擎
├── msvcp140.dll         # Visual C++ 运行时
├── vcruntime140.dll     # Visual C++ 运行时
├── vcruntime140_1.dll   # Visual C++ 运行时
└── data/                # 应用数据文件夹
    ├── app.so           # Dart 代码编译结果
    └── flutter_assets/   # 资源文件
```

### 问题分析
Flutter 默认构建会生成多个文件，因为：
1. **Flutter 引擎** (`flutter_windows.dll`) - 必须包含
2. **Visual C++ 运行时** - 系统依赖
3. **应用数据** (`data` 文件夹) - 包含资源和 Dart 代码

## 🔧 解决方案

### 方案一：使用 Enigma Virtual Box（推荐）

#### 步骤 1：下载安装
1. 下载 [Enigma Virtual Box](https://enigmaprotector.com/en/downloads.html)
2. 安装并运行

#### 步骤 2：打包配置
1. **主程序文件**: 选择 `build/windows/x64/runner/Release/hostexecutor.exe`
2. **添加文件夹**: 选择整个 `Release` 文件夹
3. **输出文件**: 设置输出路径和文件名
4. **文件选项**: 勾选"压缩文件"

#### 步骤 3：生成单文件
点击"Process"生成单个可执行文件。

### 方案二：使用 Inno Setup（安装程序）

#### 步骤 1：下载安装
1. 下载 [Inno Setup](https://jrsoftware.org/isinfo.php)
2. 安装并运行

#### 步骤 2：创建脚本
```ini
[Setup]
AppName=HostExecutor
AppVersion=1.0.0
DefaultDirName={autopf}\HostExecutor
OutputBaseFilename=HostExecutor_Setup

[Files]
Source: "build\windows\x64\runner\Release\*"; DestDir: "{app}"; Flags: ignoreversion recursesubdirs

[Icons]
Name: "{group}\HostExecutor"; Filename: "{app}\hostexecutor.exe"
```

#### 步骤 3：编译生成
编译脚本生成安装程序。

### 方案三：使用 Windows 自带工具（高级）

#### 使用 `dotnet publish`（需要 .NET 包装）
```bash
# 需要创建 .NET 包装器项目
dotnet publish -c Release -r win-x64 --self-contained true -p:PublishSingleFile=true
```

## 🚀 自动化脚本

### Enigma Virtual Box 自动化脚本
```powershell
# package_single_exe.ps1
$enigmaPath = "C:\Program Files\Enigma Virtual Box\enigmavb.exe"
$inputFile = "build\windows\x64\runner\Release\hostexecutor.exe"
$outputFile = "dist\HostExecutor_Single.exe"
$folderPath = "build\windows\x64\runner\Release"

& $enigmaPath /sf $inputFile /lf $outputFile /folder $folderPath /compress
```

## 📦 打包后文件结构

### 单文件输出
```
dist/
└── HostExecutor_Single.exe  # 单个可执行文件（50-100MB）
```

### 文件大小分析
- **原始文件**: 约 30-50MB
- **压缩后**: 约 25-40MB（取决于压缩率）
- **最终大小**: 50-100MB（包含所有依赖）

## ⚠️ 注意事项

### 运行时依赖
1. **Windows 版本**: Windows 10 版本 1903+ 或 Windows 11
2. **系统组件**: 确保目标系统有最新的 Windows 更新
3. **防病毒软件**: 单文件可能被误报，需要添加信任

### 性能影响
- **启动时间**: 单文件启动会稍慢（需要解压）
- **内存使用**: 运行时内存占用相同
- **文件大小**: 比多文件版本大约 10-20%

## 🎯 推荐方案

### 开发阶段
使用多文件版本，便于调试和更新。

### 分发阶段
使用 Enigma Virtual Box 创建单文件版本：
1. **简单易用** - 图形化界面
2. **压缩率高** - 有效减小文件大小
3. **兼容性好** - 支持所有 Windows 版本
4. **免费** - 个人和商业使用都免费

## 📋 下一步行动

1. **安装 Enigma Virtual Box**
2. **测试单文件打包**
3. **验证运行效果**
4. **创建自动化打包流程**

## 🔗 相关资源

- [Enigma Virtual Box 官网](https://enigmaprotector.com/en/downloads.html)
- [Inno Setup 官网](https://jrsoftware.org/isinfo.php)
- [Flutter Windows 文档](https://docs.flutter.dev/desktop)