55 lines
1.7 KiB
Markdown
55 lines
1.7 KiB
Markdown
# Electron 桌面端
|
||
|
||
## 本地开发
|
||
|
||
```bash
|
||
pnpm electron:dev
|
||
```
|
||
|
||
该命令会同时启动 Vite 开发服务器和 Electron，支持前端热更新。
|
||
|
||
## Windows 打包
|
||
|
||
```bash
|
||
pnpm electron:build
|
||
```
|
||
|
||
也可以直接双击项目根目录的 `build-electron.cmd`。它会自动检查 Node.js/pnpm，在依赖缺失时执行安装，随后构建 Electron 安装包并在成功后打开输出目录。
|
||
|
||
对应的命令行入口为：
|
||
|
||
```bash
|
||
pnpm electron:package:auto
|
||
```
|
||
|
||
安装包输出到 `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 中打开成绩或检录投屏时，会创建独立的无边框全屏窗口。存在多块显示器时，窗口自动放到主操作窗口以外的另一块屏幕；只有一块显示器时，则在当前屏幕全屏显示。
|