Skip to content

Windows 上的安卓应用运行器:双击 APK 即装,应用以独立窗口与桌面图标运行,自持 QEMU 运行时

fix(launch): 修掉「红果打不开」的回归;托盘单击开主界面;压启动耗时与杂窗

RoutineMikuca635e5a7188
diff --git a/.github/release-notes-v0.4.0.md b/.github/release-notes-v0.4.0.md
new file mode 100644
index 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.json
index 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.js
index 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.js
index 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.ps1
index 37ff07e..2e34b28 100644
--- a/src/core/win/agent.ps1
+++ b/src/core/win/agent.ps1
@@ -422,6 +422,32 @@ public class ApkAgent
return 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 ApkAgent
if (!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.js
index 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.js
index d260a69..cb78aea 100644
--- a/test/auto-test.js
+++ b/test/auto-test.js
@@ -470,6 +470,15 @@ const { AdbClient, friendlyInstallError, friendlyLaunchError } = require('../src
assert(!/ -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, '..'));