Windows 上的安卓应用运行器:双击 APK 即装,应用以独立窗口与桌面图标运行,自持 QEMU 运行时
fix: 全新安装后点图标只看到安卓桌面(组件名重复拼包名)
RoutineMikucb814ee10109
diff --git a/docs/CODE-WALKTHROUGH.md b/docs/CODE-WALKTHROUGH.mdindex dff5594..a506e50 100644--- a/docs/CODE-WALKTHROUGH.md+++ b/docs/CODE-WALKTHROUGH.md@@ -330,9 +330,9 @@ Node 的 `windowsHide` 管不到 emulator 自己 detached 出来的 `qemu` / `ne### 6.5 本地修复记录(v0.3.5-dev,未发布、未 push)-2026-11-14 第二轮开发:只改本地工作区,`npm test` 由 **98 项增至 110 项全绿**-(run-tests 3→8 + engine-test 25 + auto-test 70→77,新增合成 APK / .xapk 拆分包 /-materializeImages / Zip64 / 更新资产 / 0xC0000005 / 日志边界 / 失败落盘等回归用例),+2026-11-14 第二轮开发:只改本地工作区,`npm test` 由 **98 项增至 113 项全绿**+(run-tests 3→8 + engine-test 25 + auto-test 70→80,新增合成 APK / .xapk 拆分包 /+materializeImages / Zip64 / 更新资产 / 0xC0000005 / 日志边界 / 失败落盘 / 启动组件拼接等回归用例),并跑了一次真实冷启(25s)/ 热启(5s,命中快照)/ 优雅关机(快照已存)端到端验证;**实测 2.15GB 的合成 APK:解析 18ms、进程 RSS 47MB**(旧路径需要约 2.2GB 连续内存),`assoc` 用本机真实注册表做过「备份 → 注册 → 注销 → 还原」闭环@@ -354,6 +354,7 @@ materializeImages / Zip64 / 更新资产 / 0xC0000005 / 日志边界 / 失败落| 12 | 图标:白名单加 jpg、XML 图标递归 3 层、占位图可区分并给软警告 | `apk.js:27-115`、`shortcut.js:109-140`、`installer.js:210-235,289-300` | `.jpg`/adaptive-icon/layer-list 图标不再一律变占位图;真解不出来时告诉用户 || 13 | 安装失败 UI:错误提示统一由 `install:error` 收口并清掉「正在安装」转圈 | `ui/app.js:469-520,1446-1460`、`main.js:566` | issue #21 里「报错了右下角还在加载」 || 14 | 新增「合成 APK」回归测试:自造 AXML 清单 + PNG 图标 + ABI 目录,覆盖 `attributeStart` 基准、非命名空间 `package`、整数属性、启动 Activity 解析;`.xapk` 拆分包与 `materializeImages`(展开/跳过/坏镜像不留半截)另有专门用例 | `test/lib/make-apk.js`、`test/run-tests.js`、`test/auto-test.js` | 真实 APK 夹具缺失时 CI 上 axml/apk 零覆盖;镜像展开是部署最脆的一步 |+| 15 | **全新安装后点图标只看到安卓桌面**:`startApp` 无条件拼 `${pkg}/${activity}`,而 `resolveLauncher`/新装记录里存的是完整组件 `pkg/class` → `am start` 组件变成 `pkg/pkg/class`,系统直接取消(result code=-92)。新增 `componentArg()` 统一两种形式,`parseResolvedActivity()` 容忍尾部空行/priority 行 | `adb.js:105-131,520`、`test/auto-test.js` | 这是实测中发现的**上游已有 bug**(v0.3.4 同样存在),只影响「新装/重装过的应用」,老 apps.json(纯类名)不会触发 |> 仍未做(留给下一轮):`main.js` IPC 拆分、`emulator.js` 拆分、`arsc` config 打分可配置化、> `main.js` 1790 行里的托盘/更新菜单抽离、`arsc.js` 的合成字节用例(`axml.js`/`apk.js`diff --git a/docs/RELEASE-NOTES-NEXT.md b/docs/RELEASE-NOTES-NEXT.mdindex 1c00086..73f5873 100644--- a/docs/RELEASE-NOTES-NEXT.md+++ b/docs/RELEASE-NOTES-NEXT.md@@ -7,7 +7,6 @@## 这一版解决什么### 1. 2GB 以上的 APK 装不了(#21)-旧版解析 APK 时把整个文件读进内存,2GB 以上会直接撞上 Node 的单 Buffer 上限,表现为「点了安装、弹个英文错误、右下角一直转圈」。@@ -83,30 +82,45 @@- 真解不出来时,安装完成提示里会明确说「图标无法解析,快捷方式暂时使用占位图标」,而不是让用户看着一个绿色三角猜。-### 9. 日志滚动边界+### 9. 全新安装后点桌面图标,只看到安卓桌面++实测发现的上游 bug(v0.3.4 也存在):装完应用后 `apps.json` 里记录的启动入口是+「完整组件」(`com.foo.bar/com.foo.bar/.MainActivity`),而启动时又拼了一次包名,+`am start -n` 拿到的是 `com.foo.bar/com.foo.bar/com.foo.bar/.MainActivity`,+系统直接取消启动(日志 `result code=-92`)——窗口里就是安卓桌面。++- 新增 `componentArg()`:完整组件原样使用,纯类名才补包名;两种历史数据都兼容;+- `parseResolvedActivity()` 改为扫全部行(`resolve-activity` 输出末尾常带空行),+ 不再因为最后一行是空串而误判为「解析不到」;+- 实测:重装红果后点桌面图标,`mCurrentFocus` 正确落到+ `com.phoenix.read/...SplashActivity`,窗口里是应用自己的界面(不再是桌面)。++### 10. 日志滚动边界- 日志文件名不以 `.log` 结尾时,滚动会「先删后改名」导致日志丢失;现在直接跳过滚动(宁可日志大一点,也不丢)。-### 10. 其它-+### 11. 其它- 新增「合成 APK」测试夹具(`test/lib/make-apk.js`):自造二进制 AXML 清单 +PNG 图标 + ABI 目录,真实 APK 夹具缺失时解析栈也有覆盖;- 新增/扩充回归用例:Zip64、.xapk 拆分包、materializeImages、更新资产选择、`0xC0000005` 诊断、日志边界、失败记录落盘、WebP 图标降级;-- `npm test` 从 98 项增至 **110 项全绿**。+- `npm test` 从 98 项增至 **113 项全绿**。## 验证记录| 项目 | 结果 ||---|---|-| `npm test` | 110 通过 / 0 失败(8 + 25 + 77) |+| `npm test` | 113 通过 / 0 失败(8 + 25 + 80) || `electron test/electron-integration.js` | ICO / .lnk / WebP 降级全部通过 || 真实冷启动 | 25.0s 就绪(`sys.boot_completed=1`) || 命中快照 | 5~6s || 优雅关机 | `code=0`,`hasSnapshot=true` || 真机 APK 解析 | 红果短剧 7.4.3.32 / `res/b/a3.webp` / arm64-v8a 正确 || 2.15GB APK 解析 | 18ms 完成,进程 RSS 47MB(旧版需把整个 2.2GB 读进内存) |+| 全新安装 + 桌面图标启动 | 重装红果后点图标:`mCurrentFocus` = `com.phoenix.read/...SplashActivity`,窗口内是应用界面(修复前是安卓桌面) |+| 安装链路 | 打包版拖入 153MB APK:22s 完成解析/安装/图标/快捷方式;桌面 + 开始菜单 .lnk 的 Target/Args/Icon 均正确 |+| 窗口不泄漏 | `check-quit-clean`:开机全程 + 退出后 8 秒,可见的模拟器/控制台窗口 **0 个** || 注册表关联 | 本机原关联 `MuMuPlayer.apk`,注册→取消后原样还原 || 打包版 | 226MB 便携包,界面冒烟通过 |diff --git a/src/core/adb.js b/src/core/adb.jsindex 611b5a3..2df8079 100644--- a/src/core/adb.js+++ b/src/core/adb.js@@ -102,6 +102,31 @@ function unstage(staged) {try { fs.rmSync(staged, { force: true }); } catch (_) { /* ignore */ }}+/**+ * 把「Activity」拼成 am start -n 需要的完整组件。+ * 两种形式都要支持:+ * - 纯类名(老版本 apps.json 存的是这种):`MainActivity` / `.MainActivity` → `<pkg>/<activity>`+ * - 完整组件(`cmd package resolve-activity` 的输出):`com.a.b/.Main` → 原样使用+ * 旧实现无条件拼 `${pkg}/${activity}`,遇到完整组件就变成 `pkg/pkg/class`,+ * am start 直接取消(result code=-92),表现是「点图标只看到安卓桌面」。+ */+function componentArg(pkg, activity) {+ const a = String(activity || '').trim();+ if (!a) return '';+ if (a.includes('/')) return a;+ return `${pkg}/${a}`;+}++/** 从 `cmd package resolve-activity --brief` 的输出里取出属于 pkg 的组件(容忍尾部空行/priority 行) */+function parseResolvedActivity(pkg, out) {+ const lines = String(out || '').split(/\r?\n/).map((l) => l.trim()).filter(Boolean);+ for (let i = lines.length - 1; i >= 0; i -= 1) {+ const m = /^([\w.]+)\/([.\w$]+)$/.exec(lines[i]);+ if (m && m[1] === pkg) return `${m[1]}/${m[2]}`;+ }+ return '';+}+/*** adb install 的超时上限本来固定 240s,但 2GB+ 的安装包在慢盘上* 「push + 安装 + dexopt」很容易超过 4 分钟:一旦超时就会被当成安装失败,@@ -470,10 +495,10 @@ class AdbClient {const out = await this.shell(`cmd package resolve-activity --brief ${pkg}`, { timeout: 10000 },);- const m = /([\w.]+\/[.\w$]+)/.exec(String(out).split('\n').pop() || out);- if (m && m[1].startsWith(`${pkg}/`)) {- LAUNCHER_CACHE.set(key, { value: m[1], at: Date.now() });- return m[1];+ const comp = parseResolvedActivity(pkg, out);+ if (comp) {+ LAUNCHER_CACHE.set(key, { value: comp, at: Date.now() });+ return comp;}} catch (_) { /* 落到 monkey */ }return null;@@ -513,8 +538,11 @@ class AdbClient {// 很多应用(红果短剧等)的启动页才做真正的初始化,直接进主 Activity 会// 抛 "had you called RpcService.init",表现为点开闪一下就没了。const resolved = (await this.resolveLauncher(pkg).catch(() => '')) || activity;- const intent = resolved- ? ['-n', `${pkg}/${resolved}`]+ // resolved 可能是完整组件(pkg/class),也可能只是类名(老 apps.json);+ // 这里统一成 am start -n 要的完整组件,避免 pkg/pkg/class 被系统取消。+ const comp = componentArg(pkg, resolved);+ const intent = comp+ ? ['-n', comp]: ['-a', 'android.intent.action.MAIN', '-c', 'android.intent.category.LAUNCHER', '-p', pkg];const modes = freeform? [['--windowingMode', '5'], []]@@ -842,4 +870,7 @@ class AdbClient {}}-module.exports = { AdbClient, AdbError, parseStatList, friendlyInstallError, friendlyLaunchError };+module.exports = {+ AdbClient, AdbError, parseStatList, friendlyInstallError, friendlyLaunchError,+ componentArg, parseResolvedActivity,+};diff --git a/test/auto-test.js b/test/auto-test.jsindex 67b92ff..f1a89b2 100644--- a/test/auto-test.js+++ b/test/auto-test.js@@ -1636,6 +1636,22 @@ const { AdbClient, friendlyInstallError, friendlyLaunchError } = require('../srcassert(fallback.length === emu._log.length, `空轮次应退回整体日志,实际 ${fallback.length} 行`);});+ await test('启动组件拼接:完整组件不能重复拼包名(否则点图标只看到安卓桌面)', () => {+ const { componentArg, parseResolvedActivity } = require('../src/core/adb');+ // 完整组件(v0.3.4 装完后 apps.json 里存的就是这种)→ 原样使用+ assert(componentArg('com.phoenix.read', 'com.phoenix.read/com.dragon.read.pages.splash.SplashActivity')+ === 'com.phoenix.read/com.dragon.read.pages.splash.SplashActivity', '完整组件应原样返回');+ // 老数据:纯类名 / 以点开头的类名 → 补包名+ assert(componentArg('com.a.b', 'MainActivity') === 'com.a.b/MainActivity');+ assert(componentArg('com.a.b', '.MainActivity') === 'com.a.b/.MainActivity');+ assert(componentArg('com.a.b', '') === '', '空 activity 应返回空(走隐式 intent)');+ // resolve-activity 输出末尾常有空行/priority 行:必须能取到组件+ const out = 'priority=0\ncom.phoenix.read/com.dragon.read.pages.splash.SplashActivity\n\n';+ assert(parseResolvedActivity('com.phoenix.read', out)+ === 'com.phoenix.read/com.dragon.read.pages.splash.SplashActivity', '应跳过空行取到最后一行组件');+ assert(parseResolvedActivity('com.other', out) === '', '别的包名不能拿来用');+ });+console.log(results.join('\n'));console.log(`\n结果:${passed} 通过,${failed} 失败\n`);try { fs.rmSync(TMP, { recursive: true, force: true }); } catch (_) { /* ignore */ }