Windows 上的安卓应用运行器:双击 APK 即装,应用以独立窗口与桌面图标运行,自持 QEMU 运行时
test: 实机全流程验证通过(冷启 23s / 热启 5s / 零窗口泄漏)
RoutineMiku6e560a1504c5
diff --git a/.github/release-notes-v0.3.3.md b/.github/release-notes-v0.3.3.mdindex b5777b2..94c8aa5 100644--- a/.github/release-notes-v0.3.3.md+++ b/.github/release-notes-v0.3.3.md@@ -7,6 +7,8 @@- **多源并行分片**:文件切块后,不同块同时从「GitHub 直连 / ghfast / gh-proxy」拉,带宽叠加。同一台机器实测:**113MB 从 493 秒降到 77 秒**(约 1.5 MB/s,含测速与解压)。+- **低速换源**:某个分块跑到几十 KB/s 时自动中断、换源、从断点继续 —— 以前会「卡在 95% 不动」。+- **分块断点续传**:1.4GB 的运行时包下到一半失败,重新执行只补缺的块,不用从头再来。- **停滞看门狗**:连接建立了但 20 秒不给字节,立刻丢弃这条连接换下一个源,不再傻等 30 秒 socket 超时把整包卡死。- **每次现测现选**:每个候选地址真下 256KB 测速,只算「收到首字节之后」的吞吐@@ -39,6 +41,16 @@- 体积:便携版 230MB(裁掉 52 个用不到的语言包,省 39MB)。- 日志按大小滚动,不再无限增长;共享目录同步不再把同一个文件反复搬来搬去。+## 本次实机验证(同一台机器,Windows 11 + Android 14 Play 镜像)++| 项目 | 结果 |+|---|---|+| 冷启动到可打开应用 | **23–25 秒**(首次含探测约 32 秒) |+| 命中 quickboot 快照 | **5 秒** |+| 安装 APK 并打开应用 | 应用窗口 **1.5 秒**出现(热快照) |+| 开机 45 秒全程可见的模拟器/控制台窗口 | **0 个** |+| 退出 ApkStart 后桌面上残留的窗口 | **0 个** |+## 安装- **完整版** `ApkStart-*-Setup.exe`:自带运行时,装完即用(约 1.4GB)。diff --git a/src/core/provision.js b/src/core/provision.jsindex adc6418..03e6efd 100644--- a/src/core/provision.js+++ b/src/core/provision.js@@ -207,9 +207,16 @@ class Provisioner {const explicitAvd = String(store.getSettings().runtime.avdDir || '').trim();const writable = explicitAvd || path.join(store.DATA_DIR, 'avd');const insideData = root.toLowerCase().startsWith(store.DATA_DIR.toLowerCase());- // 单文件发行版的镜像会展开到用户目录(见 materializeImages),那里有就用那里的+ // 系统镜像放哪儿:**运行时目录优先**。+ // 之前的顺序是「用户数据目录优先」,后果是——用户把运行时目录改到 D 盘省 C 盘空间,+ // 1.4GB 的整包解到 D 盘以后,materializeImages 又把 3.3GB 的 system.img 展开回+ // C://Users//...//AppData//Roaming//apkstart//system-images,C 盘照样被吃掉,而且+ // 同一套镜像在两处各存一份(实测 1.2GB + 3.3GB 并存)。+ // 现在:运行时目录里已经有 system-images(整包解压的产物)就用它;+ // 没有才回退到用户数据目录(老版本、单文件发行版都是这种布局)。+ const rootImg = path.join(root, 'system-images');const dataImg = path.join(store.DATA_DIR, 'system-images');- const sysRoot = fs.existsSync(dataImg) ? dataImg : path.join(root, 'system-images');+ const sysRoot = fs.existsSync(rootImg) ? rootImg : dataImg;return {root,qemuDir: path.join(root, 'qemu'),@@ -709,7 +716,9 @@ class Provisioner {*/async materializeImages(onLog = () => {}) {const srcRoot = path.join(this.root, 'system-images');- const destRoot = path.join(store.DATA_DIR, 'system-images');+ // 展开目标必须和 paths().sysImgRoot 用同一套规则,否则会出现+ // 「整包解到 D 盘、镜像又展开回 C 盘 APPDATA」的重复占用(实测 1.2GB + 3.3GB)。+ const destRoot = this.paths().sysImgRoot;const jobs = [];const copies = []; // 压缩镜像之外的文件(kernel-ranchu / ramdisk / 未压缩 .img 等)必须一并落到展开目录const found = new Map(); // dest -> job(同镜像 .xz/.gz 并存时优先 .xz)@@ -737,6 +746,7 @@ class Provisioner {// 先补齐非镜像文件(模拟器靠 kernel-ranchu 等定位/引导,缺了会报"还差系统镜像")for (const c of copies) {try {+ if (path.resolve(c.src) === path.resolve(c.dest)) continue; // 原地展开,无需复制const have = fileSize(c.dest);if (have > 0 && have === fileSize(c.src)) continue;fs.mkdirSync(path.dirname(c.dest), { recursive: true });diff --git a/tools/check-launch-clean.js b/tools/check-launch-clean.jsindex 042fbd0..e08d827 100644--- a/tools/check-launch-clean.js+++ b/tools/check-launch-clean.js@@ -15,7 +15,9 @@ const { spawn } = require('child_process');const { WinAgent } = require('../src/core/agent');const ROOT = path.join(__dirname, '..');-const ENGINE = path.join(ROOT, 'engine');+// 与另两个窗口测试一样支持外部指定运行时/数据目录(用户的运行时常常在 D 盘)+const ENGINE = path.resolve(process.env.APKSTART_RUNTIME || path.join(ROOT, 'engine'));+const AVD_DIR = process.env.APKSTART_AVD_HOME || '';const ELECTRON = path.join(ROOT, 'node_modules', 'electron', 'dist', 'electron.exe');const APK = process.argv[2] || path.join(os.tmpdir(), 'fdroid.apk');const sleep = (ms) => new Promise((r) => setTimeout(r, ms));@@ -45,7 +47,7 @@ function launch(args, sandbox) {const appData = path.join(sandbox, 'apkstart');fs.mkdirSync(appData, { recursive: true });fs.writeFileSync(path.join(appData, 'settings.json'), JSON.stringify({- runtime: { dir: ENGINE }, engine: { prewarm: true },+ runtime: { dir: ENGINE, avdDir: AVD_DIR }, engine: { prewarm: true },}));const agent = new WinAgent();@@ -67,8 +69,11 @@ function launch(args, sandbox) {if (p.exitCode !== null) break;}check(!!pkg, `安装完成:${pkg || '(超时)'}`);+ // 必须等第一个实例**真正退出**再起第二个:单实例锁还在的话,第二个会立刻退出,+ // 表现为「窗口一直不出现」,而不是启动失败(实测踩过,排查了很久)。try { p.kill(); } catch (_) { /* ignore */ }- await sleep(2500);+ for (let i = 0; i < 30 && p.exitCode === null; i += 1) await sleep(500);+ await sleep(2000);if (!pkg) {agent.dispose();@@ -82,7 +87,8 @@ function launch(args, sandbox) {let leaked = 0;let sawAppWin = false;const titles = new Set();- for (let i = 0; i < 120; i += 1) {+ // 冷启动 23s + 应用拉起 ~17s,留足 120 秒;之前 60 秒在慢机器上会假失败+ for (let i = 0; i < 240; i += 1) {await sleep(500);const r = await agent.call({ cmd: 'windows' }, 5000).catch(() => null);const list = ((r && r.list) || []);@@ -106,11 +112,22 @@ function launch(args, sandbox) {check(leaked === 0, `模拟器/控制台窗口始终不可见(累计 ${leaked} 次)`);check(sawAppWin, `应用窗口已出现(说明画面被嵌进窗口,而不是独立的模拟器窗口)`);console.log(' 可见窗口标题:', JSON.stringify([...titles].slice(0, 12)));+ if (!pass) {+ console.log('--- app.log 末尾 ---');+ try {+ const log = fs.readFileSync(path.join(appData, 'logs', 'app.log'), 'utf8').trim().split('\n');+ console.log(log.slice(-12).join('\n'));+ } catch (_) { console.log('(没有 app.log)'); }+ }try { p.kill(); } catch (_) { /* ignore */ }agent.dispose();await sleep(1500);- try { fs.rmSync(sandbox, { recursive: true, force: true, maxRetries: 3 }); } catch (_) { /* ignore */ }+ if (pass) {+ try { fs.rmSync(sandbox, { recursive: true, force: true, maxRetries: 3 }); } catch (_) { /* ignore */ }+ } else {+ console.log(` 沙盒保留在:${sandbox}`);+ }console.log('');console.log(`结果:${pass ? '通过' : '失败'}`);process.exit(pass ? 0 : 1);