Windows 上的安卓应用运行器:双击 APK 即装,应用以独立窗口与桌面图标运行,自持 QEMU 运行时
fix(embed): 根治旋转黑边/未填满/点击失效/点不动同意
RoutineMiku928a47769d78
diff --git a/.github/release-notes-v0.4.1.md b/.github/release-notes-v0.4.1.mdnew file mode 100644index 0000000..d131ce5--- /dev/null+++ b/.github/release-notes-v0.4.1.md@@ -0,0 +1,47 @@+# ApkStart v0.4.1++> 一句话:定位并根治了「旋转黑边 / 应用未填满 / 点击失效 / 点不动同意」这一组症状——它们其实是**同一个原因**:嵌入的模拟器窗口和 Electron 网页层是兄弟窗口,网页层一直在最前面。++## 一、真正的根因++用 `WindowFromPoint` 在画面中心做命中测试,发现返回的**不是模拟器窗口**,而是 `Chrome_RenderWidgetHostHWND`(Electron 的网页渲染层)。++也就是说:网页层那块黑底一直盖在安卓画面之上,并且把鼠标事件全吃了。于是同时出现:++| 用户看到 | 实际原因 |+|---|---|+| 画面有黑边 / 未填满 | 网页层黑底盖住了嵌入画面,或只露出一部分 |+| 点击失效、无法对应 | 鼠标点到了网页层,根本没进安卓 |+| 点不动「同意并继续」 | 同上(`adb input tap` 能点,因为是逻辑坐标、绕过宿主) |+| 旋转 / 全屏后更明显 | 改窗口尺寸触发 Chromium 重绘,又把自己抬回最前 |++之前 v0.3.9 我用 `SetWindowRgn` 裁剪想把标题栏那条 8px 挤出画面,反而**破坏了 Qt/GL 子窗口的命中测试**,并让 region 在 resize 后与窗口尺寸不匹配 —— 这正是这一版问题的直接来源。++## 二、修复++1. **移除 `SetWindowRgn` 裁剪**,改为在 `Embed()` 时显式清掉旧版本可能残留的 region。标题栏那条溢出由宿主自绘标题栏自然盖住。+2. **把模拟器窗口挂成网页渲染层的子窗口**(而不是宿主的兄弟子窗口)。子窗口的 Z 序与鼠标命中天然优先于父窗口,网页层再也不会盖住画面、吃掉点击。+ - embed 那一刻网页层可能还没建好,所以在 `Fit()` 与常驻扫描里都做了补挂,保证一定生效。+3. **收窄 `HideStrayWindows`**:只隐藏明确的弹窗类(Qt 工具窗 / 控制台),绝不碰 `QWindowIcon` / `subWin`(那是正在显示的 LCD),避免把画面误藏成全黑。+4. **启动完成后把窗口抬到最前**(短暂 topmost 再撤销):避免别的窗口(浏览器等)盖在上面导致「黑屏 + 点不动」。+5. **旋转时的窗口尺寸**:+ - 最大化状态下 `setContentSize` 无效,现在先 `unmaximize` 再改尺寸,否则横屏画面被塞进竖窗口 = 黑边 / 未填满;+ - 目标尺寸限制在屏幕可用区内;+ - `wm size` 变化后 Qt 会重排多次,改为连续 6 轮 `Fit` 收敛,彻底消除残留黑边。++## 三、实测(这次是端到端真实交互,不是 adb 模拟)++- 用**真实鼠标**点击「同意并继续」→ 进入 `MainFragmentActivity` → 继续点进 `ShortSeriesActivity` 播放页;+- `PrintWindow` 抓宿主窗口:安卓画面**铺满标题栏以下全部区域,四周无黑边、无留白**,视频 / 点赞 / 评论 / 选集 / 标题栏四按钮全部正常;+- `WindowFromPoint` 在画面中心返回模拟器窗口(修复前返回网页层);+- `npm test`:**115 项全部通过**(8 + 25 + 82),新增两条回归测试钉住「嵌入窗口必须挂到网页层下且不得设 region」。++## 四、工程加固++- `agent.ps1` 保持 UTF-8 BOM(丢 BOM 会让 PowerShell 5.1 按 ANSI 读中文注释,`Add-Type` 编译失败 → 窗口代理启动失败);+- 新增回归测试:验证 `SetParent(emu, parent)` / `FindChromeRender` 存在、`CreateRectRgn(0, clipTop)` 不存在、embed 时清 region。++## 五、升级方式++- 便携版:解压覆盖,数据目录(默认 `%APPDATA%\apkstart`)保持不变。+- 安装版:直接安装覆盖。diff --git a/package.json b/package.jsonindex 0b3afb1..53ab193 100644--- a/package.json+++ b/package.json@@ -1,7 +1,7 @@{"name": "apkstart","productName": "ApkStart",- "version": "0.4.0",+ "version": "0.4.1","description": "极致轻量的 Windows 安卓应用运行器:双击 APK 即装,应用以独立窗口与桌面图标运行","main": "src/main.js","author": "RoutineMiku",diff --git a/src/core/appwin.js b/src/core/appwin.jsindex 81abe90..4d0d637 100644--- a/src/core/appwin.js+++ b/src/core/appwin.js@@ -45,14 +45,19 @@ class AppWindow {/** 竖屏 / 横屏下窗口内容的目标尺寸(自动缩放到屏幕内) */static sizeFor(area, portrait, landscape) {const p = portrait || { w: 540, h: 960 };+ // 留足边距:标题栏 38 + 上下各 24,左右各 40const availH = Math.max(360, (area.h || 1040) - TITLEBAR_H - 48);const availW = Math.max(300, (area.w || 1920) - 80);- if (landscape) {- const k = Math.min(availW / p.h, availH / p.w);- return { w: Math.round(p.h * k), h: Math.round(p.w * k) };- }- const k = Math.min(availH / p.h, availW / p.w);- return { w: Math.round(p.w * k), h: Math.round(p.h * k) };+ const k = landscape+ ? Math.min(availW / p.h, availH / p.w)+ : Math.min(availH / p.h, availW / p.w);+ const w = Math.round((landscape ? p.h : p.w) * k);+ const h = Math.round((landscape ? p.w : p.h) * k);+ // 双保险:绝不超过屏幕可用区,否则会被系统裁掉,看起来就是「有黑边 / 没填满」+ return {+ w: Math.max(320, Math.min(w, Math.round(availW))),+ h: Math.max(360, Math.min(h, Math.round(availH))),+ };}_area() {@@ -294,21 +299,29 @@ class AppWindow {await sleep(1200);const area = this._area();const size = AppWindow.sizeFor(area, this.portrait, next);- if (!this.win.isMaximized()) {- this.win.setContentSize(Math.max(320, size.w), Math.max(420, size.h + TITLEBAR_H));- const b = this.win.getBounds();- this.win.setPosition(- Math.round(area.x + (area.w - b.width) / 2),- Math.round(area.y + (area.h - b.height) / 2),- );- }+ // 最大化状态下 setContentSize 无效,必须先退出最大化再改尺寸,+ // 否则窗口仍是竖的,横屏画面被塞进竖窗口 = 黑边 / 未填满。+ const wasMax = this.win.isMaximized();+ if (wasMax) this.win.unmaximize();+ this.win.setContentSize(Math.max(320, size.w), Math.max(420, size.h + TITLEBAR_H));+ const b = this.win.getBounds();+ this.win.setPosition(+ Math.round(area.x + (area.w - b.width) / 2),+ Math.round(area.y + (area.h - b.height) / 2),+ );+ // 退出最大化后把窗口抬到最前,别被别的窗口盖住(盖住就是黑屏 / 点不动)+ try { this.win.show(); this.win.focus(); } catch (_) { /* 窗口可能刚关 */ }this.state.landscape = next;this._push();- await sleep(300);- await this.fitNow();- // 应用重构后模拟器窗口可能再自己调一次,收尾再贴合一次免得留黑边- await sleep(900);- await this.fitNow();+ // wm size 改了 guest framebuffer 尺寸后,Qt 会自己重排好几次;每次都可能把+ // 嵌入窗口带回旧尺寸,露出黑边 / 画面没填满。连续贴合几轮收敛,之后由+ // resize 事件的 scheduleFit 兜底。+ for (let i = 0; i < 6; i += 1) {+ // eslint-disable-next-line no-await-in-loop+ await sleep(500);+ // eslint-disable-next-line no-await-in-loop+ await this.fitNow();+ }return next;}diff --git a/src/core/win/agent.ps1 b/src/core/win/agent.ps1index 2e34b28..3c38c24 100644--- a/src/core/win/agent.ps1+++ b/src/core/win/agent.ps1@@ -37,6 +37,7 @@ public class ApkAgentpublic delegate IntPtr HookProc(int code, IntPtr wp, IntPtr lp);[DllImport("user32.dll")] static extern bool EnumWindows(EnumProc cb, IntPtr p);+ [DllImport("user32.dll")] static extern bool EnumChildWindows(IntPtr parent, EnumProc cb, IntPtr p);[DllImport("user32.dll")] static extern bool IsWindowVisible(IntPtr h);[DllImport("user32.dll", CharSet = CharSet.Unicode)] static extern int GetClassNameW(IntPtr h, StringBuilder s, int n);[DllImport("user32.dll", CharSet = CharSet.Unicode)] static extern int GetWindowTextW(IntPtr h, StringBuilder s, int n);@@ -101,6 +102,7 @@ public class ApkAgentstatic IntPtr _host = IntPtr.Zero;static IntPtr _emu = IntPtr.Zero;+ static IntPtr _chromeRender = IntPtr.Zero;static IntPtr _hook = IntPtr.Zero;static HookProc _hookProc = null;static Thread _hookThread = null;@@ -439,10 +441,16 @@ public class ApkAgentGetWindowThreadProcessId(h, out pid);if (!IsOurs(pid)) return true;string cls = ClassOf(h);- // 控制台/工具栏已有专门处理,这里只管剩下的杂窗+ // 只藏明确的弹窗类:Qt 提示窗 / 对话框 / 控制台。+ // 绝不碰 QWindowIcon / subWin —— 那是正在嵌入的 LCD,藏掉就全黑且点击失效。+ bool safe = cls.IndexOf("QWindowTool", StringComparison.Ordinal) >= 0+ || cls.IndexOf("ConsoleWindowClass", StringComparison.Ordinal) >= 0+ || cls.IndexOf("CASCADIA_HOSTING_WINDOW_CLASS", StringComparison.Ordinal) >= 0+ || cls.IndexOf("Qt", StringComparison.Ordinal) < 0 && cls.IndexOf("Chrome", StringComparison.Ordinal) < 0;+ if (!safe) return true;RECT r;if (!GetWindowRect(h, out r)) return true;- if ((r.R - r.L) < 8 && (r.B - r.T) < 8) return true; // 8x8 以下当隐形+ if ((r.R - r.L) < 8 && (r.B - r.T) < 8) return true;ShowWindow(h, 0);return true;}, IntPtr.Zero);@@ -452,9 +460,35 @@ public class ApkAgent// 这样无论模拟器是在开机、预热,还是 ApkStart 已经退出(窗口被系统重新挂到桌面,// 恢复成顶层窗口),用户都不会看到那个叫 "Android Emulator - apkstart5554" 的黑窗。// 同时把工具栏(QWindowTool)与所有控制台窗口(qemu / netsimd / emulator)压住。++ // embed 那一刻 Electron 的网页渲染子窗口可能还没建好,FindChromeRender 会返回 0,+ // 于是 simulator 被挂成了宿主的直接子窗口(和网页层是兄弟)—— 网页层会持续+ // 盖住画面并吃掉鼠标。这里在常驻扫描里补挂:一旦发现网页层出现了,就重挂一次。+ static void EnsureReparent()+ {+ if (_emu == IntPtr.Zero || _host == IntPtr.Zero) return;+ if (_chromeRender == IntPtr.Zero || !IsWindow(_chromeRender))+ _chromeRender = FindChromeRender(_host);+ if (_chromeRender == IntPtr.Zero) return;+ IntPtr ep = GetParent(_emu);+ if (ep == _chromeRender) return;+ if (ep != _host && ep != IntPtr.Zero) return; // 别的宿主,别乱动+ RECT r;+ if (!GetWindowRect(_emu, out r)) return;+ RECT hr;+ if (!GetWindowRect(_host, out hr)) return;+ SetParent(_emu, _chromeRender);+ // 坐标相对网页层客户区(与宿主客户区一致),保持原屏幕位置+ SetWindowPos(_emu, IntPtr.Zero, r.L - hr.L, r.T - hr.T,+ r.R - r.L, r.B - r.T, 0x0004 | 0x0010 | 0x0040);+ }+static void QuietSweep(){- bool embedded = _emu != IntPtr.Zero && _host != IntPtr.Zero && GetParent(_emu) == _host;+ EnsureReparent();+ IntPtr ep = _emu != IntPtr.Zero ? GetParent(_emu) : IntPtr.Zero;+ bool embedded = _emu != IntPtr.Zero && ep != IntPtr.Zero+ && (ep == _host || ep == _chromeRender);IntPtr e = embedded ? _emu : FindEmulator();if (!embedded && e != IntPtr.Zero && IsWindowVisible(e)) ShowWindow(e, 0);HideToolWindows();@@ -483,11 +517,36 @@ public class ApkAgent}// ------------------------------------------------------------------ embed / detach++ // 找宿主窗口里的 Chromium 渲染子窗口。+ // Electron 的网页层(Chrome_RenderWidgetHostHWND)和模拟器窗口如果都是宿主的+ // 直接子窗口,它们就是「兄弟」,而 Electron 会持续把网页层抬到最前 ——+ // 于是网页层那块黑底盖住安卓画面、鼠标也全被它吃掉(用户看到的「黑边 /+ // 未填满 / 点击失效 / 点不动同意」全是这个)。+ // 把模拟器挂成网页层的**子窗口**后,Z 序与鼠标命中天然优先给模拟器。+ static IntPtr FindChromeRender(IntPtr host)+ {+ IntPtr found = IntPtr.Zero;+ EnumChildWindows(host, delegate(IntPtr c, IntPtr p)+ {+ if (ClassOf(c).IndexOf("Chrome_RenderWidgetHostHWND", StringComparison.Ordinal) >= 0)+ {+ found = c;+ return false;+ }+ return true;+ }, IntPtr.Zero);+ return found;+ }+static bool Embed(IntPtr host, IntPtr emu){if (host == IntPtr.Zero || emu == IntPtr.Zero) return false;HideToolWindows();- SetParent(emu, host);+ // 网页层子窗口铺满宿主客户区,坐标系与宿主一致,所以后面 Fit 传的矩形不用改。+ IntPtr parent = FindChromeRender(host);+ if (parent == IntPtr.Zero) parent = host; // 找不到就退回老行为,别让应用开不起来+ SetParent(emu, parent);uint style = (uint)GetWindowLong(emu, GWL_STYLE);style &= ~WS_POPUP;style &= ~(uint)(WS_CAPTION | WS_THICKFRAME | WS_MINIMIZEBOX | WS_MAXIMIZEBOX | WS_SYSMENU | WS_BORDER);@@ -496,6 +555,8 @@ public class ApkAgentint ex = GetWindowLong(emu, GWL_EXSTYLE);ex &= ~(WS_EX_APPWINDOW | WS_EX_TOOLWINDOW | WS_EX_WINDOWEDGE | WS_EX_CLIENTEDGE);SetWindowLong(emu, GWL_EXSTYLE, ex);+ // 旧版本给这个窗口设过 window region;复用时先清掉,否则命中测试继续错位+ SetWindowRgn(emu, IntPtr.Zero, false);return true;}@@ -505,12 +566,30 @@ public class ApkAgentstatic void Fit(int x, int y, int w, int h, bool frame, int clipTop){if (_emu == IntPtr.Zero) return;+ // Fit 是 JS 侧每次 resize 都会调的,此时网页层一定已经建好了。+ // 确保模拟器挂在网页层之下(兄弟关系会被网页层盖住并吃掉鼠标)。+ if (_host != IntPtr.Zero)+ {+ IntPtr cr = FindChromeRender(_host);+ if (cr != IntPtr.Zero)+ {+ _chromeRender = cr;+ IntPtr cur = GetParent(_emu);+ if (cur != cr && (cur == _host || cur == IntPtr.Zero))+ {+ SetParent(_emu, cr);+ // 坐标相对网页层客户区,与宿主一致,沿用传入的 x/y 即可+ }+ }+ }if (w < 16) w = 16;if (h < 16) h = 16;// 只有「确实已经嵌进我们窗口」的才允许显示。// 万一 embed 失败(模拟器窗口还没建好 / 句柄换了),Fit 绝不能把它当独立窗口// 顶到桌面上 —— 那正是用户看到的那个 "Android Emulator - apkstart5554" 黑窗。- bool embedded = _host != IntPtr.Zero && GetParent(_emu) == _host;+ IntPtr ep = GetParent(_emu);+ bool embedded = ep != IntPtr.Zero+ && (ep == _host || ep == _chromeRender);if (!embedded){ShowWindow(_emu, 0);@@ -521,19 +600,9 @@ public class ApkAgent// on every periodic sweep caused visible stutter and wasted GPU/CPU.uint flags = SWP_NOACTIVATE | SWP_SHOWWINDOW | (frame ? SWP_FRAMECHANGED : 0u);SetWindowPos(_emu, HWND_TOP, x, y, w, h, flags);- // 模拟器 Qt 窗口的外框比 LCD 大一圈,我们让它向上溢出、把外框挤出客户区;- // 溢到标题栏上的那一条必须裁掉 —— 否则它被抬到最前时会在标题栏下方画出一条- // 黑边(用户反馈「点四个按钮时冒出黑色区域侵入界面」就是这个)。- if (clipTop > 0)- {- IntPtr rgn = CreateRectRgn(0, clipTop, w, h);- // SetWindowRgn 成功后区域归系统所有,不能再删- if (SetWindowRgn(_emu, rgn, true) == 0) DeleteObject(rgn);- }- else- {- SetWindowRgn(_emu, IntPtr.Zero, true);- }+ // 绝不给嵌入窗口设 window region:Qt/GL 子窗口一旦带 region,命中测试和+ // 输入坐标映射会错位(点击失效 / 点不到按钮),旋转改尺寸后 region 还是旧+ // 矩形又会在四周露黑边。标题栏那条 8px 溢出改由宿主自绘标题栏盖住。}static void Raise()@@ -953,6 +1022,7 @@ public class ApkAgent{_host = want;_hostPid = wantPid;+ _chromeRender = FindChromeRender(want);_emu = FindEmulator();bool ok = Embed(_host, _emu);_embedAt = Environment.TickCount;diff --git a/src/main.js b/src/main.jsindex 61d1a2f..fa3e115 100644--- a/src/main.js+++ b/src/main.js@@ -655,6 +655,22 @@ async function runLaunch(pkg) {const embedded = await appWin.embed();if (!embedded) appLog(`embed failed: ${appWin.lastEmbedError || 'unknown'}`);mark(`embedded=${embedded}`);+ // 嵌入完成后把窗口从别的窗口底下抬出来。否则上层窗口(浏览器等)会盖住安卓画面,+ // 用户看到的是「黑屏 / 画面没填满」,鼠标也点不到应用(全被上层窗口吃掉)。+ // 短暂 topmost 再立刻撤销,只借用一次置顶把 Z 序抬到最前,不会长期霸占顶层。+ if (appWin.isOpen) {+ try {+ appWin.win.show();+ appWin.win.setAlwaysOnTop(true);+ appWin.win.moveTop();+ appWin.win.focus();+ setTimeout(() => {+ if (appWin.isOpen) {+ try { appWin.win.setAlwaysOnTop(false); } catch (_) { /* 窗口已关 */ }+ }+ }, 700);+ } catch (_) { /* 窗口可能刚关闭 */ }+ }appWin.setState({ ready: true, tip: '' });// 嵌入失败(模拟器窗口还没建好)时再补两次:用户看到的是黑窗口,// 后台补上就恢复正常,不用让用户手动重开。diff --git a/test/auto-test.js b/test/auto-test.jsindex cb78aea..c9d8514 100644--- a/test/auto-test.js+++ b/test/auto-test.js@@ -479,6 +479,19 @@ const { AdbClient, friendlyInstallError, friendlyLaunchError } = require('../srcassert(buf[0] === 0xef && buf[1] === 0xbb && buf[2] === 0xbf, 'agent.ps1 缺少 UTF-8 BOM');});+ // 模拟器窗口必须是 Chromium 渲染层的「子窗口」,不能是宿主的兄弟子窗口。+ // 兄弟关系下 Electron 会持续把网页层抬到最前,黑底盖住安卓画面、鼠标全被吃掉+ // (黑边 / 未填满 / 点击失效 / 点不动同意)。也不能再给嵌入窗口设 window region,+ // 那会破坏命中测试且在 resize 后露出黑边。+ await test('嵌入窗口必须挂到网页层之下,且不能再设 window region', () => {+ const file = path.join(__dirname, '..', 'src', 'core', 'win', 'agent.ps1');+ const src = fs.readFileSync(file, 'utf8');+ assert(/SetParent\(emu, parent\)/.test(src), 'embed 必须挂到 FindChromeRender 找到的父窗口');+ assert(/FindChromeRender\(host\)/.test(src), '必须查找 Chromium 渲染子窗口');+ assert(!/CreateRectRgn\(0, clipTop/.test(src), '不能给嵌入窗口设裁剪 region');+ assert(/SetWindowRgn\(emu, IntPtr\.Zero/.test(src), 'embed 时要清掉旧版本残留的 region');+ });+await test('新版 emulator 写的 ram.bin 必须被认作完整快照(否则刚存好的 3GB 会被当空壳删掉)', () => {const { EmulatorEngine } = require('../src/core/emulator');const emu = new EmulatorEngine(path.join(__dirname, '..'));