TG-PlatformPlus/BUILD_README.md

GPCT-standalone 打包脚本

本项目包含多种打包方式，用于将 Python 应用程序打包为可执行文件和安装包。

打包方式

1. 批处理脚本 (build_package.bat)

适用场景: Windows 环境，简单快速打包

使用方法:

# 直接双击运行或在命令行执行
build_package.bat

功能:

• 自动激活虚拟环境
• 清理旧构建文件
• 执行 PyInstaller 打包
• 复制额外资源文件

---

2. Python 脚本 (build_package.py)

适用场景: 需要更多控制和自动化

使用方法:

# 使用系统 Python 运行
python build_package.py

# 或使用虚拟环境 Python
venv\Scripts\python.exe build_package.py

功能:

• 完整的构建流程控制
• 自动更新版本发布时间
• 支持 NSIS 安装包生成
• 构建结果验证

---

3. 手动打包步骤

如果需要手动控制打包过程：

# 1. 激活虚拟环境
venv\Scripts\activate.bat

# 2. 清理旧文件
rmdir /s /q dist build

# 3. 执行 PyInstaller
pyinstaller spec\GPCT-standalone.spec

# 4. 复制额外文件
xcopy /y dataFile\config.json dist\GPCT-standalone\_internal\dataFile\
xcopy /y dataFile\data.db dist\GPCT-standalone\_internal\dataFile\
xcopy /y Syunew3D_x64.dll dist\GPCT-standalone\_internal\
xcopy /y influxd.exe dist\GPCT-standalone\_internal\

# 5. 构建 NSIS 安装包 (可选)
"C:\Program Files (x86)\NSIS\makensis.exe" GPCT-standalone.nsi

---

文件说明

文件	说明
build_package.bat	Windows 批处理打包脚本
build_package.py	Python 自动化打包脚本
spec/GPCT-standalone.spec	PyInstaller 配置文件
GPCT-standalone.nsi	NSIS 安装包脚本

---

输出目录

打包完成后，文件将位于：

dist/
├── GPCT-standalone/              # 便携版文件夹
│   ├── GPCT-standalone.exe       # 主程序
│   ├── _internal/                # 依赖文件
│   │   ├── config.json
│   │   ├── data.db
│   │   ├── Syunew3D_x64.dll
│   │   └── ...
│   └── ...
└── GPCT-standalone-Setup.exe     # 安装包 (如果构建了 NSIS)

---

注意事项

1. 虚拟环境: 确保 venv 目录存在且包含所有依赖
2. PyInstaller: 需要安装 pip install pyinstaller
3. NSIS: 如需构建安装包，请安装 NSIS
4. 版本信息: 修改 version.json 更新版本号

---

依赖安装

如果虚拟环境需要更新：

venv\Scripts\activate.bat
pip install -r requirements.txt