Skip to content

Releases

ApkStart v0.6.18

Choose a tag to compare

@github-actions github-actions released this 17 Nov 17:49

修的是什么

设置窗口左上角的两颗按钮——「返回引导」和右上角的「关闭设置 ×」点不了:
按钮看得见、鼠标点上去却没有任何反应(0.6.17 升级后向导会重新出现一次,
从引导里「去设置细调」跳进设置页时,顶栏这两颗按钮最容易被点到)。

根因

主窗口标题栏声明了一条贯穿整个窗口顶部、44px 高的「拖动区」(用来拖动窗口)。
设置页全屏盖上去之后,这条拖动区并不会被覆盖层抵消——浏览器的拖动区按元素
矩形累加/挖除,不看谁画在上面。顶栏这两颗按钮的高度正好落在这 44px 里,
真实鼠标点击被 Windows 当成「拖动窗口」处理,按钮永远收不到点击。

改动

  • 设置页头部整行声明 no-drag:把自己从标题栏拖动区里挖出去,「返回引导」
    和「关闭设置 ×」恢复正常点击;设置页内容区顶部仍可拖动窗口,行为不变。
  • 头部间距:「设置」标题和「返回引导」按钮之间补了 8px 间距,
    之前两者是贴在一起的。
  • 新增 test/ui-click-probe.js(开发机手工跑的诊断工具):注入真实 OS 级鼠标
    点击 + 对比 DOM 命中,专抓「按钮看得见、点不了」这类只有真实事件才能暴露的
    问题。不进 npm test(CI 环境注入真实点击不可重复)。

升级提示

覆盖安装即可,数据与设置全部保留。装完后设置页顶栏按钮即可正常点击。

下载哪个

文件 说明
ApkStart-v0.6.18-win64-portable.zip 轻量便携版,运行时首次启动按需下载
ApkStart-0.6.18-Setup.exe 完整安装包,内置运行时,离线开箱即用
ApkStart-runtime-v0.6.18.zip 运行时整包(便携版下载源,一般不用手动下载)

支持范围

本项目仅支持 Windows 10/11 x64。

ApkStart v0.6.17

Choose a tag to compare

@github-actions github-actions released this 17 Nov 16:57

这是什么版本

上游对齐专项:把原项目 RoutineMiku/apkstart
在 0.4.x~0.5.8 期间修掉的一批真实故障和补上的两个功能,逐项移植到本项目。
全部按本项目自己的架构重写适配(不是 merge),原有功能与手动配置行为一律不变。

修的是什么(5 个真实故障)

  • 「允许 USB 调试」授权对话框卡开机,之后每次都卡(上游 0.5.2 期间修复):
    冷启动时弹出的授权对话框没人点,程序会存下一份「未授权状态」的快速启动快照;
    之后每次恢复这份毒快照都卡满 240 秒×4 组参数,最后还误报成显卡/虚拟化问题。
    现在开机探测能识别授权卡住,自动作废旧快照并冷启动重新注入调试授权,
    诊断也会如实告诉你「是授权没完成」,不再往显卡方向带偏;关机时 guest 不健康
    就不再存快照,从源头掐断毒快照的产生。
  • 应用「假已装」导致启动失败:分片 APK(.apks/.xapk 装出来的)只要丢了一片,
    PackageManager 仍会谎报「已安装」,点开就失败。现在安装判断会逐分片核对文件
    真实存在,配合已有的「启动失败自动重装」把这类现场兜住。
  • 单源并行下载写坏文件:从单个源分块并行下载时(整包下载的常用路径),
    只检查了 HTTP 206、没有校验返回的 Content-Range —— 服务器返回错位/越界数据时
    照样落盘,最后表现为「校验失败」或运行时莫名崩溃。现在与多源路径同强度校验。
  • 大安装包撑爆数据分区才发现:几十 GB 的游戏装到一半才报「空间不足」。
    现在安装前按「安装包 ×1.8 + 2GB」估算真实写入量,不够就直接告诉你
    「需要多少、只剩多少」,去设置里扩容数据分区再装。
  • 运行时下载失败后每次启动都重试 1.4GB:断网/限流导致整包下载失败后,
    老版本每次启动都会再试一次大下载。现在失败后进入 30 分钟冷却,
    手动点安装不受影响。

