Windows 上的安卓应用运行器 —— 让安卓应用像 Windows 原生软件一样被安装和使用。

• 🖱️ 双击 .apk 即安装：注册 .apk 文件关联后，在资源管理器里双击 APK，自动解析 → 安装 → 生成桌面图标，全程无需打开任何模拟器界面。
• 🧩 每个应用一个桌面图标：图标从 APK 内部离线提取并转为多尺寸 ICO，双击桌面图标 = 直接启动该应用，与打开一个原生 Windows 软件的体验一致。
• 🪟 应用就是一个窗口：运行时以带窗口模式启动（无头模式下 Android 不出 VSYNC，应用进程活着但屏幕上是空的），ApkStart 把这块窗口改标题、换真实应用图标、按竖屏比例摆好位置，就是一个独立应用窗口；全屏铺满屏幕高度并居中，窗口模式可自由拖动缩放且按应用记忆尺寸。
• 🔍 能被 Windows 搜到：安装后同时创建桌面 + 开始菜单（程序\ApkStart\）快捷方式，按应用名在开始菜单搜索即可直达，任务栏按应用分组。
• 📁 数据互通：%USERPROFILE%\ApkStartShared ↔ 安卓内 /sdcard/ApkStartShared 持续双向同步，安卓应用存下的文件直接出现在本机。
• 🪶 极致轻量：壳层本身零第三方依赖（连 ZIP / PNG / ICO / AXML 解析都是手写的），运行时按需拉起，空闲自动回收；也可以完全复用你机器上已有的安卓运行时，额外占用为零。

┌────────────────────────────────────────────────────────────┐
│  桌面图标（真实应用图标 .lnk）                              │
│      │  双击                                               │
│      ▼                                                     │
│  ApkStart.exe --launch <包名>                              │
│      │  运行时未启动？→ 自动拉起（Android Emulator + API34）│
│      ▼                                                     │
│  按系统解析出的 LAUNCHER 入口启动（不是 APK 里的主 Activity）│
│      │  存活观察 18 秒，闪退自动重试 / 重置数据 / 补权限     │
│      ▼                                                     │
│  模拟器窗口 = 应用窗口（改标题、换图标、竖屏比例、全屏居中） │
└────────────────────────────────────────────────────────────┘

到 Releases 下载安装包：

• ApkStart-v*-Setup.exe（约 1.3 GB）：一个 EXE 包含全部运行时（adb / Android Emulator / 系统镜像），装完首次启动自动把镜像展开到用户目录，之后不再联网下载任何东西。装到当前用户目录、不要求管理员权限。
• 另有轻量版 ApkStart-v*-win64-portable.zip（约 100 MB）：首次启动才在后台下载运行时。运行时的下载源就是本项目的 GitHub Release（ApkStart-runtime-*.zip 整包），不走 dl.google.com；整包拿不到时才自动退回官方源。

设置 → 软件更新 → 「检查更新」，或托盘右键 → 「检查更新」。发现新版本后点「立即更新」即可：

• 安装版下载 ApkStart-v*-Setup.exe 静默安装；
• 轻量版下载 ApkStart-v*-win64-portable.zip，解压后覆盖程序目录——运行时目录（%APPDATA%\apkstart\runtime）、已装应用与快照都不在程序目录里，所以更新不会丢东西；
• 替换动作由一段独立 PowerShell 脚本完成（等主进程退出 → 覆盖 → 重新拉起），不会出现「请手动关闭程序」的弹窗，也不会在桌面上残留模拟器窗口。

开箱即有的默认行为（不用去设置里找）：

• 开机自动启动，常驻托盘；双击桌面图标直接进应用。
• 安装 APK 后自动创建桌面 + 开始菜单两份快捷方式，Windows 搜索能直接搜到应用名；老版本漏建的会在启动时自动补齐。
• 应用窗口是原生渲染（非投屏）：全屏铺满屏幕高度并居中、保持手机比例不变形；窗口模式保持竖屏，可自由拖动缩放，每个应用的尺寸单独记忆。随时按 F11 或右键托盘切换。
• 安装后自动授予应用申请的运行时权限，不会卡在系统授权框；应用闪退会自动重试、必要时重置应用数据后再拉起。
• 网络直接用主机的网络：安卓侧走 QEMU 用户态 NAT，出口复用主机的物理网卡，不会在 Windows 上创建任何虚拟网卡 / 虚拟交换机（不需要装驱动、也不多一个网络适配器）。不需要联网下载、不需要改任何网络设置。

# 1. 安装依赖（含 Electron 运行时）
npm install

# 2. 启动并完成运行时部署（一次性下载 adb / Android Emulator / 系统镜像）
npm start

# 3.（可选）注册 .apk 双击安装
npm run assoc:on

# 4. 打包便携版（免安装，可直接分发）
npm run pack
# 产出 dist/ApkStart-win64-portable/ApkStart.exe

如果希望「一个 EXE 发出去，对方双击就能跑，不用等下载」，用这条：

