94 lines
1.7 KiB
Markdown
94 lines
1.7 KiB
Markdown
# 发布说明
|
||
|
||
## 版本入口
|
||
|
||
软件版本统一维护在 `app_version.py`：
|
||
|
||
- `APP_NAME`：软件名称
|
||
- `APP_VERSION`：软件发布版本
|
||
|
||
发布新版本时，优先修改这里，不要直接改界面标题字符串。
|
||
|
||
## 版本规则
|
||
|
||
建议使用语义化版本：`主版本.次版本.修订号`
|
||
|
||
- `1.0.0`：首个正式版
|
||
- `1.1.0`：兼容性新功能
|
||
- `1.1.1`：问题修复
|
||
- `2.0.0`：不兼容变更
|
||
|
||
## Git 管理建议
|
||
|
||
- `main`：始终保持可发布状态
|
||
- 功能开发使用独立分支
|
||
- 每次发布打 Git Tag，例如 `v1.1.0`
|
||
|
||
建议命令：
|
||
|
||
```powershell
|
||
git checkout main
|
||
git pull
|
||
git checkout -b feature/xxx
|
||
```
|
||
|
||
完成功能后：
|
||
|
||
```powershell
|
||
git add .
|
||
git commit -m "feat: xxx"
|
||
git checkout main
|
||
git merge --no-ff feature/xxx
|
||
```
|
||
|
||
发布时：
|
||
|
||
```powershell
|
||
git add app_version.py RELEASE.md
|
||
git commit -m "release: v1.1.0"
|
||
git tag v1.1.0
|
||
git push
|
||
git push origin v1.1.0
|
||
```
|
||
|
||
## 打包流程
|
||
|
||
当前打包入口：`pqAutomationApp.spec`
|
||
|
||
推荐发布步骤：
|
||
|
||
1. 修改 `app_version.py` 中的 `APP_VERSION`
|
||
2. 更新本文件中的变更说明
|
||
3. 提交代码并打 Tag
|
||
4. 执行打包命令
|
||
5. 将 `dist/pqAutomationApp` 复制为带版本号的发布目录
|
||
|
||
打包命令：
|
||
|
||
```powershell
|
||
pyinstaller pqAutomationApp.spec
|
||
```
|
||
|
||
建议发布目录命名：
|
||
|
||
- `PQAutomationApp_v1.1.0`
|
||
- `PQAutomationApp_v1.1.0_20260416`
|
||
|
||
## 每次发布前检查
|
||
|
||
1. 版本号是否已更新
|
||
2. 关键功能是否回归测试
|
||
3. `dist/` 和 `build/` 是否未提交到 Git
|
||
4. 发布说明是否已更新
|
||
5. Tag 是否与版本号一致
|
||
|
||
## 变更记录模板
|
||
|
||
每次发布可按下面格式补充：
|
||
|
||
### v0.1.0
|
||
|
||
- 首次建立版本发布机制
|
||
- 软件标题显示版本号
|
||
- 增加 `.gitignore`
|
||
- 增加发布流程文档 |