新增

  • 中文输入法:随包内置 AOSP 谷歌拼音输入法(上游 0.5.0 同款),首次开机静默安装
    并设为默认 —— 系统汉化之后终于能在安卓里打中文了。已装就跳过,不会覆盖你手动
    换的输入法;不想用可在设置里关掉(自动配置)。
  • guest 内 Wi-Fi 网卡显式拉起(hw.wifi=yes):修少数机器上「虚拟机开了但
    应用一直网络错误」的现场。

升级提示

覆盖安装即可,已装应用、存档、设置全部保留。中文输入法会在下一次开机时自动装好
(日志里能看到「中文输入法:已安装并启用」);如果你的镜像开着「预装精简」,
拼音输入法已在永久保护名单里,不会被精简掉。

下载哪个

文件 说明
ApkStart-v0.6.17-win64-portable.zip 轻量便携版,运行时首次启动按需下载
ApkStart-0.6.17-Setup.exe 完整安装包,内置运行时,离线开箱即用
ApkStart-runtime-v0.6.17.zip 运行时整包(便携版下载源,一般不用手动下载)

支持范围

本项目仅支持 Windows 10/11 x64。

ApkStart v0.6.16

Choose a tag to compare

@github-actions github-actions released this 17 Nov 11:13

修的是什么

「设置 → 软件更新」里点重启并安装没反应:更新包明明已经下好了,按钮也变成了「重启并安装」,
点下去后 ApkStart 关了、版本却还是旧的,也不会自己重新打开。

根因

负责「替换程序 + 重新拉起」的 PowerShell 脚本,是从 ApkStart 里当子进程启动的。
ApkStart 一退出,系统会把这个子进程一起收走 —— 脚本刚写下第一行日志就死了,安装器根本
没机会跑。现场日志很直接:update.log 里只有一行 updater start,之后什么都没有。

改动

  • 脚本不再挂在 ApkStart 下面:改成 .cmd 启动器交给资源管理器拉起,进程关系和 App 断开。
    实测父进程退出后,脚本能把整套「备份 → 安装 → 核对版本 → 重新拉起」跑完。
  • 脚本带 BOM 落盘:PowerShell 5.1 用 -File 读无 BOM 的 UTF-8 会按 GBK 解释,
    用户名或安装路径含中文时整段脚本会被读坏。
  • 自动更新真的会自动装了:原来「应用更新」在 updateBusy 期间被守卫直接 return,
    所以「下载完成、随时可以重启安装」之后再也不会自己动。守卫改用独立的 applying 标记。
  • 新增安装凭条 + 心跳日志:下次启动能区分「脚本根本没跑起来」和「跑了但装失败」,
    两种情况给的建议不一样,不再让用户对着旧界面猜。
  • 新增「手动安装」按钮:直接运行已经下好的安装包(弹安装向导),不依赖后台脚本。
    自动安装被安全软件或系统策略拦住时,这是那条一定能走通的路。

升级提示

如果你正在用的版本点「重启并安装」没有反应,这一次请手动装一遍:
到发布页下载本版本的安装包运行即可(安装包不用再让 App 下载)。装到 0.6.16 之后,
后续更新按钮就会正常工作;也可以在面板里直接点「手动安装」跑已经下好的包。

下载哪个

文件 说明
ApkStart-v0.6.16-win64-portable.zip 轻量便携版,运行时首次启动按需下载
ApkStart-0.6.16-Setup.exe 完整安装包,内置运行时,离线开箱即用
ApkStart-runtime-v0.6.16.zip 运行时整包(便携版下载源,一般不用手动下载)

支持范围

本项目仅支持 Windows 10/11 x64。

ApkStart v0.6.15

Choose a tag to compare

@github-actions github-actions released this 17 Nov 10:42

