Skip to content

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

fix(embed): 根治旋转黑边/未填满/点击失效/点不动同意

RoutineMiku928a47769d78
diff --git a/.github/release-notes-v0.4.1.md b/.github/release-notes-v0.4.1.md
new file mode 100644
index 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.json
index 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.js
index 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,左右各 40
const 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.ps1
index 2e34b28..3c38c24 100644
--- a/src/core/win/agent.ps1
+++ b/src/core/win/agent.ps1
@@ -37,6 +37,7 @@ public class ApkAgent
public 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 ApkAgent
static 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 ApkAgent
GetWindowThreadProcessId(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 ApkAgent
int 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 ApkAgent
static 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.js
index 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.js
index cb78aea..c9d8514 100644
--- a/test/auto-test.js
+++ b/test/auto-test.js
@@ -479,6 +479,19 @@ const { AdbClient, friendlyInstallError, friendlyLaunchError } = require('../src
assert(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, '..'));