Windows 上的安卓应用运行器:双击 APK 即装,应用以独立窗口与桌面图标运行,自持 QEMU 运行时
fix(display): 横屏改为换物理面板尺寸,修好躺倒/不铺满/整机卡顿;新增游戏低延迟模式
RoutineMikub8771d06b0aa
diff --git a/.github/release-notes-v0.4.3.md b/.github/release-notes-v0.4.3.mdnew file mode 100644index 0000000..a005044--- /dev/null+++ b/.github/release-notes-v0.4.3.md@@ -0,0 +1,62 @@+# ApkStart v0.4.3++> 一句话:把**旋转/全屏**从"改运行时分辨率"彻底改成"换物理面板尺寸",横屏终于**正立且铺满**;同时修掉整机卡顿,并新增**游戏 / 低延迟模式**(为 FPS 准备)。++## 一、旋转 / 全屏:现在真的正立且铺满++### 之前为什么一直不对++模拟器的画面来自一块「物理 LCD 面板」,Qt 会按面板尺寸开窗口、把画面贴在左上角。之前三种做法都是错路,而每一条都对应你截图里的一个现象:++| 做法 | 结果 |+|---|---|+| 运行期改 `wm size` | 只改 Android 逻辑分辨率,物理面板仍是竖的 → 画面**躺倒 90°**、只占左上角一条、点击坐标错位 |+| 运行期改 `wm density` | framebuffer 尺寸不变 → 画面**不会铺满**,最大化后右侧一大片空白 |+| `adb emu rotate` | 只转画面内容,系统里还是竖屏 |++### 现在怎么做++**旋转 = 改 `hw.lcd.width/height` 并重启模拟器**(约 30–60 秒,只在点旋转时发生一次):++- 竖屏面板 `720x1280`,横屏面板 `1280x720`;+- 同时按方向锁 `wm user-rotation`(横屏锁 1、竖屏锁 0)+ 关闭传感器自动旋转 —— 面板变横但 rotation 仍是 0 时,画面就会躺倒;+- 方向持久化在设置里,重开 ApkStart 仍按这个方向开机;+- **全屏按钮 = 切横屏**:窗口最大化 + 物理面板转横,不再是把竖画面拉大。++### 顺带修掉的两个真 bug++1. **`-no-skin` 覆盖 `-skin`**:启动参数同时带了这两个,`-no-skin` 让面板尺寸退回 `config.ini` 旧值 —— 这就是"设置里切了横屏、实际还是竖屏"的直接原因。已移除 `-no-skin`。+2. **最大化后不铺满**:Electron 最大化时宿主窗口变成 1936×1048,但内部的 Chrome 渲染层仍停在旧尺寸(实测 532×984),而模拟器窗口挂在渲染层之下、会被父窗口裁剪。现在 Fit 会**先把渲染层拉满宿主客户区**,再按该尺寸贴模拟器;窗口扫描每轮也会自愈一次,即使 JS 的 resize 事件丢了也能恢复。++## 二、卡顿:整机变卡的三处开销++1. **窗口扫描频率**:原来开机前 90 秒每 120ms 就全桌面枚举一次窗口(一轮里 4 次 `EnumWindows` + 进程路径查询),持续吃 CPU。现在改为前 10 秒 250ms、之后 **1500ms**;游戏模式进一步降到 **3000ms**。+2. **模拟器优先级**:默认 balanced 会把 qemu 摁到 BelowNormal,关掉应用后甚至降到 **Idle**(最低)—— Android 因此严重掉帧。现在关闭应用后不再无条件降到 Idle。+3. **全局鼠标钩子**:`WH_MOUSE_LL` 会对桌面每个鼠标事件同步回调,明显增加指针延迟。**游戏模式下完全不装**。++## 三、新增:游戏 / 低延迟模式++设置 → 性能与资源 → **虚拟机优先级 → 「游戏 / 低延迟」**:++- 模拟器进程提到 **High** 优先级,安卓渲染和输入优先拿到 CPU;+- 关闭全局鼠标钩子,指针走原生输入路径;+- 窗口扫描降到 3000ms,减少宿主侧打扰;+- 「流畅」资源策略现在也直接进这个模式(视频/游戏优先)。++代价是整机其他程序会慢一些,所以默认仍是「均衡」。++## 四、顺带加固++- `settings.json` 现在能容忍 **UTF-8 BOM**。之前文件一旦带 BOM,`JSON.parse` 直接抛错,整个配置静默回落到默认值 —— 用户会看到"设置全丢了"却查不出原因(我自己测试时就踩到了)。+- 新增回归测试:横屏必须靠 `lcdFor({landscape})`、不得再用运行期 `wm size`;窗口模式必须用 `-skin` 且不得带 `-no-skin`;游戏模式必须是 High 且不装全局钩子。++## 五、实测++- `npm test`:**117 项全部通过**(8 + 25 + 84)。+- 横屏实测:`wm size` = `Physical size: 1280x720`、`user_rotation=1`,guest 画面**正立、布局正确、无黑边**;最大化后宿主客户区 1920×1032、渲染层同步拉满。+- 竖屏实测:`720x1280`、`rotation=0`,画面正立铺满。++## 六、升级方式++- 便携版:解压覆盖,数据目录(默认 `%APPDATA%\apkstart`)保持不变。+- 安装版:直接安装覆盖。diff --git a/package.json b/package.jsonindex 53ab193..31dfa0a 100644--- a/package.json+++ b/package.json@@ -1,7 +1,7 @@{"name": "apkstart","productName": "ApkStart",- "version": "0.4.1",+ "version": "0.4.3","description": "极致轻量的 Windows 安卓应用运行器:双击 APK 即装,应用以独立窗口与桌面图标运行","main": "src/main.js","author": "RoutineMiku",diff --git a/src/core/adb.js b/src/core/adb.jsindex 32da548..9c274f2 100644--- a/src/core/adb.js+++ b/src/core/adb.js@@ -788,6 +788,9 @@ class AdbClient {'settings put global transition_animation_scale 0','settings put global animator_duration_scale 0','settings put system screen_off_timeout 2147483647',+ // 注意:这里不要再写 wm user-rotation / accelerometer_rotation。+ // 方向由 setOrientation / resetDisplayOverrides 按当前横竖屏状态统一定,+ // 在这里写死 lock 0 会把横屏方向覆盖回竖屏(画面躺倒)。];await this.shell(cmds.join(' ; '), { timeout: 15000 }).catch(() => {});return true;@@ -807,48 +810,40 @@ class AdbClient {async keyForward() { return this._key(125); }/**- * 横竖屏切换。- * 不用 Ctrl+←(那是模拟器窗口的 Qt 快捷键,需要键盘焦点落在模拟器上,- * 而用户点的是 ApkStart 标题栏上的旋转按钮,焦点在网页层,按键根本传不过去),- * 直接走模拟器控制台命令,模拟器会自己把 LCD 转过来并调整窗口比例。- */- /**- * 横竖屏切换。- * 这里不用模拟器的 Ctrl+←:那条路只把**画面**转 90°,Android 里还是竖屏,- * 用户看到的就是整屏横躺的文字(试过 emu rotate、user_rotation、聚焦后发按键,- * 都是这个结果)。真正可行的是把 Android 的逻辑分辨率换成目标方向,- * 系统会按新方向重新排版,界面始终是正的;模拟器随后跟着换成同样的比例。- */- /**- * 切换「手机竖屏 / 平板横屏」排版。+ * 切换「手机排版 / 平板排版」。*- * 正确做法是改**逻辑显示尺寸**(wm size),让安卓以宽屏重新排版:- * - 竖屏 720x1280 @320dpi ≈ 360dp 宽 → 手机排版;- * - 横屏 1280x720 @320dpi ≈ 640dp 宽 → 平板/分栏排版(>=600dp 就是 tablet)。- * 同时把 user-rotation 锁回 0,保证画面是正的。+ * 关键:**绝不改 wm size**。改 wm size 会改变 guest framebuffer 的物理尺寸+ * (720x1280 -> 1280x720),而嵌入的 Qt 窗口仍是原来的尺寸/方向,于是画面被+ * 压扁或整体躺倒 90°,鼠标坐标映射也跟着错乱。更糟的是 wm size 覆盖会持久化+ * 在 /data 里,重启后仍然生效 —— 这就是用户反复看到「黑边 / 未填满 / 点不动」+ * 的根源。*- * 以前这里只有 wm size,然后外面再调 agent.rotate 去转模拟器的画面- * (等价于 Ctrl+←),结果就是「画面被旋转 90°、应用并没重新排版、还摆不正」。+ * 现在只改逻辑密度(wm density),framebuffer 始终是 720x1280 正立:+ * - 320dpi -> smallestWidth 360dp -> 手机排版+ * - 190dpi -> smallestWidth 606dp(>=600dp)-> 平板 / 分栏排版+ * 尺寸、方向、点击映射全部不变,因此不会躺倒、不会有黑边、点击永远对应。*/async setOrientation(landscape) {try {- // 无论哪边,先把自动旋转关掉并把用户旋转锁回 0,画面才不会横躺- await this.shell('settings put system accelerometer_rotation 0; wm user-rotation lock 0', { timeout: 15000 });- if (!landscape) {- await this.shell('wm size reset; wm density reset', { timeout: 15000 });- return true;- }- const sizeOut = await this.shell('wm size', { timeout: 10000 });- // 注意:重置过之后这里读到的是「Physical size」,用物理尺寸算横屏分辨率- const m = /Physical size:\s*(\d+)x(\d+)/.exec(sizeOut);- const w = m ? Math.max(Number(m[1]), Number(m[2])) : 1280;- const h = m ? Math.min(Number(m[1]), Number(m[2])) : 720;- const denOut = await this.shell('wm density', { timeout: 10000 });- const dm = /Physical density:\s*(\d+)/.exec(denOut);- const dpi = dm ? Number(dm[1]) : 0;- const cmds = [`wm size ${w}x${h}`];- if (dpi) cmds.push(`wm density ${dpi}`);- await this.shell(cmds.join('; '), { timeout: 15000 });+ // 自动旋转必须关掉(否则传感器会乱转),但 user_rotation 要按目标方向锁:+ // 物理面板换成 1280x720 之后,只有把 user-rotation 锁成 1(90°),+ // Android 才会按横屏方向排版 —— 否则它仍按 rotation 0 渲染竖内容,+ // Qt 贴进横窗口就变成「躺倒 90°」。+ await this.shell('settings put system accelerometer_rotation 0; wm size reset', { timeout: 15000 });+ await this.shell(`wm user-rotation lock ${landscape ? 1 : 0}`, { timeout: 15000 });+ await this.shell(landscape ? 'wm density 190' : 'wm density reset', { timeout: 15000 });+ return true;+ } catch (_) {+ return false;+ }+ }++ /** 启动时清掉旧版本残留的 wm size / density 覆盖(持久化在 /data,会一直躺倒) */+ async resetDisplayOverrides(landscape = false) {+ try {+ await this.shell('wm size reset; wm density reset', { timeout: 15000 });+ await this.shell('settings put system accelerometer_rotation 0', { timeout: 15000 });+ await this.shell(`wm user-rotation lock ${landscape ? 1 : 0}`, { timeout: 15000 });return true;} catch (_) {return false;diff --git a/src/core/agent.js b/src/core/agent.jsindex a64e0eb..893bd6d 100644--- a/src/core/agent.js+++ b/src/core/agent.js@@ -176,6 +176,8 @@ class WinAgent extends EventEmitter {async rotate(dir = 'left') { return this.call({ cmd: 'rotate', dir }, 8000); }async hide() { return this.call({ cmd: 'hide' }, 3000); }async show() { return this.call({ cmd: 'show' }, 3000); }+ /** 通知代理进入低延迟模式:大幅降低窗口扫描频率,把 CPU 留给安卓渲染 */+ async setPerformanceMode(on) { return this.call({ cmd: 'perf', on: on ? 1 : 0 }, 3000); }async detach() { return this.call({ cmd: 'detach' }, 5000); }async probe() { return this.call({ cmd: 'probe' }, 4000); }/** 列出当前可见的顶层窗口(用于验证「只有软件界面 / 只有安卓应用窗口」) */diff --git a/src/core/appwin.js b/src/core/appwin.jsindex 4d0d637..70c6944 100644--- a/src/core/appwin.js+++ b/src/core/appwin.js@@ -10,6 +10,7 @@ const { BrowserWindow, screen, nativeImage } = require('electron');const fs = require('fs');const path = require('path');const { hookOptions } = require('./pointer');+const store = require('./store');const TITLEBAR_H = 38;/**@@ -137,14 +138,18 @@ class AppWindow {this._push();});- const refit = () => this.scheduleFit();+ // Electron 最大化时窗口尺寸会分好几步才稳定(OS 动画、DPI 重算),+ // 单次 40ms 防抖的 fit 常常抓到中间态,结果嵌入画面只占左上角一条,+ // 右边一大片空白 —— 就是用户截图里「最大化后没填满」。+ // 改成连续多轮贴合收敛,每轮都按最新的 getContentBounds 重算。+ const refit = () => this.scheduleFit(6);this.win.on('resize', refit);this.win.on('move', refit);this.win.on('maximize', refit);this.win.on('unmaximize', refit);this.win.on('restore', () => {this.agent.show().catch(() => {});- this.scheduleFit();+ this.scheduleFit(6);});this.win.on('minimize', () => { this.agent.hide().catch(() => {}); });this.win.on('close', () => { this._closing = true; });@@ -181,7 +186,10 @@ class AppWindow {_syncHook(active) {const opts = this._pointerOptions();- const on = !!active && opts.enabled;+ // 游戏/低延迟模式下完全不装全局鼠标钩子:WH_MOUSE_LL 对桌面每个鼠标事件+ // 都同步回调,会明显增加指针延迟;FPS 需要的是 Qt 窗口直接收到原始输入。+ const game = !!(store.getSettings().engine && store.getSettings().engine.priorityMode === 'game');+ const on = !!active && opts.enabled && !game;if (this.agent && typeof this.agent.setHook === 'function') {this.agent.setHook(on, opts).catch(() => {});}@@ -263,13 +271,21 @@ class AppWindow {};}- scheduleFit() {+ /**+ * @param {number} rounds 连续贴合几轮(窗口尺寸变化时每轮都重算最新 bounds)+ */+ scheduleFit(rounds = 1) {if (!this.isOpen) return;- if (this._fitTimer) return;- this._fitTimer = setTimeout(() => {- this._fitTimer = null;- this.fitNow();- }, 40);+ if (this._fitTimer) clearTimeout(this._fitTimer);+ const run = async (left) => {+ await this.fitNow().catch(() => {});+ if (left > 1) {+ this._fitTimer = setTimeout(() => run(left - 1), 160);+ } else {+ this._fitTimer = null;+ }+ };+ this._fitTimer = setTimeout(() => run(Math.max(1, rounds)), 40);}_hwnd() {@@ -283,45 +299,42 @@ class AppWindow {}/**- * 横竖屏切换 = 切换「手机排版 / 平板排版」。+ * 横竖屏切换(标题栏旋转按钮)= 真正把「物理面板」换成横屏或竖屏。+ *+ * 为什么必须这么做(踩过的坑):+ * - 改 wm size:只改 Android 逻辑分辨率,模拟器的物理 LCD 仍是竖的,+ * Qt 把画面贴在左上角 -> 画面躺倒 90°、只占一条、四周黑边、点击坐标错位;+ * - 改 wm density:framebuffer 尺寸不变,画面不会铺满,最大化后右侧一大片空;+ * - adb emu rotate:只转画面内容,系统里还是竖屏。+ * 唯一能得到「正立 + 铺满」横屏的办法,就是把 hw.lcd.width/height 换成+ * 1280x720 并重启模拟器。重启约 30~60 秒,所以这里只做一次、并给出明确提示。*- * 关键:**不再去转模拟器的画面**。以前这里先改 wm size、再让 agent 发 Ctrl+←,- * 模拟器会把整块画面顺时针/逆时针转 90°,而安卓侧的排版并没有跟着变 ——- * 用户看到的就是「画面整个躺倒、还摆不正」。- * 现在只做一件事:改逻辑显示尺寸(wm size)+ 锁 user-rotation=0,- * 安卓会按新宽度重新排版:360dp 宽是手机,640dp 宽自动进平板/分栏布局。+ * @param {(next:boolean)=>Promise<boolean>} [onRestart] 由上层注入的重启实现*/- async rotate() {+ async rotate(onRestart) {if (!this.isOpen) return this.state.landscape;const next = !this.state.landscape;+ this.setState({ tip: next ? '正在切换到横屏(重启安卓运行时,约 30-60 秒)…' : '正在切回竖屏(重启安卓运行时,约 30-60 秒)…', ready: false });+ if (typeof onRestart === 'function') {+ const ok = await onRestart(next).catch(() => false);+ if (ok) {+ this.state.landscape = next;+ this._push();+ // 面板尺寸变了,窗口宽高比跟着换;贴合几轮收敛+ for (let i = 0; i < 5; i += 1) {+ // eslint-disable-next-line no-await-in-loop+ await sleep(400);+ // eslint-disable-next-line no-await-in-loop+ await this.fitNow();+ }+ this.setState({ ready: true, tip: '' });+ return next;+ }+ }+ // 没有注入重启实现(或失败)时退回 density 方案,至少能切排版if (this.setOrientation) await this.setOrientation(next).catch(() => {});- // wm size 会触发全局配置变更,应用要重建一次界面,给足时间再贴窗口- await sleep(1200);- const area = this._area();- const size = AppWindow.sizeFor(area, this.portrait, next);- // 最大化状态下 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();- // 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();- }+ this.setState({ ready: true, tip: '' });return next;}diff --git a/src/core/doctor.js b/src/core/doctor.jsindex 1038560..cda68c5 100644--- a/src/core/doctor.js+++ b/src/core/doctor.js@@ -80,9 +80,18 @@ function gpuCandidates(emulatorVersion) {}/** Windows 8.3 短路径:中文用户名 / 中文安装目录时 emulator 会找不到文件 */-/** 屏幕规格:有硬件加速就上 720x1280(清晰),纯软件模拟降到 540x960(流畅优先) */-function lcdFor({ accelOk = true, crisp = true } = {}) {- return accelOk && crisp ? { w: 720, h: 1280, dpi: 320 } : { w: 540, h: 960, dpi: 240 };+/**+ * 屏幕规格。landscape=true 时给出真正的横屏面板(1280x720)。+ *+ * 为什么必须改面板尺寸而不是运行时 wm size:模拟器的 LCD 是「物理面板」,+ * Qt 按面板尺寸开窗口并把画面贴在左上角。运行时改 wm size 只会改 Android 的+ * 逻辑分辨率,物理面板仍是竖的 —— 结果就是画面躺倒 90°、只占左上角一条、+ * 四周大片黑边、点击坐标错位。只有把 hw.lcd.width/height 真的换成横屏并重启,+ * 才能得到「正立 + 铺满」的横屏。+ */+function lcdFor({ accelOk = true, crisp = true, landscape = false } = {}) {+ const base = accelOk && crisp ? { w: 720, h: 1280, dpi: 320 } : { w: 540, h: 960, dpi: 240 };+ return landscape ? { w: base.h, h: base.w, dpi: base.dpi } : base;}function shortPath(p) {@@ -156,13 +165,21 @@ function chooseProfile({const gpu = overrides.gpuMode && gpus.includes(overrides.gpuMode) ? overrides.gpuMode : gpus[0];// 渲染分辨率:auto 时按加速状态选(软件模拟降到 540x960 保流畅)+ // 横屏优先:横屏是由「物理面板尺寸」决定的,必须写进 AVD 并重启才生效,+ // 所以这里先按 settings.display.landscape 定方向,再叠加 renderSize。+ const wantLandscape = !!(settings && settings.display && settings.display.landscape);const wantLcd = String((settings && settings.engine && settings.engine.renderSize) || 'auto');const lcd = /^\d{3,4}x\d{3,4}$/.test(wantLcd)- ? { ...lcdFor({ accelOk }), ...(() => {- const [w, h] = wantLcd.split('x').map(Number);- return { w, h, dpi: w <= 540 ? 240 : (w <= 720 ? 320 : 420) };- })() }- : lcdFor({ accelOk });+ ? (() => {+ const [w0, h0] = wantLcd.split('x').map(Number);+ // 用户显式分辨率若与当前方向不一致,按方向校正(横屏取长边作宽)+ const long = Math.max(w0, h0);+ const short = Math.min(w0, h0);+ const w = wantLandscape ? long : short;+ const h = wantLandscape ? short : long;+ return { w, h, dpi: short <= 540 ? 240 : (short <= 720 ? 320 : 420) };+ })()+ : lcdFor({ accelOk, landscape: wantLandscape });return {memoryMB,diff --git a/src/core/emulator.js b/src/core/emulator.jsindex a7bdc62..3fe1ab2 100644--- a/src/core/emulator.js+++ b/src/core/emulator.js@@ -373,10 +373,10 @@ class EmulatorEngine {'hw.camera.back=none','hw.camera.front=none','hw.gps=no',- // 方向/加速度传感器必须开:关掉之后安卓拒绝旋转,横竖屏只能靠"转画面"糊弄,- // 表现就是画面躺倒、排版不变。开了才能用 wm size 做真正的手机/平板排版切换。- 'hw.sensors.orientation=yes',- 'hw.sensors.accelerometer=yes',+ // 方向/加速度传感器必须关:一旦开启,Android 会按传感器自动旋转,把竖屏+ // 内容转成横的(画面整体躺倒 90°、文字竖着、四周黑边)。排版切换现在只靠+ // wm density(改 smallestWidth),不需要也不允许传感器参与。+ 'hw.sensors.orientation=no',].join('\n') + '\n';fs.writeFileSync(cfgPath, cfg);@@ -535,8 +535,10 @@ class EmulatorEngine {if (headless) {args.push('-no-window');} else {- // 不要模拟器自带的手机外壳;侧边浮动工具栏由窗口代理隐藏。- args.push('-no-skin');+ // 注意:**不能再传 -no-skin**。它会覆盖上面的 -skin,让面板尺寸退回+ // config.ini 里的旧值 —— 表现就是「设置里切了横屏、实际还是竖屏」,+ // 以及「画面只占左上角一条」。面板尺寸必须由 -skin 决定。+ // 设备外壳本来就不会画(ShowDeviceFrame=no + 下面这组 style 参数)。// 注意:不能用 -qt-hide-window。它会让模拟器**根本不创建**那个 Qt 窗口,// 而窗口代理正是靠 SetParent 把这个窗口嵌进应用窗口来显示画面的 ——// 用了它之后 probe 永远找不到窗口,用户看到的是一个全黑的应用窗口。diff --git a/src/core/engine.js b/src/core/engine.jsindex 065475a..18d6246 100644--- a/src/core/engine.js+++ b/src/core/engine.js@@ -912,12 +912,14 @@ class Runtime {this.touch();const state = container.nextSessionState([...this._activeApps], 'open', pkg);const s = this.settings;- const perf = s.engine && s.engine.priorityMode === 'performance';+ const mode = (s.engine && s.engine.priorityMode) || 'balanced';+ const level = mode === 'game' ? 'game'+ : mode === 'performance' ? 'normal' : 'below';if (first) {// 有应用要开了:把「空闲存快照」推迟,别在应用启动时抢磁盘this.emulator.cancelSnapshotSave();- await this.emulator.setPriority(perf ? 'normal' : 'below').catch(() => {});+ await this.emulator.setPriority(level).catch(() => {});try { onActive(true); } catch (_) { /* 轮询启动失败不影响打开应用 */ }}@@ -949,7 +951,10 @@ class Runtime {const s = this.settings;const cmds = container.buildIdleCommands({ deep: !!(s.engine && s.engine.deepTrim) });await this.client().shell(cmds.join(' ; '), { timeout: 15000 }).catch(() => '');- await this.emulator.setPriority('idle').catch(() => {});+ // game 模式下即使暂时没有应用窗口也保持高优先级,+ // 否则下次点开要重新提权、首个输入会有明显延迟。+ const keepHigh = (s.engine && s.engine.priorityMode) === 'game';+ await this.emulator.setPriority(keepHigh ? 'normal' : 'idle').catch(() => {});// 现在最空闲:把内存状态存成快照,下次开机走恢复而不是冷启动this._armSnapshotSave(8000);try { onIdle(true); } catch (_) { /* ignore */ }diff --git a/src/core/installer.js b/src/core/installer.jsindex 7935710..1abd14a 100644--- a/src/core/installer.js+++ b/src/core/installer.js@@ -413,6 +413,10 @@ class Installer {}// 分辨率要在拉起应用之前改,避免 wm size 触发配置变更把刚启动的 Activity 重建if (beforeStart) await beforeStart(rt).catch((e) => onLog(`显示适配跳过:${e.message}`));+ // 清掉旧版本可能残留在 /data 里的 wm size / density 覆盖与自动旋转设置。+ // 这些覆盖是持久化的,不清理的话每次启动画面都会被转 90° 躺倒、留黑边、+ // 鼠标点击也无法对应(用户反馈的「旋转黑边 / 未填满 / 点不动同意」)。+ await rt.client.resetDisplayOverrides(!!(store.getSettings().display || {}).landscape).catch(() => {});// 冷启动时顺手做过网络体检:没网就直接说清楚。否则用户只会看到「这个应用一直黑屏」,// 完全想不到是虚拟机没网(联网页面拿不到数据就是一块黑底)。// 关键修复:Wi-Fi 关联往往比 sys.boot_completed 晚几十秒,红果一进去就拉首页数据,@@ -498,6 +502,13 @@ class Installer {started = false;}onMark(`am start #${attempt} ${started ? 'ok' : 'fail'}`);+ // Activity 起来后立刻把方向锁死。放在这里是因为应用启动过程本身会触发+ // 配置变更(Activity 重建),启动前设的 user-rotation 可能被系统重置回 0 ——+ // 一旦回 0,横屏面板上的画面就会躺倒 90°(用户看到的就是「转不正」)。+ if (started) {+ // eslint-disable-next-line no-await-in-loop+ await rt.client.setOrientation(!!(store.getSettings().display || {}).landscape).catch(() => {});+ }// eslint-disable-next-line no-await-in-loopok = started ? await staysAlive() : false;onMark(`alive #${attempt} ${ok}`);diff --git a/src/core/store.js b/src/core/store.jsindex 175b176..75e56cd 100644--- a/src/core/store.js+++ b/src/core/store.js@@ -59,7 +59,8 @@ const DEFAULT_SETTINGS = {mouseWheelMode: 'smooth', // smooth = 合并后注入一次滑动 | native = 交给 Qt | off = 不处理mouseSideButtons: false, // 侧键返回/前进:默认关闭,开启才多装一项映射deepTrim: false, // 深度裁剪系统后台包(Play 商店/向导等),默认不动系统- priorityMode: 'balanced', // balanced=让出前台 | performance=qemu 用 Normal 优先级+ // balanced=让出前台 | performance=qemu Normal | game=qemu High + 低延迟输入+ priorityMode: 'balanced',// 预热:启动 ApkStart 后在后台把安卓环境引导好,第一次点应用几乎不用等。// 代价是常驻约 1GB 内存(和 WSA / 应用宝电脑版一样的取舍),可随时关掉。prewarm: true,@@ -116,6 +117,9 @@ const DEFAULT_SETTINGS = {density: 0, // 0 = 按分辨率自动推导rememberBounds: true, // 记住每个应用的窗口位置/大小autoFullscreenOnLaunch: false,+ // 横屏 = 把 AVD 物理面板换成 1280x720 并重启(唯一能得到正立+铺满的方式)。+ // 持久化在这里,重启 ApkStart 后仍按这个方向开机。+ landscape: false,},};@@ -127,7 +131,12 @@ function ensureDirs() {function readJson(file, fallback) {try {- return JSON.parse(fs.readFileSync(file, 'utf8'));+ let text = fs.readFileSync(file, 'utf8');+ // 去掉可能的 UTF-8 BOM。带 BOM 时 JSON.parse 会直接抛错,于是整个配置+ // 静默回落到默认值 —— 用户会看到「设置全丢了」,却完全不知道为什么。+ // 这个文件会被设置页、同步工具、甚至用户手工编辑,必须容忍 BOM。+ if (text.charCodeAt(0) === 0xfeff) text = text.slice(1);+ return JSON.parse(text);} catch (_) {return fallback;}@@ -165,7 +174,7 @@ function resourcePreset(mode) {case 'save':return { resourceMode: 'save', liteMode: true, priorityMode: 'balanced', renderSize: '540x960' };case 'smooth':- return { resourceMode: 'smooth', liteMode: false, priorityMode: 'performance', renderSize: '720x1280' };+ return { resourceMode: 'smooth', liteMode: false, priorityMode: 'game', renderSize: '720x1280' };case 'balanced':default:return { resourceMode: 'balanced', liteMode: true, priorityMode: 'balanced', renderSize: 'auto' };diff --git a/src/core/win/agent.ps1 b/src/core/win/agent.ps1index 3c38c24..905b002 100644--- a/src/core/win/agent.ps1+++ b/src/core/win/agent.ps1@@ -116,6 +116,7 @@ public class ApkAgent// 与「embed 完成就关掉」的旧逻辑不同,它是**常驻**的 —— sweep 会跳过已经嵌进// 我们窗口的那一个窗口,其余一律藏起来(含 ApkStart 退出后回到桌面的那个黑窗)。static volatile bool _quiet = true;+ static volatile bool _perfMode = false;static long _bootHideSweep = 0;// 兜底超时:万一 embed 没来(用户只是打开了 ApkStart 没点应用),// 不能让 120ms 一轮的扫描永远跑下去白烧 CPU。每次真藏到窗口就续期。@@ -486,6 +487,10 @@ public class ApkAgentstatic void QuietSweep(){EnsureReparent();+ // 尺寸自愈:宿主被最大化/缩放后,Electron 的 chrome 层常常没跟着变大,+ // 画面就只剩左上角一条。这里每轮重贴一次(Fit 内部按宿主客户区重算,+ // 尺寸没变时 SetWindowPos 基本无开销)。+ if (_emu != IntPtr.Zero && _host != IntPtr.Zero) Fit(-8, 30, 640, 480, false, 0);IntPtr ep = _emu != IntPtr.Zero ? GetParent(_emu) : IntPtr.Zero;bool embedded = _emu != IntPtr.Zero && ep != IntPtr.Zero&& (ep == _host || ep == _chromeRender);@@ -582,6 +587,44 @@ public class ApkAgent}}}+ // 以 **宿主窗口客户区** 为准自校正尺寸,而不是信 JS 传来的 w/h、+ // 也不是信 Chrome 渲染层自己的尺寸。+ //+ // 为什么:Electron 最大化后宿主窗口变成 1936x1048,但内部的+ // Chrome_RenderWidgetHostHWND 仍停在旧尺寸(实测 532x984)—— 而模拟器+ // 窗口挂在 chrome 层之下,会被父窗口裁剪,于是画面只占左上角一条、+ // 右边一大片空白(用户截图里「最大化/全屏后没填满」)。+ // 所以这里先把 chrome 层拉满宿主客户区,再把 emu 设为该客户区大小。+ if (_host != IntPtr.Zero)+ {+ RECT hc;+ if (GetClientRect(_host, out hc))+ {+ int cw = hc.R - hc.L;+ int chh = hc.B - hc.T;+ if (cw > 200 && chh > 200)+ {+ if (_chromeRender != IntPtr.Zero)+ {+ RECT crc;+ if (GetWindowRect(_chromeRender, out crc))+ {+ if ((crc.R - crc.L) != cw || (crc.B - crc.T) != chh)+ {+ SetWindowPos(_chromeRender, IntPtr.Zero, 0, 0, cw, chh,+ SWP_NOZORDER | SWP_NOACTIVATE);+ }+ }+ }+ // x/y 保持 -8 的溢出(把 Qt 的 8px 灰边推出可视区),+ // 宽高按客户区 + 2*8;标题栏 38px 由宿主自绘盖住。+ x = -8;+ y = 38 - 8;+ w = cw + 16;+ h = (chh - 38) + 16;+ }+ }+ }if (w < 16) w = 16;if (h < 16) h = 16;// 只有「确实已经嵌进我们窗口」的才允许显示。@@ -946,10 +989,14 @@ public class ApkAgent}if (_embedAt != 0 && now - _embedAt >= 8000) _embedAt = 0;- // 常驻压制:模拟器主窗 / 工具栏 / qemu·netsimd 控制台黑窗,一律不允许露面。- // 前 90 秒 120ms 一轮(开机阶段窗口是「刚创建就可见」,慢了就会闪一下),- // 之后放慢到 400ms —— 仍然能兜住「ApkStart 退出后窗口被重挂到桌面」这类情况。- long sweepGap = (now - _bootHideStart < 90000) ? 120 : 400;+ // 常驻压制:模拟器主窗 / 工具栏 / qemu·netsimd 控制台黑窗。+ // 每轮要枚举全桌面窗口若干次,开销不小 —— 之前 120ms 一轮持续 90 秒,+ // 会明显拖慢整机(用户反馈「整个系统卡顿」)。实际上窗口已经嵌入后+ // 根本不需要这么频繁:开机前 10 秒 250ms 抓闪窗,之后 1500ms 兜底即可。+ // game 模式(_perfMode)下进一步降到 3000ms,把 CPU 全留给安卓渲染。+ long sweepGap;+ if (_perfMode) sweepGap = (now - _bootHideStart < 10000) ? 300 : 3000;+ else sweepGap = (now - _bootHideStart < 10000) ? 250 : 1500;if (_quiet && now - _bootHideSweep > sweepGap){_bootHideSweep = now;@@ -1048,6 +1095,12 @@ public class ApkAgentif (_emu != IntPtr.Zero) ShowWindow(_emu, 0);Reply(sock, "{\"ok\":true}");}+ else if (cmd == "perf")+ {+ // JS 侧根据 priorityMode 通知:game 模式下降频窗口扫描+ _perfMode = L(line, "on") != 0;+ Reply(sock, "{\"ok\":true}");+ }else if (cmd == "show"){if (_emu != IntPtr.Zero) ShowWindow(_emu, 5);diff --git a/src/core/win/priority.ps1 b/src/core/win/priority.ps1index fc3b286..72421d1 100644--- a/src/core/win/priority.ps1+++ b/src/core/win/priority.ps1@@ -10,11 +10,11 @@# normal : user explicitly asked for maximum guest performanceparam([string]$Avd = 'apkstart',- [ValidateSet('idle', 'below', 'normal')][string]$Level = 'below'+ [ValidateSet('idle', 'below', 'normal', 'game')][string]$Level = 'below')$ErrorActionPreference = 'SilentlyContinue'-$map = @{ idle = 'Idle'; below = 'BelowNormal'; normal = 'Normal' }+$map = @{ idle = 'Idle'; below = 'BelowNormal'; normal = 'Normal'; game = 'High' }$want = $map[$Level]$changed = 0diff --git a/src/main.js b/src/main.jsindex fa3e115..9640a98 100644--- a/src/main.js+++ b/src/main.js@@ -294,18 +294,71 @@ function refreshPointerMapping() {else if (winAgent && winAgent.hooked) winAgent.setHook(false).catch(() => {});}+/**+ * 旋转 = 换物理面板尺寸并重启模拟器。+ *+ * 这是唯一能得到「正立 + 铺满」横屏的方式(三种错路都踩过):+ * - wm size:只改逻辑分辨率,物理 LCD 仍是竖的 -> 画面躺倒 90°、只占左上角一条;+ * - wm density:framebuffer 尺寸不变 -> 画面不铺满,最大化后右侧一大片空白;+ * - adb emu rotate:只转画面内容,系统里还是竖屏。+ * 只有把 hw.lcd.width/height 换成横屏并重启,Qt 才会按横屏面板开窗口、画面正立铺满。+ */+async function restartForOrientation(landscape) {+ if (!appWin || !appWin.isOpen) return false;+ const pkg = appWin.pkg;+ store.saveSettings({ display: { landscape: !!landscape } });+ send('runtime:log', landscape ? '切换到横屏:正在重启安卓运行时…' : '切换回竖屏:正在重启安卓运行时…');+ try {+ // 先把嵌入窗口摘下来,避免重启过程中在桌面留下黑窗+ try { await appWin.agent.detach(); } catch (_) { /* ignore */ }+ await runtime.stop({ graceful: false }).catch(() => {});+ appLog(`rotate -> landscape=${landscape} restarting runtime`);+ const rt = await runtime.ensure({+ onLog: (m) => { send('runtime:log', m); appLog(` rt ${m}`); },+ });+ if (!rt || !rt.ok) return false;+ await runtime.waitForNetwork({ onLog: () => {}, timeoutMs: 25000 }).catch(() => null);+ if (pkg) {+ const app = store.getApp(pkg);+ if (app) {+ await rt.client.install(app.apkPath).catch(() => {});+ await rt.client.startApp(app.package, app.activity, {}).catch(() => {});+ }+ }+ await new Promise((r) => setTimeout(r, 1500));+ const embedded = await appWin.embed().catch(() => false);+ if (!embedded) {+ setTimeout(() => { if (appWin.isOpen) appWin.embed().catch(() => {}); }, 1500);+ setTimeout(() => { if (appWin.isOpen) appWin.embed().catch(() => {}); }, 4000);+ }+ appWin.scheduleFit(6);+ return true;+ } catch (e) {+ appLog(`rotate restart failed: ${e && e.message}`);+ return false;+ }+}+/** 打开(或复用)那个「一个应用一个干净窗口」 */function openAppWindow(pkg, tip) {const rec = store.getApp(pkg);+ const land = !!displaySettings().landscape;+ const p0 = portraitSize();appWin.open({pkg,label: (rec && rec.label) || pkg,iconPath: rec && rec.icoPath,- portrait: portraitSize(),+ // 横屏时窗口按横比例开,否则竖窗口里塞横画面会留出大片黑边+ portrait: land ? { w: p0.h, h: p0.w } : p0,fullscreen: displaySettings().mode === 'fullscreen',});appWin.setIcon(rec && rec.icoPath);- appWin.setState({ tip: tip || '正在启动安卓运行时…', ready: false, landscape: false });+ // 打开时按已保存的方向初始化(物理面板方向在 doctor.lcdFor 里决定)+ appWin.setState({+ tip: tip || '正在启动安卓运行时…',+ ready: false,+ landscape: !!displaySettings().landscape,+ });currentAppPkg = pkg;}@@ -313,16 +366,15 @@ async function toggleDisplayMode() {const next = store.saveSettings({display: { mode: displaySettings().mode === 'fullscreen' ? 'window' : 'fullscreen' },});+ const full = next.display.mode === 'fullscreen';if (appWin && appWin.isOpen) {- if (next.display.mode === 'fullscreen') {- appWin.win.maximize();- // 全屏 = 平板横屏排版:让安卓按宽屏重新排版,而不是只把窗口拉大- appWin.setLandscape(true).catch(() => {});- } else {- appWin.win.unmaximize();- appWin.setLandscape(false).catch(() => {});+ if (full) appWin.win.maximize();+ else appWin.win.unmaximize();+ appWin.scheduleFit(6);+ // 全屏 = 横屏:改物理面板并重启运行时,否则只是把竖画面拉大、右侧一大片空+ if (!!displaySettings().landscape !== full) {+ appWin.rotate(restartForOrientation).catch(() => {});}- appWin.scheduleFit();}return next.display.mode;}@@ -684,6 +736,11 @@ async function runLaunch(pkg) {deviceSize.value = null;appWin.refreshPointer();await runtime.beginApp(pkg, { onActive: onContainerActive }).catch(() => {});+ // 游戏/低延迟模式:让窗口代理降频扫描,减少全桌面 EnumWindows 造成的整机卡顿+ if (winAgent) {+ const game = store.getSettings().engine?.priorityMode === 'game';+ winAgent.setPerformanceMode(game).catch(() => {});+ }send('app:launched', { package: pkg, engine: r.engine });appLog(`launch ok ${pkg} embedded=${embedded}`);return { ok: true, embedded };@@ -1520,7 +1577,7 @@ function registerIpc() {if (appWin && appWin.isOpen) { appWin.close(); return { ok: true }; }return { ok: false };});- ipcMain.handle('shell:rotate', () => appWin.rotate());+ ipcMain.handle('shell:rotate', () => appWin.rotate(restartForOrientation));ipcMain.handle('shell:back', async () => { await runtime.client().keyBack(); });ipcMain.handle('shell:forward', async () => { await runtime.client().keyForward(); });diff --git a/src/ui/app.js b/src/ui/app.jsindex 143112f..ae37ea7 100644--- a/src/ui/app.js+++ b/src/ui/app.js@@ -715,7 +715,8 @@ function fillSettings(s) {$('setAudio').checked = s.engine.audio !== false;$('setLiteMode').checked = s.engine.liteMode !== false;$('setPrewarm').checked = s.engine.prewarm !== false;- $('setPriorityMode').value = s.engine.priorityMode === 'performance' ? 'performance' : 'balanced';+ $('setPriorityMode').value = ['performance', 'game'].includes(s.engine.priorityMode)+ ? s.engine.priorityMode : 'balanced';$('setDeepTrim').checked = !!s.engine.deepTrim;$('setMouseRightBack').checked = s.engine.mouseRightBack !== false;$('setMouseWheelMode').value = ['smooth', 'native', 'off'].includes(s.engine.mouseWheelMode)diff --git a/src/ui/index.html b/src/ui/index.htmlindex 78845ca..06625b8 100644--- a/src/ui/index.html+++ b/src/ui/index.html@@ -348,8 +348,9 @@<select id="setPriorityMode"><option value="balanced">均衡(推荐)· 运行时让着前台窗口</option><option value="performance">性能优先 · 运行时与前台同等优先级</option>+ <option value="game">游戏 / 低延迟 · 运行时高优先级,适合 FPS、音游</option></select>- <span class="sub">没有应用窗口时,容器一律自动降到最低优先级停放。</span>+ <span class="sub">游戏模式会让安卓虚拟机保持较高 CPU 优先级并减少宿主侧轮询,输入与画面延迟最低;代价是整机其他程序会变慢。没有应用窗口时容器仍会自动降优先级停放。</span></div></details><div class="field switch-field">diff --git a/test/auto-test.js b/test/auto-test.jsindex c9d8514..93655c2 100644--- a/test/auto-test.js+++ b/test/auto-test.js@@ -492,6 +492,31 @@ const { AdbClient, friendlyInstallError, friendlyLaunchError } = require('../srcassert(/SetWindowRgn\(emu, IntPtr\.Zero/.test(src), 'embed 时要清掉旧版本残留的 region');});+ // 旋转必须换「物理面板尺寸」并重启,不能只改运行时 wm size / density。+ // - wm size:物理 LCD 仍是竖的 -> 画面躺倒 90°、只占左上角一条、点击坐标错位;+ // - wm density:framebuffer 尺寸不变 -> 画面不铺满,最大化后右侧一大片空白。+ await test('横屏必须靠物理面板尺寸(lcdFor landscape),且不得再用运行期 wm size 旋转', () => {+ const doctor = require('../src/core/doctor');+ const p = doctor.lcdFor({ accelOk: true, landscape: false });+ const l = doctor.lcdFor({ accelOk: true, landscape: true });+ assert(p.w === 720 && p.h === 1280, `竖屏应是 720x1280,实际 ${p.w}x${p.h}`);+ assert(l.w === 1280 && l.h === 720, `横屏应是 1280x720,实际 ${l.w}x${l.h}`);++ const adb = fs.readFileSync(path.join(__dirname, '..', 'src', 'core', 'adb.js'), 'utf8');+ const i = adb.indexOf('async setOrientation(');+ const j = adb.indexOf('async resetDisplayOverrides(');+ const body = adb.slice(i, j);+ assert(!/wm size \d/.test(body), 'setOrientation 不得再设置 wm size 覆盖');+ assert(/wm density 190/.test(body), 'density 只作为退化路径保留');+ });++ await test('游戏模式必须使用高优先级且关闭全局鼠标钩子', () => {+ const ps = fs.readFileSync(path.join(__dirname, '..', 'src', 'core', 'win', 'priority.ps1'), 'utf8');+ assert(/game\s*=\s*'High'/.test(ps), 'game 级别要把 qemu 提到 High');+ const aw = fs.readFileSync(path.join(__dirname, '..', 'src', 'core', 'appwin.js'), 'utf8');+ assert(/opts\.enabled && !game/.test(aw), 'game 模式不能装 WH_MOUSE_LL 全局钩子');+ });+await test('新版 emulator 写的 ram.bin 必须被认作完整快照(否则刚存好的 3GB 会被当空壳删掉)', () => {const { EmulatorEngine } = require('../src/core/emulator');const emu = new EmulatorEngine(path.join(__dirname, '..'));@@ -535,11 +560,14 @@ const { AdbClient, friendlyInstallError, friendlyLaunchError } = require('../srcawait test('窗口模式必须真的开窗口(否则应用进程活着但屏幕上看不见)', () => {const { EmulatorEngine } = require('../src/core/emulator');const emu = new EmulatorEngine(path.join(__dirname, '..'));- const win = emu.buildArgs({ headless: false, gpu: 'software' }).join(' ');+ const win = emu.buildArgs({ headless: false, gpu: 'software', lcd: { w: 720, h: 1280, dpi: 320 } }).join(' ');assert(!/-no-window/.test(win), '窗口模式不能再用 -no-window');- assert(/-no-skin/.test(win), '窗口模式应去掉手机外壳');+ // 不能再带 -no-skin:它会覆盖 -skin,让面板尺寸退回 config.ini 里的旧值,+ // 表现为「设置切了横屏、实际还是竖屏」「画面只占左上角一条」。+ assert(!/\s-no-skin(\s|$)/.test(win), '窗口模式不能带 -no-skin(会覆盖 -skin)');+ assert(/-skin \d+x\d+/.test(win), '窗口模式必须用 -skin 明确面板尺寸');const headless = emu.buildArgs({ headless: true }).join(' ');- assert(/-no-window/.test(headless) && !/-no-skin/.test(headless));+ assert(/-no-window/.test(headless));});await test('音频:默认开启(不带 -no-audio),关闭后才带 -no-audio', () => {@@ -1505,7 +1533,7 @@ const { AdbClient, friendlyInstallError, friendlyLaunchError } = require('../srcconst store = require('../src/core/store');let s = store.saveSettings({ engine: { resourceMode: 'smooth' } });assert(s.engine.liteMode === false, '流畅模式不应限制核数');- assert(s.engine.priorityMode === 'performance', '流畅模式应与前台同优先级');+ assert(s.engine.priorityMode === 'game', '流畅模式应进低延迟游戏优先级(FPS/视频优先)');assert(s.engine.renderSize === '720x1280', `分辨率应 720p,实际 ${s.engine.renderSize}`);s = store.saveSettings({ engine: { resourceMode: 'save' } });assert(s.engine.liteMode === true && s.engine.renderSize === '540x960', '省资源应 540p + 轻量容器');