本次更新带来多系统按需下载与一键切换,并修复了无硬件加速机器上的开机崩溃(issue #5)。

多系统按需下载与一键切换

系统选择界面新增 LineageOS、Bliss OS、Android-x86 卡片,原有的 Google Play / Google APIs / 纯 AOSP 与自定义镜像全部保留。

  • 不内置、不预下载:三个系统的镜像不在主程序、源码仓库或默认安装包里。只有在「设置 → 安卓系统 → 选择系统」主动选择,才会触发下载与安装;不用的不占磁盘,已下载的不重复下载。
  • 真实进度:下载 / 校验 / 建盘 / 安装 / 启动进度显示在「设置 → 运行状态 → 系统任务」,含真实速度、大小、剩余时间与阶段,支持暂停 / 继续 / 取消 / 重试。
  • 一键切换:真实停旧启新,各系统独立 userdata,切换不清空其它系统数据。

三个系统的真实状态:

系统 后端 状态
Android-x86 9.0-r2 QEMU 官方 ISO + SHA-256,可下载安装(真机启动需你的 VT-x/WHPX 环境验证)
Bliss OS 16.9.7 QEMU 官方 SourceForge 归档快照,可下载安装,无 OTA / 支持
LineageOS Android Emulator 官方无预构建镜像,提供自建 AVD 镜像导入,不伪造下载地址

修复

  • issue #5:无硬件加速的 20 核 / 小内存机器(Xeon E5-2650 v3、可用 4.8GB)原被分配 8 个 TCG 核导致 0xC0000005 崩溃;现在无加速时自动收紧到 4 核,有加速和手动设置不受影响。
  • 软件后端崩溃止损更及时(host / lavapipe 也计入同码崩溃),少白等一轮。
  • 「关 Vulkan 重试」不再被 androidboot.hardware.vulkan 这种正常启动属性误触发。
  • 崩溃诊断不再跨轮串味,第 2 轮的真实错误不会被第 1 轮结论盖掉。

说明

  • 单元测试 / 目录 / Provider / 任务 / 构建闸门均已在 Node 环境通过;GB 级 ISO 完整下载与 Windows 图形界面启动需在你的真实环境验证,相关条目标记为未验证,不做虚假声明。
  • 可用 npm run test:iso-source 随时复验官方 ISO 源的地址、大小与格式。
  • 仅支持 Windows 10/11 x64。

升级

安装版直接覆盖安装,便携版替换程序目录即可。已装应用、存档、系统镜像和运行时数据都不受影响。

支持范围

本项目仅支持 Windows 10/11 x64。

ApkStart v0.6.14

Choose a tag to compare

@github-actions github-actions released this 17 Nov 09:35

🚀 ApkStart v0.6.14 正式发布

版本号: v0.6.14
发布日期: 2026-11-17
版本类型: 正式版


📢 版本概述

本版聚焦首次启动设置引导与安卓数据分区容量:把「第一次打开之后该设置什么」补成完整向导,并把默认数据分区从 6 GB 提高到按磁盘余量分档。同时修复重启应用、资源策略覆盖画质、向导关闭和推荐值回填等问题。本版不碰运行时镜像和打包逻辑,升级不需要重新下载镜像。

✨ 一、新增功能(New Features)

  • 首次启动引导从 3 步扩到 8 步,覆盖资源(内存/CPU/策略)、硬件加速、画面与存储、系统镜像与语言、完成摘要。
  • 引导中的每一步都是可保存的设置控件,不是静态说明;每步可跳到设置页细调并返回原步骤。
  • 最后一步保存后真正重启应用,并按新设置运行。
  • 安卓数据分区默认容量按磁盘余量给 4 / 8 / 16 / 24 GB;设置页补齐 32 / 48 / 64 GB。
  • 欢迎页补上配置要求:Windows 10/11 x64、建议 8 GB 内存、4 核 CPU、至少 30 GB 可用空间。
  • 引导文案补齐英文词条。

🔧 二、功能升级与优化(Improvements)

  • 数据分区默认容量不再固定 6 GB;镜像是稀疏文件,24 GB 不会立刻占满磁盘。
  • 磁盘紧张时仍只给 4 GB,可在设置中手动扩容;已装应用和存档保留。
  • 引导完成页列出本次选择摘要,方便确认后再应用。
  • 「去设置页细调」与返回原步骤,减少从引导顶部重新走一遍的成本。

🐛 三、问题修复(Bug Fixes)

  • 修复「重启应用」以前只调用 app.quit()、没有重新启动的问题;现在会 app.relaunch() 并带上原有命令行参数(例如 --launch <pkg>)。
  • 修复资源策略与画质在同一次设置写入里互相覆盖:先选「均衡」再指定 1080p 时,画质会被改回「自动」。现在分两次写入。
  • 修复部署中可以把向导关掉、后台仍在下载造成界面看似卡死的问题;部署期间现在不允许关闭。
  • 修复数据分区推荐值会被稍后返回的设置读取异步回填盖成「自动」的问题。
  • 补齐首次引导缺失的英文词条。

⚡ 四、性能与稳定性(Performance)

  • 引导状态保存与设置写入集中处理,减少重复保存和覆盖风险。
  • 自动容量按磁盘余量分档,兼顾可用空间与镜像稀疏占用。
  • 真正重启链路保证引导完成后新设置立即生效。

🎨 五、界面与交互优化(UI/UX)

  • 引导向导补齐 5 个关键设置步骤:虚拟机资源、硬件加速、画面与存储、系统镜像与语言、完成摘要。
  • 每步控件与设置页共用同一状态模型,改完立即保存。
  • 欢迎页明确列出最低与建议配置要求。
  • 支持跳过引导,全部使用默认值。

🔒 六、安全与兼容性(Security & Compatibility)

  • 本版不修改运行时镜像内容、下载校验、安装包打包或自动更新签名逻辑。
  • 「清空数据 / 重下镜像 / 清缓存」仍保持用户确认,不进入自动修复。
  • 硬件加速开启仍会按系统要求请求管理员授权;BIOS 未开虚拟化时直接说明,不让用户白点 UAC 或白重启。

📦 七、下载与安装(Downloads)

文件 说明
ApkStart-v0.6.14-win64-portable.zip 轻量便携版;运行时首次启动按需下载
ApkStart-0.6.14-Setup.exe 完整安装包;内置运行时,离线开箱即用
ApkStart-runtime-v0.6.14.zip 运行时整包;通常是便携版下载源,一般不需要手动下载

推荐: 普通用户优先下载完整安装包;已有运行时或仅想快速试用的用户可用便携版。

🔄 八、升级说明(Upgrade Guide)

  • 已安装旧版本:安装版直接覆盖安装,便携版替换程序目录即可。
  • 已装应用、存档、系统镜像和运行时数据不受本版影响。
  • 本版不碰运行时镜像和打包逻辑,升级不需要重新下载镜像。
  • 首次使用:按引导选择资源、硬件加速、画面、存储、镜像与语言,完成后应用会真正重启并按新设置运行。

⚠️ 九、已知问题(Known Issues)

  • 硬件加速仍受 CPU/主板虚拟化支持、Windows 版本和驱动状态影响;开启失败时程序会给出下一步说明,但不保证所有机器都能成功。
  • 数据分区容量受磁盘实际可用空间限制;空间紧张时自动档只会给 4 GB。
  • 本说明未重新执行新的真实设备启动与应用安装验收。

🙏 十、特别说明

记录中的验证:18 个测试文件全绿,覆盖 auto 112、i18n 14、engine 38、updater 30、image-adapter 39、repair 15 等。本说明引用该记录,不重新声称完成了新的运行环境测试。


项目地址: https://github.com/yuchen0x1/apkstart
问题反馈: https://github.com/yuchen0x1/apkstart/issues
版本下载: https://github.com/yuchen0x1/apkstart/releases/tag/v0.6.14

ApkStart v0.6.13

Choose a tag to compare

@github-actions github-actions released this 17 Nov 08:24

这一版把「更新」这条路彻底修好:装得上、不丢数据、不再重复下载镜像,再给安卓桌面补一个能看见所有应用的入口。

更新:下载完成了,就一定装得上

有人遇到过这种情况:新版本提示下载完成,点「重启并安装」之后没有任何反应,重开程序还是旧版本。原因出在安装版这条链路上——更新是把活交给外部安装器(先卸旧、再解新),而安装器拿不到被占用的 ApkStart.exe 时不报错、直接放弃,用户看到的就是「什么都没发生」。

四处都堵上了:

  • 应用退出被清理流程卡住时,升级脚本会强制结束残留进程,再启动安装器,不再带着占着文件的进程去装;
  • 主进程退出加了硬兜底:15 秒还没退干净就直接结束,保证文件锁一定让出来;
  • 装失败不再一声不响:写失败标记、保留已下载的安装包,下次启动直接告诉你「上次更新到 X 没装成功,已回到旧版本」;重试时复用这份包,不用再下一次 1.4 GB;
  • 安装形态不再误判:卸载器叫 uninstall.exe / uninst000.exe 的安装包以前会被当成便携版(拿便携 zip 去覆盖安装目录,必然失败),现在一并识别。

更新不再清空你的应用和数据

安装版更新时会先跑旧版本的卸载器。以前那个卸载脚本无条件清空 %APPDATA%\apkstart,于是每升一次版本,模拟器里装的应用、聊天记录、设置全没了,程序还把自己当成全新安装。

现在卸载脚本会识别「这是覆盖安装」(安装器传的 --updated 参数),只结束残留进程、不删任何用户数据;只有你在 Windows「应用和功能」里主动卸载时才会清理。

不再重复下载 1.4 GB 系统镜像

完整版的运行时是把 system.img 以 .xz 压缩存放、首次启动才展开的。以前判断「镜像在不在」只认展开后的 system.img,于是刚装完新版本就被判定「缺镜像」,引导你去 dl.google.com 重下 1.4 GB——而实际上程序几秒后自己就解压好了。

现在压缩镜像同样算「已随运行时提供」,界面显示「首次启动自动展开」,不会再让你白下一次。

安卓桌面:应用没丢,只是收在抽屉里

Play 镜像自带的是 Pixel 桌面,第三方应用全部收在从底部上滑的抽屉里,首页只放 Google 自带的那几个。按 Home 回到桌面,看到一屏陌生图标,很容易以为「我装的应用不见了」。

主界面新增 「安卓桌面」 按钮:一键回桌面并展开所有应用抽屉,落地就是全部已装应用,不用再猜手势。

验证

18 个测试文件全绿,其中 updater 30 项、auto 111 项(新增:压缩镜像必须算已提供、覆盖安装不得清数据)。

这一版改动全在更新链路、镜像判定和界面上,安卓运行时没有变化,升级不需要重新下载镜像。

升级

安装版直接覆盖安装,便携版替换程序目录即可。已装应用、存档、系统镜像和运行时数据都不受影响。

支持范围

本项目仅支持 Windows 10/11 x64。

ApkStart v0.6.12

Choose a tag to compare

@github-actions github-actions released this 17 Nov 06:51

这一版几乎全在「起不来的时候怎么办」上:先把失败原因诊断准,再把能自己修的直接修掉,最后才把话说到用户能听懂。

开机失败:能自己修的不再麻烦你

以前只有「硬件加速没生效」会自动处理,其余失败一律弹窗让你点按钮。现在程序按一张明确的清单自己动手,修完自动重来一遍开机:

  • 上次没退干净 → 清残留锁文件、结束孤儿进程、换空闲端口;
  • 运行库 / 组件被杀软删了 → 先校验补齐文件,补不齐才装 VC++ 运行库(会弹一次授权);
  • 显卡渲染崩了 → 切软件渲染重试;
  • 磁盘不够 → 只清运行时临时目录和半截下载;
  • 内存不够 / 开机超时 → 降到 2 GB / 2 核,超时类把等待放宽到 15 分钟;
  • 软件模拟整体崩了 → 直接去开硬件加速。

边界守得很死:同一问题一次运行只修一次、最多修两类;动作失败就停,不做「同样的参数再开一次」这种白等。清空安卓数据、重下 1.5 GB 镜像、清缓存永远不自动做,仍然只在你点确认后才执行。

硬件加速这条链路也补齐了:AEHD 驱动装着但服务没跑(sc start aehd 就能修,多数不用重启)现在能识别出来并当场拉起;需要重启才生效时会直接说明,不让你白试一轮。

诊断:不再把无害日志当成致命错误

  • 日志停在 androidboot.veritymode 就退出、一条 ERROR 都不留的机器,以前只得到一句 UNKNOWN;现在给出明确结论 ACCEL_UNUSABLE(驱动没接管),并直接指向 WHPX / sc query aehd。
  • 一条 INFO 级的 Platform does not support Guest Angle 曾被当成显卡故障,把「5 次 0xC0000005 崩溃」判成 GPU_INIT,害得止损逻辑失效、第 4 组参数白跑。现在诊断前先压缩超长行(adb.pubkey 那类 700 字符的噪音),并把这句提示归到「无害」里。
  • 英特尔核显上所有渲染后端都崩同一退出码时,下一轮自动加 -feature -Vulkan 再试——-gpu 换的只是呈现方式,Vulkan 是另一条路。
  • 某一轮在拉起前抛异常,以前会让重试停在第 1 轮、报告里只剩一条尝试,文案却写着「已按多种参数组合重试」;现在异常也记一条继续下一组,报告与实跑一致。

失败提示:一句人话 + 一个动作

抛给用户的文本不再带诊断码和退出码,统一成三段:哪里坏了 → 程序已经自动做了什么 → 下一步点哪。例如:

上次没有正常退出,模拟器以为还有一台在运行。
程序已经自动清理了 2 个残留锁文件,并重新开了一次机,但还是没能起来。
下一步:导出诊断报告(发给作者定位)。

修复窗口顶部会如实列出「已自动处理:…」,并跳过刚失败过的动作,不让你重复点同一个按钮。

安装、更新、数据

  • .apk.1 这类下载残留后缀现在能装了:QQ / 微信 / 迅雷存出来的 抖音.apk.1,拖进来或从文件选择框里挑都行。
  • 并行下载校验 Content-Range(上游 #91):服务器返回错位范围时不再静默写出一个长度对、内容错的包。
  • 便携版更新后真的会重启成新版(上游 #98):按 exe + app.asar 大小逐项核对,失败会回滚并把旧版拉起来,不再出现「关了就再也没打开」。
  • 存快照把模拟器写崩的问题(上游 #46):本机 + 当前运行时版本崩过一次后不再存快照,升级运行时会重新给一次机会。
  • 安装版不再被误判成便携版(上游 #51):卸载器识别补上 uninstall.exe / uninst*.exe。

验证

18 个测试文件全绿:auto 109、engine 37、repair 15、updater 27、sync 26、compat 23、lowspec 16、image-adapter 39、report 10、security 11、release-notes 12 等。

下载哪个

文件 说明
ApkStart-v0.6.12-win64-portable.zip 轻量便携版,运行时首次启动按需下载
ApkStart-0.6.12-Setup.exe 完整安装包,内置运行时,离线开箱即用
ApkStart-runtime-v0.6.12.zip 运行时整包(便携版下载源,一般不用手动下载)

升级

安装版直接覆盖安装,便携版替换程序目录即可。已装应用、存档、系统镜像和运行时数据都不受影响。

支持范围

本项目仅支持 Windows 10/11 x64。

ApkStart v0.6.11

Choose a tag to compare

@github-actions github-actions released this 17 Nov 04:13
  • 支持按系统或浏览器语言自动选择中文/English,也可手动切换并持久化。
  • 更新设置页语言入口和核心壳层文案,保留应用数据与更新协议字段。

验证:node test/i18n-test.js 与 npm run readme:check 通过。

下载哪个

文件 说明
ApkStart-v0.6.11-win64-portable.zip 轻量便携版,运行时首次启动按需下载
ApkStart-0.6.11-Setup.exe 完整安装包,内置运行时,离线开箱即用
ApkStart-runtime-v0.6.11.zip 运行时整包(便携版下载源,一般不用手动下载)

升级

安装版直接覆盖安装,便携版替换程序目录即可。已装应用、存档、系统镜像和运行时数据都不受影响。

支持范围

本项目仅支持 Windows 10/11 x64。

ApkStart v0.6.10

Choose a tag to compare

@github-actions github-actions released this 16 Nov 13:28

这一版只修一件事:检测到新版本后,可以真正在应用里一键更新,不用再自己跑去仓库下载。

这次修了什么

  • 「有新版本但只能手动下载」:发版时 Release 页面先出来、安装包后上传(完整版要构建十几分钟),这段时间检查更新只能看到「发现新版本」,主按钮退化成「打开下载页」并直接把浏览器弹出来。现在:
    • 主按钮变成「重新检查并下载」,点一下就强制重查(跳过缓存),安装包已经传完就直接下载 → 校验 → 替换 → 重启,全程不用离开应用;
    • 拿到发布页但安装包还没传完时,应用会每 2 分钟自动重查一次(最多 3 次),传完自动开始下载;
    • 面板上直接写明「安装包还在上传,完成后会自动下载安装」,同时把「打开下载页」留成一个独立按钮,想自己挑安装版 / 便携版时仍然可以手动下载。
  • 下载完的状态更清楚:后台已经把包下好时,按钮不再退回「立即更新」(看着像白下了),而是显示「v0.6.10 已下载完成,随时可以重启安装」+「重启并安装」;重新点「检查更新」也不会把这个状态冲掉。

验证结果

  • npm test:全部通过(自动化 95 项、engine 38 项、i18n 14 项、README 7 项等共 250+ 项,0 失败)。
  • 三种状态(可更新 / 安装包未上传 / 已下载)逐屏截图核对排版与按钮文案。

下载哪个

文件 说明
ApkStart-0.6.10-Setup.exe 安装版,包含完整运行时,首次安装后无需再下载
ApkStart-v0.6.10-win64-portable.zip 便携版,解压即用,首次启动时下载运行时

v0.6.9 的改动(设置面板重做、内存/CPU 自动分配放大、音量三连修)都在这一版里,0.6.9 用户直接升级即可。

Windows 10/11 x64;建议开启 VT-x/AMD-V 并在设置页一键开启硬件加速,内存 8 GB 起。

升级

安装版直接覆盖安装,便携版替换程序目录即可。已装应用、存档、系统镜像和运行时数据都不受影响。

支持范围

本项目仅支持 Windows 10/11 x64。

ApkStart v0.6.9

Choose a tag to compare

@github-actions github-actions released this 16 Nov 13:08

这一版把设置面板重做成左侧分类 + 右侧内容(带搜索),内存 / CPU 核心从「找不到在哪改」变成了带下拉框的第一张卡片;修掉了「音量拖到 100% 又跳回 0%」和「Android 14 镜像上音量根本改不动」两个音量问题;自动分配不再把高配机器压死在 3 GB / 4 核。

这次升级了什么

  • 设置面板重做:原来所有分组堆在一个超长页面里,想改内存要一路往下滑还经常滑过头。现在分成通用 / 运行状态 / 性能与资源 / 显示与操作 / 安卓系统 / 桌面与文件 / 下载与更新 / 高级 / 关于九类,点左边名字进对应页;左栏顶部加了搜索框,输入「内存 / 音量 / 快捷方式」直接列出命中项,点一条跳过去并高亮。
  • 内存 / CPU 核心改成下拉框,放在「性能与资源」第一张卡:旁边直接显示本机配置(「你的电脑:xx GB 内存 · xx 线程(当前可用 xx GB)」)和自动算出来的实跑参数,一眼能看出程序到底看没看你的配置。
  • 自动分配按机器配置放大:自动值原来按物理内存 22% 算但硬封顶 3072 MB、核心硬封顶 4 —— 64 GB / 32 线程的机器也只分到 3 GB / 4 核。现在按物理内存 1/4(2 GB 起、8 GB 封顶)、线程数一半(2 核起、8 核封顶)分配,dalvik 堆跟着放大(6 GB 以上给 512 MB)。8 GB / 8 核是收益拐点,想更狠可以在下拉里手动选 12 / 16 GB。
  • 音量问题三连修:
    • 拖到 100% 又跳回 0%:media_session volume --get 的输出前面带几行日志,旧解析把日志里的 stream=3 当成当前音量;状态汇总又把多行输出只截第一行后回退 dumpsys,而新镜像的 dumpsys 已没有旧字段,最终兜成 0。现在只认明确的音量写法,读不出来显示「音量未知」,绝不兜成 0。
    • Android 14 镜像上音量根本改不动:--set 被系统以 AppOps 拒绝且异常被吞掉(返回 0、输出照写成功)。现在每次设置都回读校验,被拒绝的机型自动改走音量键补档,并如实显示设备回读的真实百分比。
    • 首次开机默认媒体音量从 50% 改为 100%(镜像出厂经常是静音);拖杆调整期间不再被后台状态刷新覆盖。
  • 开机自启默认关闭:需要的人可以在「设置 → 通用」里打开;已保存的配置不会被改写。
  • README 重写 + 版本信息自动化:README 扩成完整的介绍文档(功能详解 / 实测截图 / 系统要求 / FAQ / 数据目录),版本行与「最新更新」改由 npm run readme:sync 从 package.json + CHANGELOG 生成,测试与发版工作流各加一道校验,不会再出现「发了新版、README 还挂着旧版本号」。

验证结果

  • npm test:全部通过(自动化 95 项、engine 38 项、i18n 14 项、README 7 项等共 250+ 项,0 失败)。
  • Electron 冒烟测试:20 项通过。
  • 真机验证(Android 14 镜像):setVolume(100)→100%、50→53%(8/15 档位取整)、0→0% 均回读一致;--set 被 AppOps 拒绝时自动走音量键补到满档。
  • 设置面板九个分类与搜索结果页逐页截图核对排版。

下载哪个

文件 说明
ApkStart-v0.6.9-Setup.exe 安装版,包含完整运行时,首次安装后无需再下载
ApkStart-v0.6.9-win64-portable.zip 便携版,解压即用,首次启动时下载运行时

Windows 10/11 x64;建议开启 VT-x/AMD-V 并在设置页一键开启硬件加速,内存 8 GB 起。

支持范围

本项目仅支持 Windows 10/11 x64。