Files
koring-launcher/electron/preload.ts
T
dream_pep cd4578de5a feat: 全新 Korom 资源管理服务组件,优化内存占用
新增完整的程序本体资源管理与内存优化功能:
1. 新增背景图预处理服务,主进程将大图降采样至屏幕适配尺寸,避免全分辨率大图占用渲染进程大量内存
2. 实现资源注册表系统,支持引用计数、LRU自动逐出与释放回调
3. 新增资源与内存调试面板,可查看渲染进程JS堆、Electron进程内存与资源缓存状态
4. 修复进程内存信息API的单位与字段映射错误
5. 优化背景层缓存键避免过长dataURL,为Silk动画添加窗口隐藏时停帧逻辑减少GPU占用
6. 修复资源注册表类型适配问题并更新项目文档
2026-09-04 18:56:43 +08:00

143 lines
5.9 KiB
TypeScript

import electron from 'electron';
import path from 'path';
import fs from 'fs';
const { contextBridge, ipcRenderer } = electron;
const MIME_MAP: Record<string, string> = {
'.png': 'image/png',
'.jpg': 'image/jpeg',
'.jpeg': 'image/jpeg',
'.webp': 'image/webp',
'.gif': 'image/gif',
'.bmp': 'image/bmp',
};
function getFileAsDataUrl(filePath: string): string | null {
try {
const buffer = fs.readFileSync(filePath);
const ext = path.extname(filePath).toLowerCase();
const mime = MIME_MAP[ext] || 'image/png';
return `data:${mime};base64,${buffer.toString('base64')}`;
} catch {
return null;
}
}
// 按当前窗口实际像素需求计算背景图长边上限(含高分屏余量),
// 避免把数 MB~数十 MB 原图原样塞进渲染进程。
function computeMaxEdge(): number {
const dpr = window.devicePixelRatio || 1;
const css = Math.max(window.innerWidth || 1280, window.innerHeight || 800);
const target = Math.round(Math.max(css, 1920) * dpr * 1.1);
return Math.min(4096, Math.max(1920, target));
}
// 经主进程降采样/重编码后返回 data URL;主进程无法处理时回退到原始文件(行为不变)。
async function prepareBackgroundDataUrl(filePath: string): Promise<string | null> {
try {
const result = (await ipcRenderer.invoke('background:prepare', {
srcPath: filePath,
maxEdge: computeMaxEdge(),
})) as { success?: boolean; data?: { dataUrl?: string | null } | null };
if (result?.success && typeof result.data?.dataUrl === 'string' && result.data.dataUrl.length > 0) {
return result.data.dataUrl;
}
} catch {
// fallthrough to raw
}
return getFileAsDataUrl(filePath);
}
contextBridge.exposeInMainWorld('electronAPI', {
// Generic IPC
invoke: (channel: string, ...args: unknown[]) =>
ipcRenderer.invoke(channel, ...args),
on: (channel: string, callback: (...args: unknown[]) => void) => {
const handler = (_event: Electron.IpcRendererEvent, ...args: unknown[]) => callback(...args);
ipcRenderer.on(channel, handler);
return () => ipcRenderer.removeListener(channel, handler);
},
send: (channel: string, ...args: unknown[]) =>
ipcRenderer.send(channel, ...args),
// Window controls
minimize: () => ipcRenderer.invoke('window:minimize'),
maximize: () => ipcRenderer.invoke('window:maximize'),
close: () => ipcRenderer.invoke('window:close'),
isMaximized: () => ipcRenderer.invoke('window:isMaximized'),
openDevTools: () => ipcRenderer.invoke('window:openDevTools'),
onResized: (callback: () => void) => {
const handler = () => callback();
ipcRenderer.on('window:resized', handler);
return () => ipcRenderer.removeListener('window:resized', handler);
},
// Theme
getTheme: () => ipcRenderer.invoke('window:getTheme'),
// Config preloading
onConfigPreload: (callback: (data: { config: unknown; isFirstLaunch: boolean }) => void) => {
const handler = (_event: Electron.IpcRendererEvent, data: { config: unknown; isFirstLaunch: boolean }) => callback(data);
ipcRenderer.on('config:preload', handler);
return () => ipcRenderer.removeListener('config:preload', handler);
},
// Config changed broadcast (authoritative full config from main process)
onConfigChanged: (callback: (config: unknown) => void) => {
const handler = (_event: Electron.IpcRendererEvent, config: unknown) => callback(config);
ipcRenderer.on('config:changed', handler);
return () => ipcRenderer.removeListener('config:changed', handler);
},
// Background image — pick file, copy to userData, return base64 data URL
pickBackgroundImage: async (): Promise<string | null> => {
const result = await ipcRenderer.invoke('dialog:openFile', {
filters: [{ name: '图片', extensions: ['png', 'jpg', 'jpeg', 'webp', 'gif', 'bmp'] }],
});
if (!result) return null;
const { srcPath, ext } = result as { srcPath: string; ext: string };
// Copy to userData via main process
const destPath = await ipcRenderer.invoke('background:copyToUserData', srcPath, ext);
if (!destPath) return null;
return prepareBackgroundDataUrl(destPath);
},
// Get cached background as base64 data URL(自动降采样到屏幕所需尺寸)
getBackgroundDataUrl: async (): Promise<string | null> => {
const filePath = await ipcRenderer.invoke('background:getCachedPath');
if (!filePath) return null;
return prepareBackgroundDataUrl(filePath);
},
// Open external URL in system browser
openExternal: (url: string) => ipcRenderer.invoke('shell:openExternal', url),
// Crash monitoring — devtools only
simulateCrash: () => ipcRenderer.invoke('crash:simulate'),
testCrashDialog: () => ipcRenderer.invoke('crash:testDialog'),
// Config reset
resetConfig: () => ipcRenderer.invoke('config:reset'),
// Auto-update (main process: electron/updater.ts)
checkForUpdates: (manual = false) => ipcRenderer.invoke('update:check', { manual }),
downloadUpdate: () => ipcRenderer.invoke('update:download'),
pauseUpdate: () => ipcRenderer.invoke('update:pause'),
resumeUpdate: () => ipcRenderer.invoke('update:resume'),
cancelUpdate: () => ipcRenderer.invoke('update:cancel'),
quitAndInstall: () => ipcRenderer.invoke('update:quitAndInstall'),
getUpdateState: () => ipcRenderer.invoke('update:getState'),
getReleaseNotes: (tag?: string) => ipcRenderer.invoke('update:getReleaseNotes', { tag }),
getUpdateChannels: () => ipcRenderer.invoke('update:getChannels'),
setUpdateChannel: (channel: string) => ipcRenderer.invoke('update:setChannel', { channel }),
setTestVersion: (version: string) => ipcRenderer.invoke('update:setTestVersion', { version }),
compareVersions: (a: string, b: string) => ipcRenderer.invoke('update:compareVersions', { a, b }),
onUpdateStatus: (callback: (data: unknown) => void) => {
const handler = (_event: Electron.IpcRendererEvent, data: unknown) => callback(data);
ipcRenderer.on('update:status', handler);
return () => ipcRenderer.removeListener('update:status', handler);
},
});