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 版本信息
|
||
- 文件复制状态
|
||
- 编译过程输出
|
||
- 最终安装包信息
|
||
|
||
## 进一步优化
|
||
|
||
可以考虑添加以下功能：
|
||
- 数字签名支持
|
||
- 多语言支持
|
||
- 自定义安装选项
|
||
- 更新检查机制 |