LoveChengke
c7f215a09c
- 增加课件上传、班级可见范围、设备补收与传输进度 - 整合自定义灵动岛编辑器和相关客户端交互 - 同步三端契约、数据库迁移、部署配置与隔离回归 - 按源码统一文档与官网说明，移除过时任务书和审查记录 - 保持产品版本为 1.4.0
201 lines
7.9 KiB
JavaScript
201 lines
7.9 KiB
JavaScript
/**
|
||
* 打包版冒烟验证：对**已打包**的客户端 EXE 跑一遍与 `pnpm verify:desktop` 相同的自检。
|
||
*
|
||
* 为什么需要单独一条：开发产物（`dist/`）通过不代表打包产物通过 —— asar 打包后
|
||
* 资源路径、Electron 版本、`app.isPackaged` 都可能不同。交付前应实测 `packaged: true`。
|
||
*
|
||
* 用法：
|
||
* node scripts/verify-packaged.mjs --exe "releases/client/<版本>/安装包/ClassHelper-<版本>-x64-portable.exe" --offline
|
||
* 显式 --visual 才进行桌面视觉验收，显式 --online 才探测并启用联网。
|
||
* 联网前由调用方准备隔离服务、临时教师和班级，并显式传入测试凭据；本脚本不自动创建它们。
|
||
* 默认后台快速、离线，两次启动均成功且 packaged=true 才返回 0。
|
||
*/
|
||
import { spawn, spawnSync } from 'node:child_process';
|
||
import fs from 'node:fs';
|
||
import path from 'node:path';
|
||
import { fileURLToPath } from 'node:url';
|
||
import { resolveElectronEnv } from './lib/electron-env.mjs';
|
||
|
||
const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
|
||
const argv = process.argv.slice(2);
|
||
const argOf = (name) => {
|
||
const index = argv.indexOf(name);
|
||
return index >= 0 ? argv[index + 1] : undefined;
|
||
};
|
||
|
||
// 默认取「装好的客户端」：打包产物里已经没有解包目录（见 dist-win.mjs 文件头），
|
||
// 所以默认值只能是安装后的落点，其余情况一律用 --exe 显式指定。
|
||
const installedExe = path.join(
|
||
process.env.LOCALAPPDATA ?? path.join(process.env.USERPROFILE ?? '', 'AppData', 'Local'),
|
||
'Programs',
|
||
'ClassHelper',
|
||
'ClassHelper.exe',
|
||
);
|
||
|
||
const exe = path.resolve(argOf('--exe') ?? installedExe);
|
||
const classCode = argOf('--code') ?? process.env.ELECTRON_SMOKE_CLASS_CODE ?? 'G101';
|
||
const classPassword = argOf('--password') ?? process.env.ELECTRON_SMOKE_CLASS_PASSWORD ?? '123456';
|
||
const mode = argv.includes('--visual') ? 'visual' : 'quick';
|
||
const forceOffline = !argv.includes('--online') || argv.includes('--offline');
|
||
|
||
if (!fs.existsSync(exe)) {
|
||
console.error(`[packaged-smoke] 找不到打包后的 EXE：${exe}`);
|
||
console.error(
|
||
'[packaged-smoke] 用 --exe 指定：装好的客户端（默认 %LOCALAPPDATA%\\Programs\\ClassHelper\\' +
|
||
'ClassHelper.exe）、或解压后的便携版所在目录',
|
||
);
|
||
process.exit(2);
|
||
}
|
||
if (mode === 'quick') {
|
||
const backgroundMarker = Buffer.from('ELECTRON_SMOKE_MODE');
|
||
const candidates = [
|
||
path.join(path.dirname(exe), 'resources/app.asar'),
|
||
path.join(path.dirname(exe), 'resources/app/dist/main/index.js'),
|
||
];
|
||
let supportsBackground = candidates.some(
|
||
(file) => fs.existsSync(file) && fs.readFileSync(file).includes(Buffer.from('ELECTRON_SMOKE_MODE')),
|
||
);
|
||
|
||
// electron-builder 的 portable 目标把整个 app 放在 7z 自解压文件里，EXE 旁边没有 resources/。
|
||
// 从本仓库打包缓存里的 7za 只读取 app.asar 到内存，确认本次便携包也包含后台模式标记。
|
||
if (!supportsBackground && /-portable\.exe$/i.test(exe)) {
|
||
try {
|
||
const cacheDir = path.join(repoRoot, '.cache', 'electron-builder');
|
||
const sevenZip = fs
|
||
.readdirSync(cacheDir, { withFileTypes: true })
|
||
.filter((entry) => entry.isDirectory() && entry.name.startsWith('7zip@'))
|
||
.flatMap((entry) => {
|
||
const packageDir = path.join(cacheDir, entry.name);
|
||
return fs
|
||
.readdirSync(packageDir, { withFileTypes: true })
|
||
.filter((child) => child.isDirectory())
|
||
.map((child) => path.join(packageDir, child.name, 'bin', '7za.exe'));
|
||
})
|
||
.find((file) => fs.existsSync(file));
|
||
|
||
if (sevenZip) {
|
||
const payload = spawnSync(sevenZip, ['e', '-so', exe, 'resources/app.asar'], {
|
||
encoding: null,
|
||
maxBuffer: 32 * 1024 * 1024,
|
||
windowsHide: true,
|
||
});
|
||
supportsBackground = payload.status === 0 && payload.stdout?.includes(backgroundMarker);
|
||
}
|
||
} catch {
|
||
// 下方的提示会说明该产物未确认支持后台模式。
|
||
}
|
||
}
|
||
|
||
if (!supportsBackground) {
|
||
console.error(
|
||
'[packaged-smoke] 无法确认这个产物支持后台快速模式。请验证新构建的产物，或显式 --visual 执行桌面验收。',
|
||
);
|
||
process.exit(2);
|
||
}
|
||
}
|
||
|
||
let online = forceOffline ? '0' : null;
|
||
if (online === null) {
|
||
online = '0';
|
||
try {
|
||
const controller = new AbortController();
|
||
const timer = setTimeout(() => controller.abort(), 2500);
|
||
const response = await fetch('http://127.0.0.1:4000/api/health', { signal: controller.signal });
|
||
clearTimeout(timer);
|
||
online = response.ok ? '1' : '0';
|
||
} catch {
|
||
online = '0';
|
||
}
|
||
}
|
||
|
||
// 独立 userData：用户开着客户端也能跑验证（不抢单实例锁）
|
||
const profileDir = path.join(repoRoot, '.cache', `packaged-smoke-profile-${process.pid}`);
|
||
const resultFile = path.join(repoRoot, '.cache', `packaged-smoke-${process.pid}.json`);
|
||
fs.rmSync(profileDir, { recursive: true, force: true, maxRetries: 2, retryDelay: 200 });
|
||
|
||
console.log(`[packaged-smoke] EXE：${exe}`);
|
||
console.log(`[packaged-smoke] 联网用例：${online === '1' ? '启用' : '关闭'}`);
|
||
console.log(`[packaged-smoke] 独立配置目录：${profileDir}\n`);
|
||
|
||
/** 启动一次打包版冒烟（stdio 继承：EXE 是 GUI 进程，输出直接透传到终端） */
|
||
function launch(extraEnv) {
|
||
return new Promise((resolve) => {
|
||
const child = spawn(exe, [], {
|
||
cwd: path.dirname(exe),
|
||
stdio: 'inherit',
|
||
windowsHide: true,
|
||
env: resolveElectronEnv({
|
||
ELECTRON_SMOKE_TEST: '1',
|
||
ELECTRON_SMOKE_MODE: mode,
|
||
ELECTRON_SMOKE_PROFILE: profileDir,
|
||
ELECTRON_SMOKE_ONLINE: online,
|
||
ELECTRON_SMOKE_CLASS_CODE: classCode,
|
||
ELECTRON_SMOKE_CLASS_PASSWORD: classPassword,
|
||
// 教师凭据：打包版的主进程从环境变量读（安装包里不留口令字面量）
|
||
ELECTRON_SMOKE_USER: process.env.ELECTRON_SMOKE_USER ?? 'teacher1',
|
||
ELECTRON_SMOKE_PASSWORD: process.env.ELECTRON_SMOKE_PASSWORD ?? 'teacher123',
|
||
...extraEnv,
|
||
}),
|
||
});
|
||
child.on('exit', (code) => resolve(code ?? 1));
|
||
});
|
||
}
|
||
|
||
const readResult = () => {
|
||
try {
|
||
return JSON.parse(fs.readFileSync(resultFile, 'utf8'));
|
||
} catch {
|
||
return null;
|
||
}
|
||
};
|
||
|
||
fs.rmSync(resultFile, { force: true });
|
||
const firstCode = await launch({ ELECTRON_SMOKE_RESULT: resultFile });
|
||
const first = readResult();
|
||
const firstPassed = first?.passed ?? -1;
|
||
const firstTotal = first?.total ?? -1;
|
||
|
||
// 退出后再启动一次：证明单实例锁与文件句柄都已释放（与开发版冒烟同一套判据）
|
||
let lockReleased = true;
|
||
try {
|
||
fs.rmSync(profileDir, { recursive: true, force: true, maxRetries: 2, retryDelay: 200 });
|
||
} catch (error) {
|
||
lockReleased = false;
|
||
console.error(`[packaged-smoke] [FAIL] 退出后配置文件锁未释放：${error?.message ?? error}`);
|
||
}
|
||
console.log('\n[packaged-smoke] 二次启动校验（单实例锁 / 句柄是否已释放）...');
|
||
fs.rmSync(resultFile, { force: true });
|
||
const secondCode = await launch({
|
||
ELECTRON_SMOKE_ONLINE: '0',
|
||
ELECTRON_SMOKE_MODE: 'quick',
|
||
ELECTRON_SMOKE_RESULT: resultFile,
|
||
});
|
||
const second = readResult();
|
||
|
||
const ok =
|
||
firstCode === 0 &&
|
||
first?.ok === true &&
|
||
first?.packaged === true &&
|
||
firstPassed === firstTotal &&
|
||
lockReleased &&
|
||
secondCode === 0 &&
|
||
second?.ok === true &&
|
||
second?.packaged === true;
|
||
|
||
console.log(
|
||
`\n[packaged-smoke] 首次启动：${firstPassed}/${firstTotal} packaged=${first?.packaged === true} code=${firstCode}`,
|
||
);
|
||
console.log(
|
||
`[packaged-smoke] 二次启动：${second?.passed ?? -1}/${second?.total ?? -1} ` +
|
||
`packaged=${second?.packaged === true} code=${secondCode} 文件锁已释放=${lockReleased}`,
|
||
);
|
||
console.log(ok ? '[packaged-smoke] [PASS] 打包版全绿' : '[packaged-smoke] [FAIL] 打包版未全绿');
|
||
|
||
try {
|
||
fs.rmSync(profileDir, { recursive: true, force: true, maxRetries: 2, retryDelay: 200 });
|
||
} catch {
|
||
// 清理失败不影响结论（第一次删除已证明锁已释放）
|
||
}
|
||
|
||
process.exit(ok ? 0 : 1);
|