106 lines
2.6 KiB
Markdown
106 lines
2.6 KiB
Markdown
|
# GUI 安装包构建工具
|
|||
|
|
|
|||
|
|
这个目录包含了使用 NSIS 构建 Windows 安装包的完整解决方案。
|
|||
|
|
|
|||
|
|
## 目录结构
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
installer/
|
|||
|
|
├── build_installer.py # 主要的构建脚本
|
|||
|
|
├── installer.nsi # 自动生成的 NSIS 脚本
|
|||
|
|
├── assets/ # 安装包资源文件
|
|||
|
|
│ ├── icon.png # 应用程序图标
|
|||
|
|
│ └── license.txt # 软件许可协议
|
|||
|
|
└── output/ # 生成的安装包输出目录
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 使用方法
|
|||
|
|
|
|||
|
|
### 方法一：使用批处理脚本（推荐）
|
|||
|
|
```bash
|
|||
|
|
# 在 GUI_main 目录下运行
|
|||
|
|
build_installer.bat
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 方法二：直接运行Python脚本
|
|||
|
|
```bash
|
|||
|
|
# 在 GUI_main/installer 目录下运行
|
|||
|
|
python build_installer.py
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 前提条件
|
|||
|
|
|
|||
|
|
1. **NSIS 安装**
|
|||
|
|
- 下载地址：https://nsis.sourceforge.io/Download
|
|||
|
|
- 安装后确保 `makensis` 命令在 PATH 中
|
|||
|
|
|
|||
|
|
2. **应用程序构建**
|
|||
|
|
- 必须先运行 `build_production.py` 构建应用程序
|
|||
|
|
- 确保 `dist/MultiPlatformGUI/` 目录存在
|
|||
|
|
|
|||
|
|
## 构建流程
|
|||
|
|
|
|||
|
|
1. **环境检查**：验证 NSIS 安装和应用程序构建
|
|||
|
|
2. **准备资源**：复制图标文件和创建许可证
|
|||
|
|
3. **生成脚本**：自动生成 NSIS 安装脚本
|
|||
|
|
4. **编译安装包**：使用 makensis 编译最终的安装程序
|
|||
|
|
|
|||
|
|
## 输出结果
|
|||
|
|
|
|||
|
|
安装包将生成在 `installer/output/` 目录下，文件名格式：
|
|||
|
|
```
|
|||
|
|
ShuiDi_AI_Assistant_Setup_1.0.0_YYYYMMDD_HHMMSS.exe
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 安装包功能
|
|||
|
|
|
|||
|
|
- ✅ 完整的中文界面
|
|||
|
|
- ✅ 自动创建开始菜单快捷方式
|
|||
|
|
- ✅ 自动创建桌面快捷方式
|
|||
|
|
- ✅ 注册表集成
|
|||
|
|
- ✅ 完整的卸载功能
|
|||
|
|
- ✅ 版本信息显示
|
|||
|
|
|
|||
|
|
## 自定义配置
|
|||
|
|
|
|||
|
|
可以修改 `build_installer.py` 中的以下配置：
|
|||
|
|
|
|||
|
|
```python
|
|||
|
|
# 应用程序信息
|
|||
|
|
self.app_name = "水滴AI客服智能助手"
|
|||
|
|
self.app_name_en = "ShuiDi AI Assistant"
|
|||
|
|
self.app_version = "1.0.0"
|
|||
|
|
self.app_publisher = "水滴科技"
|
|||
|
|
self.app_url = "https://www.shuidi.tech"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 故障排除
|
|||
|
|
|
|||
|
|
### 常见问题
|
|||
|
|
|
|||
|
|
1. **找不到 makensis 命令**
|
|||
|
|
- 确保 NSIS 已正确安装
|
|||
|
|
- 将 NSIS 安装目录添加到 PATH 环境变量
|
|||
|
|
|
|||
|
|
2. **找不到 dist 目录**
|
|||
|
|
- 先运行 `build_production.py` 构建应用程序
|
|||
|
|
|
|||
|
|
3. **图标文件问题**
|
|||
|
|
- 确保 `static/` 目录下有图标文件
|
|||
|
|
- 建议准备 ICO 格式的图标文件
|
|||
|
|
|
|||
|
|
### 日志和调试
|
|||
|
|
|
|||
|
|
构建过程中的详细信息会在控制台显示，包括：
|
|||
|
|
- NSIS 版本信息
|
|||
|
|
- 文件复制状态
|
|||
|
|
- 编译过程输出
|
|||
|
|
- 最终安装包信息
|
|||
|
|
|
|||
|
|
## 进一步优化
|
|||
|
|
|
|||
|
|
可以考虑添加以下功能：
|
|||
|
|
- 数字签名支持
|
|||
|
|
- 多语言支持
|
|||
|
|
- 自定义安装选项
|
|||
|
|
- 更新检查机制
|