145 lines
2.7 KiB
Markdown
145 lines
2.7 KiB
Markdown
# 一力三期BMS - 故事AI导演工作台 打包指南
|
||
|
||
## 快速打包
|
||
|
||
双击运行 `build-electron.bat`，等待完成即可。
|
||
|
||
## 打包步骤详解
|
||
|
||
### 1. 环境准备
|
||
|
||
确保已安装：
|
||
- Node.js 16+（下载地址：https://nodejs.org）
|
||
- npm（随Node.js一起安装）
|
||
|
||
### 2. 安装依赖
|
||
|
||
```bash
|
||
npm install
|
||
```
|
||
|
||
### 3. 构建前端
|
||
|
||
```bash
|
||
npm run build
|
||
```
|
||
|
||
### 4. 打包exe
|
||
|
||
```bash
|
||
npm run electron:build:win
|
||
```
|
||
|
||
### 5. 查看结果
|
||
|
||
打包完成后，在 `release` 目录找到：
|
||
- `故事AI导演工作台 Setup 1.0.0.exe`（安装包）
|
||
|
||
## 给用户使用
|
||
|
||
用户只需：
|
||
1. 双击安装包
|
||
2. 按提示安装（可自定义安装目录）
|
||
3. 桌面出现快捷方式
|
||
4. 双击打开即可使用
|
||
|
||
## 应用特性
|
||
|
||
- ✅ 无需安装任何运行时
|
||
- ✅ 桌面原生窗口体验
|
||
- ✅ 自动创建桌面快捷方式
|
||
- ✅ 支持自定义安装目录
|
||
- ✅ 支持开始菜单快捷方式
|
||
|
||
## 自定义配置
|
||
|
||
### 修改窗口大小
|
||
|
||
编辑 `electron/main.js`：
|
||
```javascript
|
||
mainWindow = new BrowserWindow({
|
||
width: 1400, // 修改宽度
|
||
height: 900, // 修改高度
|
||
// ...
|
||
});
|
||
```
|
||
|
||
### 修改应用名称
|
||
|
||
编辑 `package.json`：
|
||
```json
|
||
{
|
||
"build": {
|
||
"productName": "你的应用名称",
|
||
// ...
|
||
}
|
||
}
|
||
```
|
||
|
||
### 修改应用图标
|
||
|
||
1. 准备一个 256x256 的 PNG 图标
|
||
2. 重命名为 `icon.png`
|
||
3. 放到 `public` 目录
|
||
4. 重新打包
|
||
|
||
## 常见问题
|
||
|
||
### Q: 打包失败怎么办？
|
||
|
||
A: 尝试以下步骤：
|
||
1. 删除 `node_modules` 文件夹
|
||
2. 删除 `package-lock.json` 文件
|
||
3. 重新运行 `npm install`
|
||
4. 再次打包
|
||
|
||
### Q: exe文件太大？
|
||
|
||
A: Electron应用包含完整的Chromium浏览器引擎，这是正常的。打包后约100-150MB。
|
||
|
||
### Q: 安装后打不开？
|
||
|
||
A: 尝试：
|
||
1. 右键以管理员身份运行
|
||
2. 检查杀毒软件是否拦截
|
||
3. 确保系统是Windows 10+
|
||
|
||
### Q: 如何开发调试？
|
||
|
||
A: 运行：
|
||
```bash
|
||
npm run electron:dev
|
||
```
|
||
|
||
这会同时启动开发服务器和Electron窗口，支持热更新。
|
||
|
||
## 技术说明
|
||
|
||
- **前端框架**: React + TypeScript
|
||
- **3D引擎**: Three.js + React Three Fiber
|
||
- **构建工具**: Vite
|
||
- **桌面框架**: Electron
|
||
- **打包工具**: electron-builder
|
||
|
||
## 文件结构
|
||
|
||
```
|
||
storyai-3d-director-desk/
|
||
├── electron/ # Electron主进程
|
||
│ ├── main.js # 主进程入口
|
||
│ └── preload.js # 预加载脚本
|
||
├── src/ # 前端源码
|
||
├── dist/ # 构建输出
|
||
├── release/ # 打包输出
|
||
├── package.json # 项目配置
|
||
├── build-electron.bat # 一键打包脚本
|
||
└── README-PACKAGE.md # 本文档
|
||
```
|
||
|
||
## 更新日志
|
||
|
||
### v1.0.0
|
||
- 初始版本
|
||
- 支持Windows打包
|
||
- 支持桌面快捷方式
|