Todo: 修改因exe_token错误导致的不断重连问题
Todo: 修改打包中.bat打包文件与测试打包脚本不一致问题 New: 新增installer安装包环境搭建数据
This commit is contained in:
106
installer/README.md
Normal file
106
installer/README.md
Normal file
@@ -0,0 +1,106 @@
|
||||
# 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 版本信息
|
||||
- 文件复制状态
|
||||
- 编译过程输出
|
||||
- 最终安装包信息
|
||||
|
||||
## 进一步优化
|
||||
|
||||
可以考虑添加以下功能:
|
||||
- 数字签名支持
|
||||
- 多语言支持
|
||||
- 自定义安装选项
|
||||
- 更新检查机制
|
||||
Reference in New Issue
Block a user