fix(flash-gui): 窗口构建期隐藏改为延迟显示, 修复双击'闪退'; 打包改 onedir 提速
This commit is contained in:
+15
-6
@@ -31,19 +31,27 @@
|
||||
1. 打开 [Releases 页面](https://gitea.hulk.wang/hulk/gd32e230f8_firmware_merge_tool/releases),
|
||||
取最新的 `DAPLinkFlash-vX.Y.Z-win64.zip`;
|
||||
2. 解压到**任意可写目录**(配置 `flash_gui_settings.json` 写在 exe 旁边);
|
||||
3. 双击 `DAPLinkFlash.exe`。首次启动比脚本慢一两秒(onefile 解压),属正常现象。
|
||||
3. 进入解压出的 `DAPLinkFlash` 文件夹,双击 `DAPLinkFlash.exe`。
|
||||
目录版(onedir)无临时解压等待,启动接近秒开。
|
||||
|
||||
包内包含:
|
||||
|
||||
```
|
||||
DAPLinkFlash/
|
||||
├── DAPLinkFlash.exe 主程序(单文件自包含)
|
||||
├── DAPLinkFlash.exe 主程序(启动器)
|
||||
├── _internal/ 运行库(PyInstaller onedir, 须与 exe 同目录)
|
||||
├── toolchain/openocd/ 内置 OpenOCD(GUI 自动定位)
|
||||
│ ├── bin/openocd.exe + libftdi1.dll / libusb-1.0.dll
|
||||
│ └── openocd/scripts/ interface / target 配置脚本
|
||||
└── README.md 本说明
|
||||
```
|
||||
|
||||
> **SmartScreen 拦截("Windows 已保护你的电脑")**:exe 未做代码签名,
|
||||
> 浏览器下载的压缩包带"来自网络"标记。任选其一绕过:
|
||||
> ① 点"更多信息 → 仍要运行"(每台电脑每个文件仅一次);
|
||||
> ② 下载后**先右键 zip → 属性 → 勾选"解除锁定"→ 确定**,再解压,包内所有文件都不会再拦;
|
||||
> ③ 用 7-Zip / WinRAR 解压(不继承网络标记)。
|
||||
|
||||
## 3. GUI 使用
|
||||
|
||||
主窗口为单列仪表盘,补齐/拼接经顶栏按钮弹出独立窗口:
|
||||
@@ -114,8 +122,7 @@ FlashTool/
|
||||
│ ├── publish_gitea.py # 上传到 Gitea Release
|
||||
│ └── logos/ # 图标源(make_ico.py + png/ico)
|
||||
├── release/ # 构建与发布产物(机器生成区, 不手改/不入库)
|
||||
│ ├── DAPLinkFlash.exe # 打包单文件版
|
||||
│ ├── toolchain/openocd/ # package_release.py 复制的内置工具链
|
||||
│ ├── DAPLinkFlash/ # onedir 程序目录: exe + _internal/ + toolchain/
|
||||
│ └── *.zip # 发布包(上传 Gitea Release)
|
||||
├── toolchain/openocd/ # (可选) vendor 进仓库的工具链, 不入库
|
||||
├── start_flash_gui.bat # 源码模式双击启动器
|
||||
@@ -132,8 +139,8 @@ OpenOCD 用本机安装(默认找 `D:/toolchain/openocd`)或先跑一次
|
||||
```powershell
|
||||
cd src
|
||||
python logos/make_ico.py # (可选) 改图标后重新生成 png/ico, 需 Pillow
|
||||
python build_exe.py # 打包 → ../release/DAPLinkFlash.exe(约 19MB;
|
||||
# 自动装 PyInstaller, CTk 主题数据自动收集)
|
||||
python build_exe.py # 打包 → ../release/DAPLinkFlash/(onedir 目录版,
|
||||
# 启动秒开; 自动装 PyInstaller, CTk 主题数据自动收集)
|
||||
python build_exe.py --debug # 额外出一个带控制台的调试变体(命令行模式可见输出)
|
||||
python package_release.py 0.1.0 # 组装 release/DAPLinkFlash-v0.1.0-win64.zip
|
||||
# 含内置 OpenOCD 工具链(来源见脚本说明)
|
||||
@@ -145,6 +152,8 @@ python publish_gitea.py DAPLinkFlash-v0.1.0-win64.zip --insecure
|
||||
|
||||
## 7. 注意事项 / FAQ
|
||||
|
||||
- **"Windows 已保护你的电脑"(SmartScreen)**:exe 无代码签名所致,
|
||||
处理见 §2 的三种绕过方式;要彻底消除需购买代码签名证书对 exe 签名;
|
||||
- **"找不到 OpenOCD"**:点"自动定位";发布包用户确认解压后 `toolchain/openocd/`
|
||||
目录和 exe 在一起;
|
||||
- **烧录失败排查**:①"检测设备"先验链路;② 探针序列号留空可排除序列号问题;
|
||||
|
||||
Reference in New Issue
Block a user