106 lines
5.9 KiB
JavaScript
106 lines
5.9 KiB
JavaScript
// 安全的 IPC 桥
|
||
// 通过 contextBridge 暴露最小化的 API 给渲染进程
|
||
|
||
const { contextBridge, ipcRenderer } = require('electron');
|
||
|
||
// 渲染端的 dev 模式开关 —— preload 跑在 Node 上下文，可以同步读 process.env / process.argv。
|
||
// 与 main.js:416 的 dev 检测同款条件（NODE_ENV=development 或 --dev 参数），保持单一事实来源。
|
||
// renderer 用它开关 [sync] 控制台日志（dev 模式打印、生产静默），不影响功能。
|
||
const IS_DEV = process.env.NODE_ENV === 'development' || process.argv.includes('--dev');
|
||
|
||
contextBridge.exposeInMainWorld('api', {
|
||
// 同步字段：渲染端在打 [sync] 日志前用 window.api.isDev 判断，避免生产环境控制台噪音
|
||
isDev: IS_DEV,
|
||
// 文件操作
|
||
// 注：不暴露「打开文件对话框」—— UI 上已去掉新建/打开文件的入口，
|
||
// 文件位置只通过设置里的数据目录决定
|
||
saveFileDialog: () => ipcRenderer.invoke('file:save-dialog'),
|
||
readFile: (filePath) => ipcRenderer.invoke('file:read', filePath),
|
||
// options.force = true 跳过主进程的"防覆盖外部修改"mtime 检查，
|
||
// 用于用户已明确同意覆盖外部编辑的场景（"保留本地" 按钮 / 手动 Ctrl+S）。
|
||
// 自动保存默认 force=false，被主进程拒绝时返回 EXTERNAL_CHANGE_DETECTED，
|
||
// 由渲染端走冲突解决流程。
|
||
writeFile: (filePath, content, options = {}) =>
|
||
ipcRenderer.invoke('file:write', { filePath, content, options }),
|
||
fileExists: (filePath) => ipcRenderer.invoke('file:exists', filePath),
|
||
createFileIfMissing: (filePath, content) => ipcRenderer.invoke('file:create-if-missing', { filePath, content }),
|
||
createSnapshot: (filePath, label) => ipcRenderer.invoke('file:create-snapshot', { filePath, label }),
|
||
|
||
// 应用信息
|
||
getDataDir: () => ipcRenderer.invoke('app:get-data-dir'),
|
||
getDefaultDataDir: () => ipcRenderer.invoke('app:get-default-data-dir'),
|
||
// 用户主目录 —— renderer 用来把绝对路径转成 `~/...` 显示形式。
|
||
// 跟 getDataDir / getDefaultDataDir 配套（都是路径信息，权限边界一致）。
|
||
getHomeDir: () => ipcRenderer.invoke('app:get-home-dir'),
|
||
getVersion: () => ipcRenderer.invoke('app:get-version'),
|
||
getElectronVersion: () => ipcRenderer.invoke('app:get-electron-version'),
|
||
openDataDir: () => ipcRenderer.invoke('app:open-data-dir'),
|
||
// 打开外部链接（设置面板「关于」区的开发者主页链接用）
|
||
// 主进程端做协议白名单（仅 http / https），防 file: / javascript: 等危险协议
|
||
openExternal: (url) => ipcRenderer.invoke('app:open-external', url),
|
||
|
||
// 设置
|
||
getSettings: () => ipcRenderer.invoke('app:get-settings'),
|
||
saveSettings: (partial) => ipcRenderer.invoke('app:save-settings', partial),
|
||
chooseDataDir: () => ipcRenderer.invoke('app:choose-data-dir'),
|
||
|
||
// 退出前保存：通知主进程 dirty 状态变化、接收刷写指令
|
||
notifyDirtyChanged: (isDirty) => ipcRenderer.send('app:dirty-changed', isDirty),
|
||
notifyFlushDone: () => ipcRenderer.send('app:flush-done'),
|
||
onFlushPendingSave: (callback) => {
|
||
const handler = () => callback();
|
||
ipcRenderer.on('app:flush-pending-save', handler);
|
||
return () => ipcRenderer.removeListener('app:flush-pending-save', handler);
|
||
},
|
||
|
||
// 事件监听（来自主进程）
|
||
// 路由表：主进程菜单 / 快捷键 → 渲染端处理器。新增菜单项时**必须**同步加这里，
|
||
// 否则 main.js 发了 IPC 渲染端却没人监听，菜单点击会静默无效（v4 调试记录）。
|
||
onMenuCommand: (callback) => {
|
||
const events = ['menu:save', 'menu:reload', 'menu:toggle-theme', 'menu:settings'];
|
||
const handlers = events.map(name => {
|
||
const handler = () => callback(name);
|
||
ipcRenderer.on(name, handler);
|
||
return { name, handler };
|
||
});
|
||
return () => handlers.forEach(({ name, handler }) => ipcRenderer.removeListener(name, handler));
|
||
},
|
||
|
||
onFileExternalChange: (callback) => {
|
||
// 载荷从 string（filePath）升级为 {filePath, diskContent}（v3.4+ 增强）
|
||
const handler = (_event, payload) => callback(payload);
|
||
ipcRenderer.on('file:external-change', handler);
|
||
return () => ipcRenderer.removeListener('file:external-change', handler);
|
||
},
|
||
|
||
// 窗口控制
|
||
// setAlwaysOnTop：立即应用置顶状态（不落盘，由调用方走 saveSettings 持久化）。
|
||
// 返回 boolean 表示是否应用成功——主进程在窗口不存在/被销毁时返回 false。
|
||
setAlwaysOnTop: (enabled) => ipcRenderer.invoke('window:set-always-on-top', enabled),
|
||
|
||
// 始终置顶状态变更通知（来自主进程，比如托盘菜单点击），
|
||
// toolbar.js 订阅这个事件以同步按钮的激活态。
|
||
onAlwaysOnTopChanged: (callback) => {
|
||
const handler = (_event, enabled) => callback(enabled);
|
||
ipcRenderer.on('always-on-top:changed', handler);
|
||
return () => ipcRenderer.removeListener('always-on-top:changed', handler);
|
||
},
|
||
|
||
// 自定义窗口控制（frame: false 后接管系统标题栏）
|
||
// minimizeWindow：最小化到任务栏
|
||
minimizeWindow: () => ipcRenderer.invoke('window:minimize'),
|
||
// toggleMaximizeWindow：在最大化/还原之间切换，返回新的 isMaximized 状态，
|
||
// renderer 拿到返回值后只负责把按钮图标刷成对应样式，避免在 renderer 端维护状态副本。
|
||
toggleMaximizeWindow: () => ipcRenderer.invoke('window:toggle-maximize'),
|
||
// closeWindow：与窗口右上角 X 同义 —— 默认隐藏到托盘（除非用户主动退出）
|
||
closeWindow: () => ipcRenderer.invoke('window:close'),
|
||
|
||
// 窗口最大化状态变化通知（来自主进程 maximize / unmaximize / ready-to-show），
|
||
// toolbar.js 订阅这个事件以同步按钮图标（最大化态 ↔ 还原态）。
|
||
onMaximizeStateChanged: (callback) => {
|
||
const handler = (_event, isMaximized) => callback(isMaximized);
|
||
ipcRenderer.on('window:maximize-state', handler);
|
||
return () => ipcRenderer.removeListener('window:maximize-state', handler);
|
||
}
|
||
});
|