SuperAPI AI 工具集

electron-base

编程与开发

查看项目

更新于 10-15 23:31

技能介绍

用途:指导用 Electron 33、Vite、React、TypeScript 搭建安全、现代的桌面应用,覆盖主进程与渲染进程分离、类型安全 IPC、OAuth 登录、原生模块与打包发布。

主要能力:通过 contextBridge 暴露类型化 API,避免直接暴露 ipcRenderer;用 invoke/handle 与 send/on 实现 IPC;用自定义协议处理器完成 OAuth 回调,并用 state 校验防 CSRF;集成 electron-store 持久化与加密存储;支持 better-sqlite3 等原生模块;用 electron-builder 打包 macOS、Windows、Linux。

使用方式:先用 npm create vite@latest my-app -- --template react-ts 创建项目,再安装 electron、electron-store 及 vite-plugin-electron、vite-plugin-electron-renderer、electron-builder 等开发依赖。项目分为 electron/(main.ts、preload.ts、ipc-handlers/)与 src/ 渲染层,配置双入口 Vite 与 electron-builder.json。开发用 npm run dev,构建用 npm run build,打包用 npm run package 或 npx electron-builder --mac/--win/--linux。原生模块需 npx electron-rebuild -f -w better-sqlite3。

适用场景:需要安全 IPC、系统级能力、OAuth 登录与跨平台分发的桌面客户端。

限制与注意:必须启用 contextIsolation: true、nodeIntegration: false;不得硬编码加密密钥,应从机器标识派生;better-sqlite3 等原生模块需 sandbox: false 并记录安全权衡;OAuth state 需持久化存储;避免空 catch 掩盖错误;发布前检查 CSP、macOS 加固运行时与代码签名。具体版本与配置以资料为准,未提供的信息暂未提供。