Windows 上的安卓应用运行器:双击 APK 即装,应用以独立窗口与桌面图标运行,自持 QEMU 运行时
fix(launch): 修掉「红果打不开」的回归;托盘单击开主界面;压启动耗时与杂窗
RoutineMikuca635e5a7188
diff --git a/.github/release-notes-v0.4.0.md b/.github/release-notes-v0.4.0.mdnew file mode 100644index 0000000..e0ae0e4--- /dev/null+++ b/.github/release-notes-v0.4.0.md@@ -0,0 +1,52 @@+# ApkStart v0.4.0++> 一句话:修好「红果打不开 / 一直黑屏」这个回归,托盘单击就能开主界面,再压了一轮启动速度,并把运行期的杂窗统一压掉。++## 一、修复:红果打不开 / 一直黑屏(v0.3.9 的回归)++**原因**:上一版为了「等网络就绪再启动应用」,在启动流程里调了带**冷启动重试**的等待逻辑。网络慢的时候它会「停掉虚拟机 → 冷启动」,而应用启动正要 `adb install` / `am start` —— 设备在途中消失,于是:++```+adb.exe: device 'emulator-5554' not found+launch failed com.phoenix.read+```++**修复**:++- **启动路径上永远只等、不重启**:最多等 20 秒,等不到就先启动应用(页面慢一点没关系,不能直接失败);+- 冷启动/重置这类重活只在用户主动点「修复网络」时才做;+- `waitForNetwork` 不再一看到 `device-offline` 就放弃 —— 刚重启的虚拟机有几十秒 adb 还没上线,现在给 45 秒宽限(之前的版本因此误判「修复失败」)。++**同时把「修复网络」改对了**:实测这个镜像只有 `-wipe-data` 后的那次开机才稳定联网,所以现在直接重置数据(应用清单保留、点开自动重装),联网成功后**立刻存快照** —— 下次从快照恢复时网卡状态一起还原。++实测:修复后启动日志出现 `虚拟机网络就绪(10.0.2.16)`,点「同意并继续」进入 `MainFragmentActivity`,首页正常刷出剧集与推荐流。++## 二、托盘:单击即可打开主界面++之前只绑了双击,用户单击没反应会以为托盘图标坏了。现在单击直接打开主窗口(右键仍是菜单,双击照旧)。++## 三、启动速度++- 启动路径不再做冷启动重试,去掉了动辄 3~5 分钟的等待;+- 网络等待从 60 秒降到 **20 秒**,且设备掉线时立刻返回而不是空转;+- 修好网络后会存一份「网络正常」的快照,之后每次从快照恢复:实测完整启动(开机→联网→安装→嵌入)约 **48 秒**,其中开机约 20 秒。++## 四、运行期杂窗++窗口代理新增一层兜底:把**属于我们运行时目录的进程**创建的所有多余可见顶层窗口统一隐藏(Qt 提示框、崩溃对话框、音量条、日志窗等),只保留要嵌进宿主的那一个模拟器主窗口。之前的实现是按类名逐个点名,漏一个就闪一次。++## 五、工程加固++- `agent.ps1` 重新带上 **UTF-8 BOM**。之前用普通方式保存会丢 BOM,PowerShell 5.1 按 ANSI 读中文注释,可能把注释和下一行代码并成一行导致 `Add-Type` 编译失败(表现就是「窗口代理启动失败 / 应用窗口不嵌入」)。+- 新增回归测试:**窗口代理脚本必须带 UTF-8 BOM**,以后再丢会直接测试失败。++## 六、实测++- `npm test`:**114 项全部通过**(8 + 25 + 81)。+- 红果:启动 → 同意 → 首页正常显示视频流(截图确认)。+- 托盘单击可打开主界面。++## 七、升级方式++- 便携版:解压覆盖,数据目录(默认 `%APPDATA%\apkstart`)保持不变。+- 安装版:直接安装覆盖。diff --git a/package.json b/package.jsonindex 782fd81..0b3afb1 100644--- a/package.json+++ b/package.json@@ -1,7 +1,7 @@{"name": "apkstart","productName": "ApkStart",- "version": "0.3.9",+ "version": "0.4.0","description": "极致轻量的 Windows 安卓应用运行器:双击 APK 即装,应用以独立窗口与桌面图标运行","main": "src/main.js","author": "RoutineMiku",diff --git a/src/core/engine.js b/src/core/engine.jsindex dbaa6ae..065475a 100644--- a/src/core/engine.js+++ b/src/core/engine.js@@ -1121,10 +1121,20 @@ class Runtime {const t0 = Date.now();let last = null;let lastNotice = 0;+ let offlineSince = 0;while (Date.now() - t0 < timeoutMs) {- // eslint-disable-next-line no-await-in-loop- last = await this.emulator.checkNetwork(adbPath || this.adbPath()).catch(() => null);- if (last && last.ok) return last;+ const online = await this.client().isOnline().catch(() => false);+ if (!online) {+ // 刚重启的虚拟机会有一段时间连 adb 都还没上线,不能一看到 offline 就放弃+ // (之前就是这样:重置数据后立刻返回 device-offline,判定「修复失败」)。+ if (!offlineSince) offlineSince = Date.now();+ if (Date.now() - offlineSince > 45000) return { ok: false, reason: 'device-offline' };+ } else {+ offlineSince = 0;+ // eslint-disable-next-line no-await-in-loop+ last = await this.emulator.checkNetwork(adbPath || this.adbPath()).catch(() => null);+ if (last && last.ok) return last;+ }if (Date.now() - lastNotice > 10000) {lastNotice = Date.now();onLog(`正在等待安卓虚拟机联网… ${Math.round((Date.now() - t0) / 1000)}s`);@@ -1180,33 +1190,27 @@ class Runtime {*/async repairNetwork({ onLog = () => {} } = {}) {try {- onLog('正在修复虚拟机网络:先冷启动重试…');+ // 直接重置数据:这是实测唯一稳定能让这个镜像联网的办法。+ // (先冷启动再等 3 分钟只是白等 —— 已有用户数据上的冷启动根本连不上 Wi-Fi。)+ onLog('正在修复虚拟机网络:重置安卓数据并重新开机(应用清单会保留,点开时自动重装)…');if (this.vmRunning) await this.stop({ graceful: false }).catch(() => {});- this.emulator.forceColdBootOnNextStart();- let boot = await this.ensure({ onLog });+ // 给上一次的 qemu / netsimd 一点时间退干净,否则 -wipe-data 会撞 AVD 锁+ await new Promise((r) => setTimeout(r, 2500));+ this.emulator.forceWipeOnNextStart();+ const boot = await this.ensure({ onLog });if (!boot || !boot.ok) {- return { ok: false, error: (boot && boot.error) || '虚拟机没能启动', boot: false };- }- let network = await this.waitForNetwork({ onLog, timeoutMs: 180000 });- let wiped = false;- if (!network || !network.ok) {- onLog('冷启动后仍然没有网络,改为重置安卓数据再试一次(应用清单会保留)…');- await this.stop({ graceful: false }).catch(() => {});- this.emulator.forceWipeOnNextStart();- boot = await this.ensure({ onLog });- if (!boot || !boot.ok) {- return { ok: false, error: (boot && boot.error) || '重置后虚拟机没能启动', boot: false, wiped: true };- }- network = await this.waitForNetwork({ onLog, timeoutMs: 240000 });- wiped = true;+ return { ok: false, error: (boot && boot.error) || '虚拟机没能启动', boot: false, wiped: true };}+ const network = await this.waitForNetwork({ onLog, timeoutMs: 240000 });if (network && network.ok) {+ // 立刻把「网络正常」的状态存成快照:下次恢复时网卡状态一起还原,+ // 否则关掉再开又会回到没网状态。try { await this.emulator.saveSnapshotNow(this.adbPath(), { timeout: 90000 }); } catch (_) { /* ignore */ }- onLog(`网络已恢复(${network.ip || ''} 网关 ${network.gateway || '可达'})。`);+ onLog(`网络已恢复(${network.ip || ''} 网关 ${network.gateway || '可达'}),已存好可用快照。`);} else {- onLog('等待超时,虚拟机仍没有网络。多半是宿主机网络/防火墙拦住了模拟器,请检查后重试。');+ onLog('重置后仍未联网。请检查本机网络/防火墙是否拦截了模拟器(netsimd 走本机回环端口)。');}- return { ok: !!(network && network.ok), network, boot: true, wiped };+ return { ok: !!(network && network.ok), network, boot: true, wiped: true };} catch (e) {return { ok: false, error: e.message };}diff --git a/src/core/installer.js b/src/core/installer.jsindex fffda41..7935710 100644--- a/src/core/installer.js+++ b/src/core/installer.js@@ -418,12 +418,16 @@ class Installer {// 关键修复:Wi-Fi 关联往往比 sys.boot_completed 晚几十秒,红果一进去就拉首页数据,// 没网时首页渲染成整块黑底 —— 这就是「点同意并继续后一直黑屏」的真正原因。// 所以拉起应用前先等网络就绪(最多 90 秒),宁可多等几秒也不要给用户一块黑屏。+ // 拉起来之前先看一眼网络:**只等,不重启**。+ // 之前这里调的是 ensureNetwork(),网络慢时会「停掉虚拟机 → 冷启动」,+ // 结果 adb 设备在安装途中消失,直接变成「红果打不开」。+ // 启动路径上绝不能做这种破坏性动作,等不到就先启动,大不了页面暂时加载慢。if (rt.engine === 'emulator' || rt.engine === 'builtin') {- const net = await this.runtime.ensureNetwork({ onLog }).catch(() => null);+ const net = await this.runtime.waitForNetwork({ onLog, timeoutMs: 20000 }).catch(() => null);if (net && net.ok) {onLog(`虚拟机网络就绪(${net.ip || ''})`);} else {- onLog('⚠ 虚拟机联网超时:需要联网的页面可能暂时黑屏,可在「设置 → 修复网络」重试。');+ onLog('虚拟机网络还没就绪,先启动应用(联网页面可能稍后才加载出来)');}}const settings = store.getSettings();diff --git a/src/core/win/agent.ps1 b/src/core/win/agent.ps1index 37ff07e..2e34b28 100644--- a/src/core/win/agent.ps1+++ b/src/core/win/agent.ps1@@ -422,6 +422,32 @@ public class ApkAgentreturn b.ToString();}+ // 兜底:把「我们的运行时进程」创建的任何**多余的顶层可见窗口**都藏起来。+ // 除了模拟器主窗口(要嵌进宿主)之外,emulator / qemu / netsimd / adb 都可能+ // 弹出一些一闪而过的东西(Qt 提示框、崩溃对话框、音量条、日志窗…)。+ // 以前只按类名逐个点名,漏一个就闪一次;这里改成按「进程属于我们的运行时目录」+ // 判断,覆盖面更全。宿主窗口和模拟器窗口本身不在这个范围,绝不会误伤。+ static void HideStrayWindows()+ {+ if (_scopeDirs.Count == 0) return;+ IntPtr embeddedRoot = _emu;+ EnumWindows(delegate(IntPtr h, IntPtr p)+ {+ if (!IsWindowVisible(h)) return true;+ if (h == embeddedRoot) return true;+ uint pid;+ GetWindowThreadProcessId(h, out pid);+ if (!IsOurs(pid)) return true;+ string cls = ClassOf(h);+ // 控制台/工具栏已有专门处理,这里只管剩下的杂窗+ RECT r;+ if (!GetWindowRect(h, out r)) return true;+ if ((r.R - r.L) < 8 && (r.B - r.T) < 8) return true; // 8x8 以下当隐形+ ShowWindow(h, 0);+ return true;+ }, IntPtr.Zero);+ }+// 常驻压制扫描:只要模拟器窗口还不是「我们某个窗口的子窗口」,就把它藏起来。// 这样无论模拟器是在开机、预热,还是 ApkStart 已经退出(窗口被系统重新挂到桌面,// 恢复成顶层窗口),用户都不会看到那个叫 "Android Emulator - apkstart5554" 的黑窗。@@ -433,6 +459,7 @@ public class ApkAgentif (!embedded && e != IntPtr.Zero && IsWindowVisible(e)) ShowWindow(e, 0);HideToolWindows();HideConsoleWindows();+ HideStrayWindows();if (!embedded && e != IntPtr.Zero) _bootHideUntil = Environment.TickCount + 5000;}diff --git a/src/main.js b/src/main.jsindex bd115a7..61d1a2f 100644--- a/src/main.js+++ b/src/main.js@@ -542,6 +542,10 @@ function buildTray() {tray.setContextMenu(menu);};tray.setToolTip('ApkStart — 安卓应用运行器');+ // Windows 托盘的惯例是单击就打开主窗口(双击当然也可以)。+ // 之前只绑了 double-click,用户单击没反应,会以为托盘图标坏了。+ // 右键才出菜单,所以这里单击直接 showWindow 不会和菜单冲突。+ tray.on('click', () => showWindow());tray.on('double-click', () => showWindow());refresh();setInterval(refresh, 5000).unref?.();diff --git a/test/auto-test.js b/test/auto-test.jsindex d260a69..cb78aea 100644--- a/test/auto-test.js+++ b/test/auto-test.js@@ -470,6 +470,15 @@ const { AdbClient, friendlyInstallError, friendlyLaunchError } = require('../srcassert(!/ -no-snapshot( |$)/.test(cold), 'wipe 时仍要允许保存新快照(修复网络依赖它)');});+ // 窗口代理脚本里有大量中文注释。PowerShell 5.1 读「无 BOM 的 UTF-8」会按 ANSI 解码,+ // 中文变成乱码后可能把 C# 注释和下一行代码并成一行 —— Add-Type 直接编译失败,+ // 表现就是「窗口代理启动失败 / 应用窗口不嵌入」。这个坑踩过一次,用测试钉住。+ await test('窗口代理脚本必须带 UTF-8 BOM(否则中文注释会让 Add-Type 编译失败)', () => {+ const file = path.join(__dirname, '..', 'src', 'core', 'win', 'agent.ps1');+ const buf = fs.readFileSync(file);+ assert(buf[0] === 0xef && buf[1] === 0xbb && buf[2] === 0xbf, 'agent.ps1 缺少 UTF-8 BOM');+ });+await test('新版 emulator 写的 ram.bin 必须被认作完整快照(否则刚存好的 3GB 会被当空壳删掉)', () => {const { EmulatorEngine } = require('../src/core/emulator');const emu = new EmulatorEngine(path.join(__dirname, '..'));