Skip to content

Desktop 桌面端

路径:packages/desktop

Electron 双进程 + 渲染进程复用 @xichen-full-stack/admin

架构

text
electron/main.ts     主进程:创建窗口、系统 API
electron/preload.ts  预加载:contextBridge 暴露 IPC
src/main.ts          渲染进程:bootstrapAdminApp

与 Web 的差异

Desktop
路由createWebHashHistory()(生产 file:// 兼容)
端口5174
依赖electron、vite-plugin-electron

入口示例

typescript
import { createWebHashHistory } from 'vue-router'
import { bootstrapAdminApp } from '@xichen-full-stack/admin'

await bootstrapAdminApp({
  baseURL: import.meta.env.VITE_API_BASE_URL || 'http://localhost:8080',
  history: createWebHashHistory(),
})

启动

bash
pnpm install          # 必须允许 electron postinstall
pnpm --filter desktop dev

打包

bash
pnpm --filter desktop build:unpack   # 仅 unpacked
pnpm --filter desktop build          # NSIS 安装包

Electron 安装问题

常见问题 — Electron

.npmrc 配置 ELECTRON_MIRRORnode-linker=hoisted

相关文档

Xichen Full Stack 内部文档