VWED_server/packaging

VWED任务系统打包模块

此模块提供了将VWED任务系统打包为Windows可执行文件的完整解决方案，包含动态配置功能。

🎯 推荐使用方式

集成版本（推荐）: 配置界面 + 服务启动合二为一，用户体验最佳！

cd packaging/scripts
build_integrated.bat

目录结构

packaging/
├── config_tool/                    # 配置工具
│   ├── config_manager.py           # GUI配置管理器
│   ├── integrated_config_gui.py    # 集成配置GUI界面
│   └── startup_loader.py           # 启动配置加载器
├── scripts/                        # 构建脚本
│   ├── build_integrated.bat        # 🌟 集成版构建脚本（推荐）
│   ├── build.py                    # Python构建脚本
│   ├── build.bat                   # 分离版构建脚本
│   └── test_integrated.bat         # 集成版测试脚本
├── resources/                      # 资源文件
│   └── README.md                   # 资源说明
├── integrated_launcher.py          # 🌟 集成启动器（推荐）
├── vwed_integrated.spec            # 🌟 集成版PyInstaller配置
├── main_with_config.py             # 带配置加载的主程序入口
├── vwed_task_main.spec             # 主程序PyInstaller配置
├── vwed_config_tool.spec           # 配置工具PyInstaller配置
├── requirements_build.txt          # 打包依赖
└── README.md                      # 本文件

✨ 功能特性

🎉 集成版本特点（推荐）

• 一键启动: 单个exe文件包含配置界面和服务启动
• 智能配置: 首次启动显示配置界面，后续直接启动服务
• 无缝体验: 配置完成后自动关闭配置窗口，直接进入服务
• 自动保存: 配置自动保存，无需重复设置

1. 动态配置管理

• GUI配置工具: 提供友好的图形界面配置数据库连接和API地址
• 配置文件管理: 自动保存/加载配置到 config.ini 文件
• 环境变量注入: 启动时自动设置环境变量
• 配置验证: 支持数据库连接测试

2. 可配置项

• 数据库配置:
  • username: MySQL用户名
  • password: MySQL密码
  • host: MySQL主机地址
• API配置:
  • tf_api_base_url: TF API基础URL

3. 打包输出

集成版本（推荐）:

• VWED_Task_System.exe - 包含配置界面和服务的单一可执行文件
• 启动VWED任务系统.bat - 便捷启动脚本
• 使用说明.txt - 详细使用指南

分离版本:

• vwed_task_main.exe - 核心任务系统服务
• vwed_config_tool.exe - GUI配置管理器
• 启动脚本 - 便捷的批处理启动脚本

使用方法

方法一：自动化构建（推荐）

1. 运行自动化构建:

   cd packaging/scripts
   build.bat
   

2. 等待构建完成，输出位于 dist/VWED_Task_Release/

方法二：手动构建

1. 安装打包依赖:

   pip install -r packaging/requirements_build.txt
   

2. 构建主程序:

   pyinstaller --clean packaging/vwed_task_main.spec
   

3. 构建配置工具:

   pyinstaller --clean packaging/vwed_config_tool.spec
   

4. 手动创建发布包:

   python packaging/scripts/build.py
   

方法三：快速构建

cd packaging/scripts
quick_build.bat

部署使用

构建完成后，在目标Windows服务器上：

1. 复制发布包 VWED_Task_Release 到目标位置

2. 首次配置:

   • 双击 启动配置工具.bat
   • 设置数据库连接参数
   • 设置API地址
   • 测试连接并保存配置

3. 启动服务:

   • 在配置工具中点击"启动服务"，或
   • 双击 直接启动服务.bat

4. 访问系统:

   • 浏览器访问 http://localhost:8000
   • API文档: http://localhost:8000/docs

5. 停止服务:

   • 双击 停止服务.bat

配置文件格式

系统使用 config.ini 文件存储配置:

[database]
username = root
password = root
host = localhost

[api]
tf_api_base_url = http://111.231.146.230:4080/jeecg-boot

环境变量映射

配置文件中的值会自动映射为环境变量:

• database.username → DB_USER
• database.password → DB_PASSWORD
• database.host → DB_HOST
• api.tf_api_base_url → TF_API_BASE_URL

故障排除

常见问题

1. 构建失败:

   • 确保Python环境正确安装
   • 检查依赖是否完整安装
   • 查看构建日志确定具体错误

2. 配置工具无法启动:

   • 确保目标系统支持tkinter
   • 检查权限设置

3. 主程序启动失败:

   • 检查数据库连接配置
   • 确保MySQL服务已启动
   • 查看应用日志

调试模式

如需调试，可以修改 vwed_task_main.spec 中的 console=True 以显示控制台输出。

技术细节

打包技术栈

• PyInstaller: Python应用打包
• tkinter: GUI配置界面
• configparser: 配置文件管理
• pathlib: 路径处理
• subprocess: 进程管理

架构设计

• 配置分离: 运行时配置与代码分离
• 模块化: 配置工具与主程序独立
• 热加载: 支持运行时配置更新
• 错误处理: 完善的异常处理和用户提示

版本历史

• v1.0: 初始版本，支持基本打包和配置功能