# 构建镜像配置编辑器 2.0.0

源码使用 Python 3 和 PySide6，不依赖本项目其他目录。支持 Python 3.10–3.14，构建依赖已在 `requirements-build.txt` 锁定。

以下命令均在本文件所在的 `发布更新相关/镜像编辑器/编辑器源代码/` 目录执行。

## Windows 10/11 x64

```powershell
.\build_windows.ps1
```

脚本创建隔离构建环境、运行单元测试，再使用 PyInstaller 生成单 EXE，并更新 `../编辑器程序/` 的版本和 SHA-256。发布后的电脑不需要安装 Python、.NET 或 Qt。
已有锁定依赖的 venv 时可传入 `-BuildEnvironment "<venv路径>"`，脚本会拒绝错误的 PySide6/PyInstaller 版本。

本项目已把专用构建环境从全局工具目录迁入仓库内被忽略的本机测试目录。先按 [本机环境说明](../../../测试相关资料/如何测试/本机测试环境/README.md) 在仓库根运行 `local_env.py setup image-editor`，再从本目录调用 `build_windows.ps1 -BuildEnvironment "../../../测试相关资料/如何测试/本机测试环境/.local/image-editor/venv"`。环境及 wheel 不提交，复建入口、依赖版本与校验值跟踪维护；更换电脑或工作区位置须重建 venv。本次整理不重新发布编辑器 EXE。

## macOS

必须在 macOS 上本地构建，PyInstaller 不是跨平台编译器：

```sh
chmod +x ./build_macos.sh
./build_macos.sh
```

本项目未交付或验收 macOS 产物；对外分发 `.app` 时还应由分发者完成 Apple 签名和公证。命令行功能位于同一源码入口；若需在终端直接查看标准输出，将 macOS 构建参数的 `--windowed` 改为 `--console`。

## 源码运行与命令行

```powershell
$env:PYTHONPATH = ".\src"
python .\editor_main.py
python .\editor_main.py --validate "<镜像.img>"
python .\editor_main.py --apply "<原镜像.img>" "<配置.json>" "<新镜像.img>"
python -m unittest discover -s .\tests -v
```

编辑器只修改 IMG 内 FAT16 启动分区的固定双槽配置区，不负责向 TF 卡写入镜像。源码、构建物和日志不得内置发布密码或读取项目凭据文件。

第三方软件声明见 `THIRD_PARTY_NOTICES.md`。