40 lines
1.6 KiB
Markdown
40 lines
1.6 KiB
Markdown
# 构建镜像配置编辑器 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 版本。
|
|
|
|
## 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`。
|