# 先把 engine/ 整理成可分发运行时（system.img 用 xz/LZMA2 极限压缩，3.1GB → 约 1.1GB；
# 同时裁掉 emulator 里用不到的部分：arm64 的 QEMU、Vulkan 后端、多语言包、qsn/自检工具、VR 资源）
npm run runtime

# 再打成安装版 EXE（electron-builder nsis 目标，装到当前用户目录）
npm run build:exe
# 产出 dist/release/ApkStart-<版本>-Setup.exe

体积构成（实测）：Electron 约 180MB、emulator 瘦身后约 480MB、系统镜像 xz 压缩后约 1.1GB， 最终安装包约 1.32GB（相比 gzip 方案省约 490MB）。能再压的硬下限就在 system.img 那条 （它就是安卓系统本身，且是 verity 保护的镜像，无法从外部裁掉 GMS 组件）。 网络默认走主机 NAT，不创建虚拟网卡，所以也不依赖任何额外驱动。

首次启动会把 xz 镜像展开到 %APPDATA%\apkstart\system-images（约 20 秒，只做一次）， 之后每次直接复用。AVD 与已装应用固定存放在 %APPDATA%\apkstart\avd， 即使便携版每次解压到临时目录也不会丢。

ApkStart 是一个自持的项目，运行时组件全部由自己下载、校验和管理（位于 %APPDATA%\apkstart\runtime）。 轻量版默认从本项目的 GitHub Release 下载整包（ApkStart-runtime-*.zip），拿不到才退回下表里的官方源：

首次使用时，「运行时」页会引导完成以上部署（一键部署）：

1. adb 与运行时引擎、系统镜像自动下载（官方源实测 10+ MB/s）；
2. 部署完成后自动开机，之后双击桌面图标自动拉起，全程无感。

设备兼容性（自动处理，无需干预）

• 没有硬件加速时自动回退软件模拟；启动失败按「渲染后端 → 加速方式 → 内存/冷启动」最多 4 组参数自动重试。
• -gpu 按引擎版本自动选择（37.x 用 software，老版本用 swiftshader_indirect），不再使用已弃用的模式。
• 内存/核心数按物理内存自动推导（2–4 GB / 2–4 核），数据分区从 16 GB 降到 4 GB；端口动态挑空闲的，中文路径自动转短路径，AVD 锁文件自动清理。
• 失败原因会翻译成中文并附上修复建议；设置里可「导出诊断报告」。
• 大文件下载默认 8 线程分块 + 断点续传，不支持 Range 的源自动回退单流。
• 高级用户也可以在设置里切换为「连接已有运行时」（复用 WSA 等的 adb 端口），但这只是可选项，不是依赖。
• 高级路径：也可以在设置里「连接已有运行时」，复用你机器上其它模拟器（WSA / MuMu 等）已经跑起来的 adb 端口。

容器式低成本运行

• 只读基础层：system-images/ 全机一份，所有应用共享，不再同时存 AOSP + 兼容两套镜像。
• 薄可写层：单个 AVD 用差量用户数据 + 命名 quickboot 快照；关闭最后一个应用窗口后（空闲时）把内存状态存成快照，下次开机走恢复而不是冷启动。
• 空闲预热（默认开启）：像 WSA / 应用宝电脑版一样，ApkStart 一启动就在后台把安卓环境引导好（窗口全程隐藏），点应用时只剩一次 am start；代价是空闲常驻约 1 GB 内存，设置里可关闭。
• 冷启动提速：加速与引擎版本探测结果落盘缓存（按 exe 指纹失效）、跳过无谓的 wmic 进程枚举、开机探测改为自适应间隔（350ms 起）、guest 侧准备命令合并成一次 adb 往返；一次启动少等 5–10 秒。
• /data 由 ApkStart 自己造：官方系统镜像里的 userdata.img 只是 1 MB 全零占位，真正的格式化原本由 SDK 工具完成 —— 直接拉 emulator.exe 会跳过这一步，于是 /data 挂不上、guest 掉进 recovery 重启循环，表现就是「等好几分钟还是打不开」。现在首次启动会自己生成一份 4 KB block、带 ENCRYPT（文件级加密）与 ext_attr（SELinux 标签）的 ext4，并用自带的 qemu-img + resize2fs 撑到配置的容量。实测冷启动 ~23 秒、命中快照 ~10 秒。
• 快照完整性校验：保存被打断留下的空壳（只有几十字节的 snapshot.pb）会被识别并清理；新版 emulator 写的是 ram.bin（老版本是 ram.img），两种命名都认，不会再把刚存好的 3 GB 快照误判成空壳删掉。
• 命令窗口彻底不出现：qemu 的控制台窗口属于 conhost.exe，pid 和 qemu 对不上，靠 pid 白名单一个都藏不住；模拟器的网络守护进程 netsimd 还会自己再弹一个黑窗。现在改为「启动模拟器之前就打开常驻压制 + 按窗口类名/标题兜底（emulator / qemu / netsim）+ 开机 90 秒内 120ms 扫一次」。
• 打开软件只看到软件界面：模拟器主窗（Android Emulator - apkstart5554）永远不会单独出现在桌面上 —— 它要么被压制隐藏，要么已经被 SetParent 嵌进应用窗口。关掉应用窗口时会先把它从宿主窗口上摘下来并藏好，再销毁宿主（顺序反了 Windows 会把它重新挂到桌面并显示）；应用退出后窗口代理还会继续「守」最多 3 分钟，避免开机途中退出的那台模拟器在几十秒后把黑窗亮出来。
• 按需下载：遇到仅含 ARM 原生库的应用才会补齐通用镜像；.apks / .xapk 拆分包自动用 install-multiple 安装。
• 可回收：构建时裁掉非 x86_64 的 QEMU 目标（约 400 MB）；设置页可清理旧镜像、旧快照、锁文件和遗留 AVD。

