/** * 对比窗口的创建入口(由前端创建,范式同 `editor/openWindow.ts`)。 * * # 为什么是单例 * * 与编辑器窗口(可多开、按目标判重)不同,对比工具的语义是「比较这一对目标」, * 窗口里本来就同时容纳左右两侧 —— 多开只会让用户分不清哪一对是哪一对。 * 因此 label 固定为 `diff-window`,已存在就强制置前。 * * # 隐藏创建 + 先应用主题 * * 窗口初始底色是白的,而深色主题要等前端读 localStorage 后才应用 —— 直接显示会先 * 闪一下纯白。因此 `visible: false` 创建,由 `DiffWindow.vue` 应用完主题(含窗口效果) * 与任务栏身份之后再自己 `show()`(同编辑器 / 终端窗口)。 * * # 置前走原生命令 * * `SetForegroundWindow` 不受 Windows 前台锁定限制;前端 `setFocus()` 在「本进程不拥有 * 前台」时会被系统直接忽略(表现为窗口明明开着却唤不到前面)。同下载窗口 / 快速面板。 */ import { WebviewWindow } from '@tauri-apps/api/webviewWindow' import { invoke } from '@tauri-apps/api/core' import { createLogger } from '@/lib/logger' import { WINDOWS } from '@/lib/constants' const logger = createLogger('diff') const LABEL = WINDOWS.diffWindow /** * 打开(或唤出)对比窗口。 * * @param target 可选:P2 起用于把某个文件 / 文件夹作为初始目标(写入 URL 查询串) */ export async function openDiffWindow(target?: { path?: string }): Promise { const existing = await WebviewWindow.getByLabel(LABEL) if (existing) { try { await invoke('window_focus_window', { label: LABEL }) return } catch (e) { logger.warn(`唤出既有对比窗口失败:${String(e)}`) } } const query = target?.path ? `?path=${encodeURIComponent(target.path)}` : '' const win = new WebviewWindow(LABEL, { url: `index.html#${LABEL}${query}`, title: '对比', width: 1180, height: 780, minWidth: 720, minHeight: 460, resizable: true, // 自绘标题栏(与编辑器 / 终端 / 文件窗口一致) decorations: false, // 透明通道用于承载 mica / acrylic transparent: true, shadow: true, center: true, visible: false, focus: false, // 拖入任意文件 / 文件夹作为某一侧目标(P2 起真正使用) dragDropEnabled: true }) // 不要等到 `tauri://created` 之后才挂错误监听:窗口创建过快时事件可能早于监听注册 win.once('tauri://error', e => logger.error(`打开对比窗口失败:${String(e)}`)) // 补注入拖放支持:wry 只在创建 webview 那一刻扫一次子窗口,运行期新建的窗口拿不到 // OLE drop target(拖文件进去是禁止光标)。详见 src-tauri/src/drag_drop.rs // // 注意**不要**放到下面那个 `await` 之后:`tauri://created` 在窗口创建过快时可能早于 // 监听注册而永远等不到。Rust 侧会自行重试等待窗口与 WebView2 子窗口就位,因此这里 // fire-and-forget 即可。 void invoke('window_attach_drag_drop', { label: LABEL }).catch(e => { logger.warn(`拖放补注入失败:${String(e)}`) }) await new Promise((resolve, reject) => { win.once('tauri://created', () => resolve()) win.once('tauri://error', e => reject(new Error(String(e)))) }) }