Windows 上的安卓应用运行器:双击 APK 即装,应用以独立窗口与桌面图标运行,自持 QEMU 运行时
chore(release): v0.3.4
RoutineMikua6cd417dafea
diff --git a/.github/release-notes-v0.3.4.md b/.github/release-notes-v0.3.4.mdnew file mode 100644index 0000000..4642f1d--- /dev/null+++ b/.github/release-notes-v0.3.4.md@@ -0,0 +1,78 @@+## 这一版解决什么++### 1. 打开 ApkStart 会把微信(以及其它 Qt 应用)的窗口弄没++这是上一版最严重的问题。窗口代理原来靠**窗口类名**认自己的窗口:++- `FindEmulator()` 认「类名含 `QWindowIcon`」的窗口 —— 这是**所有 Qt 顶层窗口**的类名;+- `HideToolWindows()` 认「类名含 `QWindowTool`」的窗口 —— 而 Qt 的菜单、表情面板、+ 悬浮小窗用的正是 `QWindowToolSaveBits`;+- 常驻压制每 120ms 扫一轮,扫到就 `ShowWindow(h, 0)`;`embed` / `park` 还会对它 `SetParent`。++微信 4.x 恰好就是 Qt 6(`Weixin.dll` 里有 `QWindowToolSaveBits` / `Qt6` 字符串),+主窗口类名是 `Qt51514QWindowIcon` —— 和模拟器一模一样。于是「打开 ApkStart,+微信窗口消失/被嵌进 ApkStart 变成黑块」就发生了。++**同一台机器上的实测对比**(微信 4.1.7.59,主窗 296×388):++| 版本 | 微信窗口状态 |+|---|---|+| 0.3.3 | 启动 3.7 秒后 `hidden`,之后 74 次采样全部隐藏 |+| 0.3.4 | 45 秒 / 280 秒两轮全程 `visible`,隐藏 0 次 |++**修法:类名不是身份,进程路径才是。**++- 新增 `scope` 命令:主进程在压制/嵌入之前下发「我们的目录」(运行时根目录 + 随包的+ `engine` 目录)和主进程 pid;+- 所有窗口判定先过 `IsOurs(pid)`:进程可执行文件必须落在这些目录之内;+- **没有 scope 时一个窗口都不动** —— 宁可漏一个黑窗,也绝不藏别人的窗口;+- 控制台黑窗不再用「标题含 emulator/qemu/netsim」这种模糊匹配,改成 conhost 的父进程链+ 能走到运行时目录,或标题里出现运行时目录的绝对路径;+- `embed` 校验宿主窗口的 pid 必须等于主进程 pid,否则拒绝(防止句柄回收后把窗口嵌进别人的应用);+- 鼠标钩子里加 `IsWindow(_host)` 与宿主 pid 校验,句柄失效就一律放行;+- 旋转(Ctrl+←/→)只在自己窗口是前台时才发全局按键,否则干脆不发;+- 代理进程重建后重新下发 scope,否则新代理什么都不敢碰。++### 2. Gitee 上也放一个能直接双击解压的整包(不再是 part1/part2)++- 换压缩器:`Compress-Archive`(.NET deflate)→ 7-Zip `-mx=9`,同一目录 **105.2MB → 99.8MB**;+- 删掉包内的 `d3dcompiler_47.dll`(Windows 8.1 起 `System32` 自带同名 DLL,实测渲染无差异),+ 再省 2.1MB;`vk_swiftshader` / `vulkan-1` 保留 —— GPU 驱动不可用时靠它兜底;+- 最终 **95.0 MiB**,在 Gitee 单文件上限(100MB)以内,下载下来直接解压即可;+- 新增 `build/zip.js`:压完用应用自己的 zip 解析器核对条目数与解压总字节,+ **超过 100MiB 直接让 CI 失败** —— 以后包变胖会当场炸,而不是又悄悄退回分片包。++### 3. 「双源自动选优」之前其实没生效++同名资产按名字去重、谁先来用谁,GitHub 排在前面,**Gitee 的同名地址被直接丢掉**。+整包不再分片以后,等于永远只走 GitHub。++- 同名资产改为合并 `urls`,并按地址分别记 `size`(两个源压出来的字节数本来就不同);+- 下载前测速择优;`downloadMulti` 的「只混用声明大小一致的源」改为以**最快那个源**的+ 总大小为基准(原来固定取 `Math.max`,等于总去下体积更大的那个源);+- 实测本机四个候选(GitHub 直连 / ghfast / gh-proxy / Gitee)里最快的是 Gitee,+ 95.2MB / 48 秒(约 2 MB/s)。++### 4. 其它++- 代理的「守窗」判定只认自己运行时里的进程,别的模拟器(MuMu / 雷电自带的 emulator.exe)+ 不会再让代理多守 3 分钟;+- 工具脚本(`check-agent` / `check-console` / `check-windows` / `check-launch-clean` /+ `check-quit-clean`)同步补上 scope。++## 验证记录++| 项目 | 结果 |+|---|---|+| 单元 + 集成测试 | run-tests 3 / auto-test **70 通过,0 失败** |+| 端到端(真实运行时 + 真实 AVD + 红果 APK) | 安装 → 打开 → 嵌入全部通过;应用窗口 0.5 秒出现;泄漏窗口累计 **0** |+| 微信(4.1.7.59)共存 | 模拟器启动 / 装应用 / 嵌入全过程,微信窗口 hidden **0** 次 |+| Gitee 整包 | 95.18 MiB,`Expand-Archive` 5.2 秒解压,69 个文件 md5 与源目录一致 |+| 从 Gitee 实下 | 95.2MB / 48 秒,zip 结构完整 |++## 下载++- 轻量版 `ApkStart-v0.3.4-win64-portable.zip`(**95 MB**,解压即用,首次启动再下运行时):+ GitHub 与 Gitee 都是**一个完整 zip**,不需要再拼接分片。+- 完整版 `ApkStart-0.3.4-Setup.exe`(约 1.35 GB,内置 adb / 模拟器 / 系统镜像,装完即离线可用):+ 体积超过 Gitee 单文件上限,只放在 GitHub。diff --git a/.github/workflows/release.yml b/.github/workflows/release.ymlindex 0b14edf..c1a96c6 100644--- a/.github/workflows/release.yml+++ b/.github/workflows/release.yml@@ -88,7 +88,14 @@ jobs:if (-not $env:GITEE_TOKEN) { Write-Output "未配置 GITEE_TOKEN,跳过 Gitee 同步"; exit 0 }$tag = "${{ github.ref_name }}"if (-not $tag.StartsWith('v')) { $tag = "v$tag" }- node tools/publish-gitee.js $tag --zip "ApkStart-$tag-win64-portable.zip"+ # 发布说明与 GitHub 用同一份,别让 Gitee 那边只剩一句「便携版安装包」+ $notes = ".github/release-notes-$tag.md"+ if (Test-Path $notes) {+ node tools/publish-gitee.js $tag --zip "ApkStart-$tag-win64-portable.zip" --notes $notes+ } else {+ node tools/publish-gitee.js $tag --zip "ApkStart-$tag-win64-portable.zip"+ }+ if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }full:name: 构建完整版(内置运行时,离线开箱即用)diff --git a/package.json b/package.jsonindex 02c2834..cca4030 100644--- a/package.json+++ b/package.json@@ -1,7 +1,7 @@{"name": "apkstart","productName": "ApkStart",- "version": "0.3.3",+ "version": "0.3.4","description": "极致轻量的 Windows 安卓应用运行器:双击 APK 即装,应用以独立窗口与桌面图标运行","main": "src/main.js","author": "RoutineMiku",diff --git a/tools/publish-gitee.js b/tools/publish-gitee.jsindex e546dcc..0633b46 100644--- a/tools/publish-gitee.js+++ b/tools/publish-gitee.js@@ -133,7 +133,7 @@ async function upload(releaseId, file, attempts = 3) {const notesFile = arg('--notes', '');const body = notesFile && fs.existsSync(notesFile)? fs.readFileSync(notesFile, 'utf8')- : `便携版安装包(分片,应用内自动更新会自己拼装)。完整安装版与运行时整包在 GitHub Releases。`;+ : `便携版安装包(单个 zip,解压即用;应用内也能自动更新)。完整安装版与运行时整包在 GitHub Releases。`;console.log('1) 查找/创建发行版', tag);const list = await api('GET', `/releases?per_page=50`);