mirror of
https://github.com/dream-pep/koring-launcher.git
synced 2026-09-12 05:45:18 +08:00
dream_pep
74512bf935
- 新增 onRuntimeNotice IPC 接口与预加载桥接代码 - 在主进程添加 Linux 环境检查，未使用 AppImage 运行的打包版会提示更新组件可能受影响 - 新建 RuntimeNotices 组件处理并展示去重的持久化警告弹窗 - 将该组件注册到根布局中自动挂载 - 添加项目的 Git 提交信息规范文件
312 lines
11 KiB
TypeScript
312 lines
11 KiB
TypeScript
import electron from 'electron';
|
||
import path from 'path';
|
||
import fs from 'fs';
|
||
import { registerConfigHandlers } from './handlers/config';
|
||
import { registerAuthHandlers } from './handlers/auth';
|
||
import { registerInstallHandlers } from './handlers/install';
|
||
import { registerLaunchHandlers } from './handlers/launch';
|
||
import { registerModsHandlers } from './handlers/mods';
|
||
import { registerInstanceHandlers } from './handlers/instance';
|
||
import { registerBackgroundHandlers } from './handlers/background';
|
||
import { registerTaskHandlers } from './handlers/task';
|
||
import { registerSystemHandlers } from './handlers/system';
|
||
import { registerWindowHandlers } from './handlers/window';
|
||
import { registerCrashHandlers, setupCrashListeners, testCrashDialog } from './handlers/crash-monitor';
|
||
import { registerKoringAuthHandlers } from './handlers/koring-auth';
|
||
import { registerJavaHandlers } from './handlers/java';
|
||
import { registerUpdateHandlers } from './handlers/update';
|
||
import { updateService } from './updater';
|
||
import { saveConfig, configExists, getConfig, flushConfig, configPath } from './config';
|
||
import { findCachedBackgroundRaw, optimizeBackgroundFile, recoverBackgroundFromDataUrl } from './core/background-image';
|
||
import { registerResourceSchemePrivileges, registerResourceProtocol } from './resource-protocol';
|
||
import { createLogger, setDebugModeProvider, installIpcLogging, registerRendererLogBridge } from './core/logger';
|
||
import { dataBasePath } from './core/paths';
|
||
|
||
const { app } = electron;
|
||
|
||
const isDev = !app.isPackaged;
|
||
|
||
// 统一日志：debug 模式（config.advanced.debugMode）→ 控制台 + userData/koring.log；
|
||
// dev（未打包）运行下直接写进程 stdout/stderr，日志实时输出到启动它的终端；否则仅控制台
|
||
const log = createLogger('main');
|
||
setDebugModeProvider(() => {
|
||
try {
|
||
return getConfig()?.advanced?.debugMode === true;
|
||
} catch {
|
||
return false;
|
||
}
|
||
});
|
||
// 全局包装 ipcMain.handle：所有 IPC 流程自动带 channel/耗时/成败日志（须在 handler 注册前调用）
|
||
installIpcLogging();
|
||
|
||
// GPU acceleration flags
|
||
app.commandLine.appendSwitch('enable-gpu-rasterization');
|
||
app.commandLine.appendSwitch('enable-zero-copy');
|
||
|
||
// 自定义资源协议（koring-res://）特权注册：必须在 app ready 之前完成
|
||
registerResourceSchemePrivileges();
|
||
|
||
const win: { mainWindow: electron.BrowserWindow | null; splashWindow: electron.BrowserWindow | null } = {
|
||
mainWindow: null,
|
||
splashWindow: null,
|
||
};
|
||
|
||
// 首次启动标记（由 runStartupChecks 决定）；窗口每次加载/刷新时随 config:preload 一起推送
|
||
let isFirstLaunchFlag = false;
|
||
|
||
// 迁移旧版「安装目录」存储 → userData（仅打包模式）。配置必须存 userData 才能跨重装/更新
|
||
// 存活：NSIS 每次重装/升级会经旧卸载器删除整个安装目录（RMDir /r），/KEEP_APP_DATA 只保护 %APPDATA%。
|
||
// 复制而非移动，避免破坏用户已有文件；userData 已有目标文件则跳过。
|
||
function migrateLegacyFiles(): void {
|
||
if (!app.isPackaged) return;
|
||
const exeDir = path.dirname(app.getPath('exe'));
|
||
const src = path.join(exeDir, 'Koring.yml');
|
||
if (!fs.existsSync(src)) return;
|
||
const dest = path.join(app.getPath('userData'), 'Koring.yml');
|
||
if (fs.existsSync(dest)) return;
|
||
try {
|
||
fs.copyFileSync(src, dest);
|
||
log.info(`[migrate] 已复制 Koring.yml ${src} → ${dest}`);
|
||
} catch (e) {
|
||
log.error('[migrate] 复制 Koring.yml 失败:', e);
|
||
}
|
||
}
|
||
|
||
// Startup checks: .minecraft dir + config file + first launch detection
|
||
function runStartupChecks(): { isFirstLaunch: boolean; config: ReturnType<typeof getConfig> } {
|
||
// 数据基准：开发→项目根；Windows 打包→exe 目录；Linux/AppImage→userData（exe 目录是只读挂载）
|
||
const dataPath = dataBasePath();
|
||
|
||
// 1. Ensure .minecraft directory exists
|
||
const minecraftDir = path.join(dataPath, '.minecraft');
|
||
if (!fs.existsSync(minecraftDir)) {
|
||
fs.mkdirSync(minecraftDir, { recursive: true });
|
||
}
|
||
|
||
// 2. Check if config exists, if not create with defaults
|
||
const hasConfig = configExists();
|
||
const isFirstLaunch = !hasConfig;
|
||
|
||
// 3. Load (or create) config（getConfig 会缓存到主进程内存，成为唯一权威）
|
||
const config = getConfig();
|
||
if (isFirstLaunch) {
|
||
// 首次启动：全量写入，确保配置文件在安装目录可见（稀疏保存下全默认不落盘）
|
||
saveConfig(config, true);
|
||
}
|
||
|
||
return { isFirstLaunch, config };
|
||
}
|
||
|
||
// 迁移旧版「配置里存 BASE64 dataURL」→ 「存文件路径」：
|
||
// 优先使用 userData 里已有的原始缓存；没有缓存时直接把 dataURL 解码落盘，
|
||
// 保证任意旧配置都能改写成文件路径（显示内容与原 dataURL 完全一致）。
|
||
function migrateBackgroundDataUrlToPath(config: ReturnType<typeof getConfig>): void {
|
||
const bg = config?.background;
|
||
if (!bg || bg.bgType !== 'image' || typeof bg.image !== 'string' || !bg.image.startsWith('data:')) {
|
||
return;
|
||
}
|
||
try {
|
||
const userDataDir = app.getPath('userData');
|
||
const raw = findCachedBackgroundRaw(userDataDir) ?? recoverBackgroundFromDataUrl(bg.image, userDataDir);
|
||
if (!raw) return;
|
||
const result = optimizeBackgroundFile(raw, 4096);
|
||
if (!result || !result.filePath) return;
|
||
bg.image = result.filePath;
|
||
saveConfig(config);
|
||
log.info(`[background] 迁移：dataURL → 文件路径 ${result.filePath}`);
|
||
} catch (e) {
|
||
log.error('[background] 背景配置迁移失败:', e);
|
||
}
|
||
}
|
||
|
||
// 根据调试/运行状态自动选择窗口图标：
|
||
// - 开发调试（未打包）：直接使用 public/icons/dev/ 下的 dev 图标
|
||
// - 打包运行：electron-builder 构建时 switch-icon 已把对应模式图标复制到 build/
|
||
function getWindowIconPath(): string | undefined {
|
||
if (!app.isPackaged) {
|
||
return path.join(__dirname, '../public/icons/dev/icon.ico');
|
||
}
|
||
const packagedIcon = path.join(__dirname, '../build/icon.ico');
|
||
return fs.existsSync(packagedIcon) ? packagedIcon : undefined;
|
||
}
|
||
|
||
function createSplashWindow(): electron.BrowserWindow {
|
||
const iconPath = getWindowIconPath();
|
||
|
||
const splash = new electron.BrowserWindow({
|
||
width: 480,
|
||
height: 320,
|
||
transparent: true,
|
||
frame: false,
|
||
resizable: false,
|
||
skipTaskbar: true,
|
||
alwaysOnTop: true,
|
||
icon: iconPath,
|
||
webPreferences: {
|
||
nodeIntegration: false,
|
||
contextIsolation: true,
|
||
},
|
||
});
|
||
|
||
if (isDev) {
|
||
splash.loadURL('http://localhost:1420/splash.html');
|
||
} else {
|
||
splash.loadFile(path.join(__dirname, '../dist/splash.html'));
|
||
}
|
||
|
||
return splash;
|
||
}
|
||
|
||
function createMainWindow(): electron.BrowserWindow {
|
||
const iconPath = getWindowIconPath();
|
||
|
||
const main = new electron.BrowserWindow({
|
||
width: 1000,
|
||
height: 700,
|
||
minWidth: 800,
|
||
minHeight: 600,
|
||
frame: false,
|
||
transparent: false,
|
||
resizable: true,
|
||
show: false,
|
||
icon: iconPath,
|
||
webPreferences: {
|
||
preload: path.join(__dirname, 'preload.js'),
|
||
nodeIntegration: false,
|
||
contextIsolation: true,
|
||
sandbox: false,
|
||
},
|
||
});
|
||
|
||
if (isDev) {
|
||
main.loadURL('http://localhost:1420');
|
||
} else {
|
||
main.loadFile(path.join(__dirname, '../dist/index.html'));
|
||
}
|
||
|
||
// 每次页面加载完成（含 Ctrl+R / F5 刷新、HMR 全量重载）都推送【最新权威配置】给渲染端：
|
||
// - 用 getConfig()（主进程内存权威）而非启动时的快照，刷新后拿到的是当前值而不是过期快照
|
||
// - 监听器挂在具体窗口实例上，后续重建的窗口（如 macOS activate）也能收到
|
||
main.webContents.on('did-finish-load', () => {
|
||
if (main.isDestroyed()) return;
|
||
main.webContents.send('config:preload', { config: getConfig(), isFirstLaunch: isFirstLaunchFlag });
|
||
// Linux 打包但并非以 AppImage 方式运行（无 APPIMAGE 环境变量）→ 提示影响更新组件
|
||
if (app.isPackaged && process.platform === 'linux' && !process.env.APPIMAGE) {
|
||
main.webContents.send('runtime:notice', {
|
||
kind: 'linux-appimage-unpacked',
|
||
message: '您并未解包安装，这可能会影响更新组件的运行',
|
||
});
|
||
}
|
||
});
|
||
|
||
main.on('maximize', () => {
|
||
main.webContents.send('window:resized');
|
||
});
|
||
|
||
main.on('unmaximize', () => {
|
||
main.webContents.send('window:resized');
|
||
});
|
||
|
||
return main;
|
||
}
|
||
|
||
function registerAllHandlers() {
|
||
registerConfigHandlers(win);
|
||
registerAuthHandlers();
|
||
registerInstallHandlers(win);
|
||
registerLaunchHandlers(win);
|
||
registerModsHandlers();
|
||
registerInstanceHandlers(win);
|
||
registerBackgroundHandlers();
|
||
registerTaskHandlers(win);
|
||
registerSystemHandlers();
|
||
registerWindowHandlers(win);
|
||
registerCrashHandlers();
|
||
registerKoringAuthHandlers();
|
||
registerJavaHandlers();
|
||
registerUpdateHandlers();
|
||
}
|
||
|
||
app.whenReady().then(() => {
|
||
log.info('应用就绪，开始初始化主进程');
|
||
registerAllHandlers();
|
||
registerResourceProtocol();
|
||
registerRendererLogBridge();
|
||
log.info('IPC handlers / 资源协议 / 渲染日志桥注册完成');
|
||
|
||
// Migrate legacy install-dir config back to userData before anything reads them
|
||
migrateLegacyFiles();
|
||
|
||
// Run startup checks before creating windows
|
||
const { isFirstLaunch, config } = runStartupChecks();
|
||
isFirstLaunchFlag = isFirstLaunch;
|
||
log.info(`启动检查完成 isFirstLaunch=${isFirstLaunch} 配置路径=${configPath()}`);
|
||
|
||
// 旧配置中 background.image 若是 BASE64 dataURL → 落盘优化并改写为文件路径
|
||
migrateBackgroundDataUrlToPath(config);
|
||
|
||
// 1. Show splash immediately
|
||
win.splashWindow = createSplashWindow();
|
||
log.info('Splash 窗口已创建');
|
||
|
||
// 2. Create main window in background
|
||
// （config:preload 推送已内置于 createMainWindow 的 did-finish-load 监听，
|
||
// 每次加载/刷新都推送 getConfig() 的最新内存配置）
|
||
win.mainWindow = createMainWindow();
|
||
log.info('主窗口已创建（后台加载）');
|
||
|
||
// 3. When main window finishes loading, wait a minimum time then transition
|
||
let mainReady = false;
|
||
let splashMinTimeDone = false;
|
||
|
||
const tryTransition = () => {
|
||
if (mainReady && splashMinTimeDone) {
|
||
if (win.mainWindow && !win.mainWindow.isDestroyed()) {
|
||
win.mainWindow.show();
|
||
win.mainWindow.focus();
|
||
log.info('主窗口已显示，切换完成');
|
||
}
|
||
if (win.splashWindow && !win.splashWindow.isDestroyed()) {
|
||
win.splashWindow.close();
|
||
win.splashWindow = null;
|
||
log.info('Splash 窗口已关闭');
|
||
}
|
||
}
|
||
};
|
||
|
||
win.mainWindow.once('ready-to-show', () => {
|
||
mainReady = true;
|
||
tryTransition();
|
||
});
|
||
|
||
// Setup crash listeners on main window
|
||
setupCrashListeners(win.mainWindow);
|
||
|
||
// Minimum splash display time (1.5s)
|
||
setTimeout(() => {
|
||
splashMinTimeDone = true;
|
||
tryTransition();
|
||
}, 1500);
|
||
|
||
// 延迟静默检查更新（避开启动加载，不抢带宽；开发模式在 updater.init 内自动跳过）
|
||
setTimeout(() => {
|
||
log.info('触发启动静默更新检查');
|
||
updateService.check(false).catch((e) => {
|
||
log.error('[updater] 启动静默检查失败:', e);
|
||
});
|
||
}, 12000);
|
||
});
|
||
|
||
app.on('window-all-closed', () => {
|
||
log.info('所有窗口已关闭，flush 配置并退出');
|
||
flushConfig();
|
||
app.quit();
|
||
});
|
||
|
||
app.on('activate', () => {
|
||
if (electron.BrowserWindow.getAllWindows().length === 0) {
|
||
log.info('activate：重建主窗口');
|
||
win.mainWindow = createMainWindow();
|
||
}
|
||
});
|