Windows 上的安卓应用运行器:双击 APK 即装,应用以独立窗口与桌面图标运行,自持 QEMU 运行时
chore: 窗口验证工具测完自动清理沙盒(每个 AVD 约 3GB)
RoutineMiku17777abffad2
diff --git a/tools/check-launch-clean.js b/tools/check-launch-clean.jsnew file mode 100644index 0000000..042fbd0--- /dev/null+++ b/tools/check-launch-clean.js@@ -0,0 +1,117 @@+'use strict';+/**+ * 端到端验证「安卓应用打开只有安卓应用窗口」:+ * 1) 用沙盒 APPDATA 起真实 ApkStart,`--apk` 安装一个测试 APK(会拉起模拟器);+ * 2) 再 `--launch <包名>` 打开应用;+ * 3) 全程枚举可见顶层窗口:模拟器主窗(Android Emulator - …)与 qemu / netsimd+ * 的控制台窗口都不允许出现;应用窗口必须出现(说明 embed 成功、画面在窗口里)。+ *+ * 用法: node tools/check-launch-clean.js [apkPath]+ */+const fs = require('fs');+const os = require('os');+const path = require('path');+const { spawn } = require('child_process');+const { WinAgent } = require('../src/core/agent');++const ROOT = path.join(__dirname, '..');+const ENGINE = path.join(ROOT, 'engine');+const ELECTRON = path.join(ROOT, 'node_modules', 'electron', 'dist', 'electron.exe');+const APK = process.argv[2] || path.join(os.tmpdir(), 'fdroid.apk');+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));++const bad = (w) => {+ const t = String(w.title || '').toLowerCase();+ const c = String(w.cls || '');+ const isConsole = c.indexOf('ConsoleWindowClass') >= 0 || c.indexOf('CASCADIA_HOSTING') >= 0;+ if (isConsole) return t.indexOf('emulator') >= 0 || t.indexOf('netsim') >= 0 || t.indexOf('qemu') >= 0;+ return t.indexOf('android emulator') >= 0;+};++function launch(args, sandbox) {+ const env = { ...process.env, APPDATA: sandbox };+ delete env.ELECTRON_RUN_AS_NODE;+ const p = spawn(ELECTRON, ['.', ...args], {+ cwd: ROOT, env, windowsHide: true, stdio: ['ignore', 'pipe', 'pipe'],+ });+ p.stdout.on('data', () => {});+ p.stderr.on('data', () => {});+ return p;+}++(async () => {+ if (!fs.existsSync(APK)) throw new Error(`找不到测试 APK: ${APK}`);+ const sandbox = path.join(os.tmpdir(), `apk-launch-${Date.now()}`);+ const appData = path.join(sandbox, 'apkstart');+ fs.mkdirSync(appData, { recursive: true });+ fs.writeFileSync(path.join(appData, 'settings.json'), JSON.stringify({+ runtime: { dir: ENGINE }, engine: { prewarm: true },+ }));++ const agent = new WinAgent();+ await agent.ensure();++ let pass = true;+ const check = (c, m) => { console.log(`${c ? '✓' : '✗'} ${m}`); if (!c) pass = false; };++ // ---- 1) 安装 ----+ console.log('— 安装 APK(首次要冷启动模拟器,约 40~90 秒)…');+ let p = launch(['--apk', APK], sandbox);+ let pkg = '';+ for (let i = 0; i < 240; i += 1) {+ await sleep(1000);+ try {+ const apps = JSON.parse(fs.readFileSync(path.join(appData, 'apps.json'), 'utf8')).apps || [];+ if (apps.length && apps[0].package) { pkg = apps[0].package; break; }+ } catch (_) { /* 还没写出来 */ }+ if (p.exitCode !== null) break;+ }+ check(!!pkg, `安装完成:${pkg || '(超时)'}`);+ try { p.kill(); } catch (_) { /* ignore */ }+ await sleep(2500);++ if (!pkg) {+ agent.dispose();+ console.log('\n结果:失败(没有装出应用,后续跳过)');+ process.exit(1);+ }++ // ---- 2) 打开应用 ----+ console.log('— 打开应用…');+ p = launch(['--launch', pkg], sandbox);+ let leaked = 0;+ let sawAppWin = false;+ const titles = new Set();+ for (let i = 0; i < 120; i += 1) {+ await sleep(500);+ const r = await agent.call({ cmd: 'windows' }, 5000).catch(() => null);+ const list = ((r && r.list) || []);+ for (const w of list) if (w.title) titles.add(w.title);+ const hit = list.filter(bad);+ if (hit.length) {+ leaked += hit.length;+ console.log(`[${((i + 1) * 0.5).toFixed(1)}s] 可见的异常窗口:`, JSON.stringify(hit));+ }+ // 应用窗口 = 一个有标题、不是模拟器/控制台的普通窗口+ if (!sawAppWin) {+ sawAppWin = list.some((w) => {+ const t = String(w.title || '');+ return t && !bad(w) && !/ApkStart|WorkBuddy|Microsoft|Program Manager|设置|Edge|输入体验/.test(t);+ });+ if (sawAppWin) console.log(`[${((i + 1) * 0.5).toFixed(1)}s] 应用窗口已出现`);+ }+ if (sawAppWin && i > 40) break;+ }++ check(leaked === 0, `模拟器/控制台窗口始终不可见(累计 ${leaked} 次)`);+ check(sawAppWin, `应用窗口已出现(说明画面被嵌进窗口,而不是独立的模拟器窗口)`);+ console.log(' 可见窗口标题:', JSON.stringify([...titles].slice(0, 12)));++ try { p.kill(); } catch (_) { /* ignore */ }+ agent.dispose();+ await sleep(1500);+ try { fs.rmSync(sandbox, { recursive: true, force: true, maxRetries: 3 }); } catch (_) { /* ignore */ }+ console.log('');+ console.log(`结果:${pass ? '通过' : '失败'}`);+ process.exit(pass ? 0 : 1);+})().catch((e) => { console.error('FATAL', e); process.exit(1); });diff --git a/tools/check-quit-clean.js b/tools/check-quit-clean.jsindex e37b751..e18d7f5 100644--- a/tools/check-quit-clean.js+++ b/tools/check-quit-clean.js@@ -83,5 +83,7 @@ const bad = (w) => {try { proc.kill(); } catch (_) { /* ignore */ }agent.dispose();+ // 沙盒里的 AVD 有好几个 GB,测完顺手清掉(模拟器还占着文件时会失败,忽略即可)+ try { fs.rmSync(sandbox, { recursive: true, force: true, maxRetries: 3 }); } catch (_) { /* ignore */ }process.exit(ok ? 0 : 1);})().catch((e) => { console.error('FATAL', e); process.exit(1); });