119 lines
2.6 KiB
Markdown
119 lines
2.6 KiB
Markdown
# GPCT-standalone 打包脚本
|
|
|
|
本项目包含多种打包方式，用于将 Python 应用程序打包为可执行文件和安装包。
|
|
|
|
## 打包方式
|
|
|
|
### 1. 批处理脚本 (build_package.bat)
|
|
|
|
**适用场景**: Windows 环境，简单快速打包
|
|
|
|
**使用方法**:
|
|
```batch
|
|
# 直接双击运行或在命令行执行
|
|
build_package.bat
|
|
```
|
|
|
|
**功能**:
|
|
- 自动激活虚拟环境
|
|
- 清理旧构建文件
|
|
- 执行 PyInstaller 打包
|
|
- 复制额外资源文件
|
|
|
|
---
|
|
|
|
### 2. Python 脚本 (build_package.py)
|
|
|
|
**适用场景**: 需要更多控制和自动化
|
|
|
|
**使用方法**:
|
|
```bash
|
|
# 使用系统 Python 运行
|
|
python build_package.py
|
|
|
|
# 或使用虚拟环境 Python
|
|
venv\Scripts\python.exe build_package.py
|
|
```
|
|
|
|
**功能**:
|
|
- 完整的构建流程控制
|
|
- 自动更新版本发布时间
|
|
- 支持 NSIS 安装包生成
|
|
- 构建结果验证
|
|
|
|
---
|
|
|
|
### 3. 手动打包步骤
|
|
|
|
如果需要手动控制打包过程：
|
|
|
|
```bash
|
|
# 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](https://nsis.sourceforge.io/)
|
|
4. **版本信息**: 修改 `version.json` 更新版本号
|
|
|
|
---
|
|
|
|
## 依赖安装
|
|
|
|
如果虚拟环境需要更新：
|
|
|
|
```bash
|
|
venv\Scripts\activate.bat
|
|
pip install -r requirements.txt
|
|
```
|