apkstart/
├─ src/
│  ├─ main.js              主进程：窗口/托盘/单实例/命令行分发/IPC
│  ├─ preload.js           安全桥接
│  ├─ ui/                  渲染层（原生 HTML/CSS/JS，无框架）
│  └─ core/
│     ├─ zip.js            极简 ZIP 读取器（按需解压）
│     ├─ axml.js           Android 二进制 XML 解析
│     ├─ arsc.js           resources.arsc 资源表解析（应用名/图标路径还原）
│     ├─ apk.js            APK 元信息：包名/版本/启动 Activity/图标/ABI
│     ├─ png.js            零依赖 PNG 编码器 + 程序图标绘制
│     ├─ shortcut.js       多尺寸 ICO 生成 + .lnk 快捷方式
│     ├─ assoc.js          .apk 文件关联（HKCU，免管理员）
│     ├─ adb.js            adb 客户端（安装/启动/同步/截图/…）
│     ├─ engine.js         运行时管理：探测/模拟器托管/空闲回收
│     ├─ sharer.js         本机 ↔ 安卓共享目录双向同步
│     ├─ installer.js      安装流水线编排
│     └─ store.js          应用清单与设置持久化
├─ engine/                 运行时组件下载缓存（emulator / system-images / platform-tools）
├─ tools/platform-tools/   便携 adb 放置处
├─ test/                   单元测试 + Electron 集成测试 + 冒烟截图
├─ build/pack.js           便携版打包
└─ scripts/assoc.js        .apk 关联命令行开关

ApkStart.exe                      打开主界面
ApkStart.exe <路径\to.apk>        安装 APK
ApkStart.exe --launch <包名>      直接启动应用（桌面快捷方式使用此参数）

npm test                                   # 纯 Node 单元测试 + 引擎链路测试（不需要网络）
npm run test:boot                          # 真实引导测试：用 61MB Alpine guest 验证 QEMU 参数/建盘/优雅关机
npm run selftest                           # 运行时自检：装好 Android 后一键验证 安装→启动→截图→共享目录
electron test/electron-integration.js      # ICO / 快捷方式集成测试
electron . --smoke test\shot.png           # 启动应用并截图（界面冒烟）

npm run selftest 是装好系统后的「验收命令」——它会对当前设备依次检查 adb 连接、 Android 版本、freeform 支持、共享目录双向同步，加 --apk 某应用.apk 还会完整走一遍 安装 → 独立窗口启动 → 前台确认 → 截图。

• 不是从零实现的 hypervisor：安卓内核、GPU 转译、ART 运行时是数年级别的工程，本项目选择站在 AOSP/QEMU/adb 的肩膀上，把工程量集中在「原生应用级体验」上——这正是应用宝电脑版、Google Play Games PC 版等产品共同的架构思路。
• 共享目录是同步而非挂载：Windows 无 root 时无法在安卓侧挂载 NTFS 目录，采用秒级双向同步达到同等体验。
• ARM-only 应用 / 字节系应用：设置里开启「ARM 兼容模式」即可切换到 Android 14（API 34）Google Play 镜像（内置新版 ndk_translation 翻译层），仅含 ARM 原生库的应用可以安装运行。实测红果免费短剧（com.phoenix.read，arm64-v8a-only）可正常安装、进入推荐流并播放视频——旧版 API 30 镜像上会因字节系自带非标准 signal handler 触发翻译层保护性断言（DoBadTrampoline SIGABRT），Android 14 镜像的新版翻译层已修复。个别应用自带更深的反模拟检测（如强制校验真实传感器/基带），仍可能受限；安装失败或启动崩溃时 ApkStart 会给出中文说明。

兼容模式下运行红果免费短剧（Android 14 · AEHD 硬件加速）

ApkStart 由 RoutineMiku 开发维护。

• GitHub：https://github.com/RoutineMiku/apkstart
• 微信公众号：扫码关注

Powered by RoutineMiku

欢迎 Issue / PR。壳层保持零第三方依赖，提交前请跑 npm test；细节见 CONTRIBUTING.md。

MIT。发行包只含 ApkStart 自身代码与 Electron 运行时，不分发安卓系统镜像、QEMU 二进制或 Google 组件；这些由用户本机首次启动时从官方源按需下载，遵循各自的许可协议。