YD_Event.Web/ELECTRON.md

46 lines
1.3 KiB
Markdown
Raw Normal View History

2026-09-18 15:31:01 +08:00
# Electron 桌面端
## 本地开发
```bash
pnpm electron:dev
```
该命令会同时启动 Vite 开发服务器和 Electron,支持前端热更新。
## Windows 打包
```bash
pnpm electron:build
```
安装包输出到 `release/`。只生成免安装目录用于调试时,可运行:
```bash
pnpm electron:build:dir
```
## API 地址
打包后的应用右上角提供“接口环境”切换器,支持:
- 测试服:`http://8.153.108.90:9996`
- 正式服:`https://event.yuedongsports.com`
选择结果保存在本机,下次启动会继续使用上一次的环境。切换环境时应用会清除当前登录状态,防止跨环境复用 Token。
Electron 的登录 Token 使用窗口级 `sessionStorage` 保存,以兼容 `ydevent://` 自定义协议;关闭应用后需要重新登录。
启动应用前也可以通过环境变量覆盖地址:
```powershell
$env:ELECTRON_TEST_API_URL = 'http://localhost:9996'
$env:ELECTRON_API_ENV = 'test'
pnpm electron:dev
```
可用的覆盖变量为 `ELECTRON_TEST_API_URL` 和 `ELECTRON_PRODUCTION_API_URL`。
## 成绩投屏
Electron 中打开成绩或检录投屏时,会创建独立的无边框全屏窗口。存在多块显示器时,窗口自动放到主操作窗口以外的另一块屏幕;只有一块显示器时,则在当前屏幕全屏显示。