Repository navigation
Releases: NEORUAA/HyperOS-AVD
Release list
HyperOS 4.0.18.0 · v0.2.3 · Apple Silicon · r4
相比 r3
- 修复安全中心在解锁后初始化重复 provider 时的崩溃。
- 修复定位服务请求不存在的 Qualcomm GNSS 扩展时的崩溃与等待，保留模拟器标准 GNSS。
- 修复没有实体 SIM 信息时，小米注册服务的空值崩溃。
- 根据实际内核能力停用无法工作的 OEM 预读、Millet 与 Qualcomm 私有定位守护进程，减少反复启动和无效等待；不关闭受支持的接口。
- 修复写入系统镜像，新装和恢复出厂后仍保留，无需额外安装修复模块。沿用 r3 的全局 HWUI Vulkan、Flutter 渲染、锁屏编辑和独立妙享背屏适配。
安装与升级
需要 Apple Silicon Mac、Python 3、Android Emulator / Platform-Tools、e2fsprogs，无需 NDK 或手机 OTA。默认 6 GiB RAM / 4 核 / 32 GiB，资源可调整。
使用 Installer 1.2.1 或以上。已有 r3：关闭目标 AVD →“升级”→ 原实例 → r4。安装器先备份完整 userdata、QCOW2 与加密密钥，再保数据切换；失败可恢复。r1 / r2 也可直接升级至 r4。手机、Pad、OS3 不能互相覆盖，保数据降级不支持。
上传同目录全部镜像分卷、manifest.json 与 SHA256SUMS，保留文件名；先发布 Installer 1.2.1，再发布本镜像。
已知限制
Google 认证 / 登录问题本版未处理，不承诺 Play Integrity。相机和部分云服务仍属实验功能，保留 r3 已知限制。系统 APK 修复保留原签名身份用于系统分区扫描，修改后的 APK 不是可独立侧载的签名更新包；普通用户 APK 的签名验证未改动。
HyperOS-AVD Installer v1.2.1
HyperOS 4.0.18.0 · v0.2.2 · Apple Silicon · r3
相比 r2
- 妙享背屏：新增
912×596 / 450 dpi原版背屏与独立窗口，补齐安全区、右边缘返回及双击息屏 / 唤醒；单击不会误唤醒。 - 渲染：View 应用全局使用 HWUI Vulkan，保留 Flutter 文字、玻璃、渐进式模糊与阴影修复；修复锁屏编辑预览的绿屏 / 花屏。
- 稳定性：适配主副屏 60 Hz 合成并修复 goldfish 同步队列溢出，保留桌面手势、近期任务、Mac sRGB 色彩、音频、GPS、传感器和实验相机适配。
- 资源与默认值：主屏
1120×2436 / 480 dpi，默认 6 GiB RAM / 4 核 / 32 GiB 存储。新用户默认常亮与 AOD；升级保留用户选择、模拟序列号和应用数据。
安装与保数据升级
需要 Apple Silicon Mac、Python 3、SDK Emulator / Platform-Tools；新建 / 扩容另需 brew install e2fsprogs，建议预留 60 GiB 加备份空间。使用 Installer 1.2.0 或以上，无需 NDK 或原始 OTA：
curl -fsSL https://github.com/NEORUAA/HyperOS-AVD/releases/latest/download/install.sh | bash已有 r2：关闭目标 AVD → 升级 → 选择原实例与 r3。安装器先备份完整 userdata / QCOW2 / 加密密钥，再启动旧 r2 检查并隔离旧项目补丁，随后切换固件。若使用 revision 1 的实验相机桥接，需先在 r2 更新至 revision 2；不满足兼容检查时会中止迁移。r1 先升 r2，Pad 与 OS3 不能覆盖升级至手机版。
安装完成后通过原实例的 Start.command 启动。镜像附件为全部分卷、manifest.json 与 SHA256SUMS，勿混用版本；安装器另行下载，包内不含个人用户数据。
验证与限制
独立 r2 → r3 测试实例已核验应用清单、Android ID、引导状态、模拟序列号、用户设置及测试文件保留；天气数据探针一致。r3 冷启动已确认 root / Enforcing、Settings 的 HWUI Vulkan、背屏独立窗口、原版边缘返回及双击息屏 / 唤醒。升级验证不等于所有账号登录态或云服务验收。
相机仍属实验功能，手机后摄录像掉帧；蓝牙、小米云服务、Google 登录和 Play Integrity 未完整验证。全局 SELinux 为 Enforcing，KSU root 域仍为 permissive。未知应用商店原生库更新、第三方模块或设备硬件专属能力可能需要额外适配，长期稳定性继续观察。
HyperOS-AVD Installer v1.2.0
本版新增小米 18 Pro 官方 OS4.0.18.0 / r3 的安装和 r2 → r3 保数据升级，支持对应冻结启动代码、全局 HWUI Vulkan 与独立妙享背屏。既有 OS3、手机 r2 与 Pad OS4 的实例管理继续保留。
- 存储扩容修复：新建时扩展实际 ext4；旧版“虚拟盘 32 GiB、
/data约 6 GiB”先完整备份，再通过解密后的来宾系统检查与修复，保留数据与密钥。修复后已验证/data约 31 GiB 和冷启动。 - 先校验分卷、备份 userdata / QCOW2 / 加密密钥，再检查旧固件与已知项目模块，避免旧补丁覆盖新系统。
- 保留原实例名称、端口、用户设置及项目模块的禁用 / 删除选择；失败可从升级前备份恢复。
- 手机 r3 默认 6 GiB / 4 核 / 32 GiB，Pad 默认 4 GiB / 4 核 / 32 GiB，资源可调整。
- 保留中文 / English 菜单、自动下载、断点续传和 SHA-256 校验，安装器与镜像分别检查更新。
curl -fsSL https://github.com/NEORUAA/HyperOS-AVD/releases/latest/download/install.sh | bash或解压 HyperOS-AVD-Installer-v1.2.0-macos-arm64.zip，双击 Install.command。需要 Apple Silicon Mac、Python 3 与 Android Studio SDK Emulator / Platform-Tools。新建或扩容用户分区还需 brew install e2fsprogs，依赖会在改动前检查。
已加密磁盘暂不支持继续增大虚拟容量（如 32 → 64 GiB）；修复原有 32 GiB 容量不受此限制。新建实例可直接选择更大容量。
升级前须关闭目标 AVD。r3 自动迁移仅开放 r2 来源；旧 revision 1 实验相机桥接需先在 r2 升至 revision 2。没有发布清单的早期源码实例不支持自动迁移；不支持手机 / Pad / OS3 互迁或保数据降级。
附件为安装器 ZIP、install.sh、installer.json 与 SHA256SUMS，不含系统镜像或个人用户数据。
HyperOS Pad 4.0.15.0 · v0.1.0 · Apple Silicon · r1
本版内容
- 原厂横屏
3408×2272 / 400 dpi；默认 4 GiB RAM / 4 核 / 32 GiB 存储，可在安装器调整资源。 - KernelSU root、全局 SELinux Enforcing、GPU 加速；ADB 保留授权确认。
- HWUI Vulkan 与 Flutter 文字、玻璃和阴影适配；天气使用独立 ANGLE 桥，原签名 APK 保持不变。
- 60 Hz 合成、macOS sRGB 显示、平板旋转与后台缩略图、小爱边缘光效适配。
- 默认常亮；按原机配置不启用 AOD。序列号按小米样式随机生成，随当前用户分区保存，恢复出厂后重新生成。
- 相机 ANGLE 与前后摄桥接自动初始化。所需原生库、校验收据及冻结启动代码随包提供，无需 NDK 或原始 OTA。
安装
需要 Apple Silicon Mac、Python 3、Android Studio SDK Emulator / Platform-Tools，建议预留 60 GiB 加备份空间。使用 Installer 1.1.0 或以上，在菜单选择 Pad OS4：
curl -fsSL https://github.com/NEORUAA/HyperOS-AVD/releases/latest/download/install.sh | bash也可从 Installer ZIP 打开 Install.command。等待初始化完成，按提示在虚拟机确认 ADB 授权，再完成首次开机引导。之后从安装器或实例目录的 Start.command 启动。
Pad 首版应新建独立实例，不能覆盖升级手机 OS4 或 OS3。镜像附件为所有分卷、manifest.json 和 SHA256SUMS；文件名保持不变，勿混用不同版本。安装器另行下载，包内不含个人用户数据。
验收与限制
本地测试镜像已实际完成原版 OOBE、新用户天气背景及权限弹窗检查，并确认冷启动后城市、权限、机型与序列号保留。发布候选与分卷的验证进度见 验证记录。
Pad 曾出现 MoltenVK 与 native sync 崩溃，当前已采取规避配置，长期稳定性仍需观察。前后摄预览与基础拍照已测试，但原厂拍照后处理可能延迟保存，录像尚未验收。蓝牙、小米云服务、Google 登录及 Play Integrity 未完整验证；KSU root 域仍为 permissive。应用商店更新未知原生库版本后可能需要重新适配。
HyperOS 4.0.17.0 · Android 17 · Apple Silicon · r2
相比 v0.2.0
- 流畅度：修复整体动画与滚动卡顿，Android 合成帧率恢复为 60 Hz；修复页面返回时压暗不渐隐。
- 显示效果：改善 Mac 上的过饱和，补全控制中心、主题商店的渐进式模糊，修复小爱唤起动画黑底。
- 相机：新增可编辑虚拟场景；可选小米相机适配支持预览、前后切换和基础拍照，后摄录像仍有明显掉帧。
- 声音：默认启用 Mac 声音输出，修复连续播放一段时间后持续无声。
- 默认配置：RAM 提升至 6 GiB，补全机型身份与随机模拟序列号，启用负一屏小组件入口；减少 17 个指定标签的日志输出。
安装 / 升级
使用独立正式 Installer，无需手动下载镜像：
curl -fsSL https://github.com/NEORUAA/HyperOS-AVD/releases/latest/download/install.sh | bash已有 v0.2.0：关闭目标 AVD → 升级 → 选择旧实例和 v0.2.1，自动备份并保留应用与数据。中英安装指南。
需要 Apple Silicon Mac、Python 3、SDK Emulator / Platform-Tools。建议预留 60 GiB 加备份空间。本 Release 附件为 5 个镜像分卷、manifest.json 和 SHA256SUMS；安装器独立发布。
相机仍为实验功能。蓝牙、云服务、Google 登录与 Play Integrity 未完整验证，查找设备状态查询不可用。
English
Compared with v0.2.0: fixes 60 Hz rendering and return-transition dimming, improves macOS color matching and progressive blur, fixes XiaoAI's black background and sustained audio loss, adds editable virtual cameras and an optional Xiaomi camera bridge. Defaults to 6 GiB RAM, adds phone identity and a persistent simulated serial, and reduces selected debug logs. The official OS4.0.17.0 / Android 17 base is unchanged.
Use the separate stable Installer above. Close the target AVD before a backed-up upgrade. Rear video still drops frames.
HyperOS-AVD Installer v1.1.0
本版新增 Pad OS4 / yingtian 的下载、校验和独立实例管理，支持对应 format 3 镜像及冻结启动代码。Pad 默认 4 GiB RAM / 4 核 / 32 GiB 存储，资源可自定义。既有 OS3 与手机 OS4 的安装、备份升级和恢复继续保留。
- 中文 / English ASCII 菜单，自选 AVD 名称、目录、资源与端口。
- 自动下载分卷、断点续传与 SHA-256 校验。
- 按镜像系列检查兼容性；Pad、手机 OS4 与 OS3 分别保存用户数据。
- 安装器更新与镜像更新独立，升级前须关闭目标 AVD。
curl -fsSL https://github.com/NEORUAA/HyperOS-AVD/releases/latest/download/install.sh | bash或解压 HyperOS-AVD-Installer-v1.1.0-macos-arm64.zip，双击 Install.command。需要 Apple Silicon Mac、Python 3 和 Android Studio SDK Emulator / Platform-Tools。
附件为 install.sh、安装器 ZIP、installer.json 和 SHA256SUMS，不含系统镜像或个人用户数据。Pad 镜像需本版或更新安装器；最早从源码构建且没有发布清单的实例不支持自动固件迁移。
HyperOS-AVD Installer v1.0.0
功能
- 中文 / English ASCII 菜单，镜像选择同时展示 OS3 与 OS4、历史版本和发布状态。
- 自动下载镜像、断点续传与 SHA-256 校验，无需手动下载分卷。
- 自选 AVD 名称、安装位置、RAM、存储与 CPU；每个实例独立。
- v0.2.0 保数据升级：备份 userdata、QCOW2 和加密密钥，支持失败恢复与回滚。
- 分别检查镜像更新和正式安装器更新；识别旧源码 OS3 / OS4 实例。
推荐直接运行，选择语言和安装目录后自动拉取安装器与镜像：
curl -fsSL https://github.com/NEORUAA/HyperOS-AVD/releases/latest/download/install.sh | bash也可下载 HyperOS-AVD-Installer-v1.0.0-macos-arm64.zip，解压后双击 Install.command。需要 Apple Silicon Mac、Python 3 和 Android Studio SDK 的 Emulator / Platform-Tools，建议预留 60 GiB 加数据备份空间。
已有 Release 安装实例：关闭目标 AVD → 升级 → 选择实例和新版镜像。最早从源码构建且没有发布清单的实例可启动或调整硬件，自动固件迁移会被拒绝。安装器更新入口提供下载链接；更换安装器不改已有 AVD 数据。
附件为 install.sh、安装器 ZIP、installer.json 和 SHA256SUMS，不含系统镜像。详情：中英安装 / 升级 / 恢复指南。
English
A separate stable installer for Apple Silicon macOS. The bilingual ASCII menu lists both OS3 and OS4 firmware, downloads and verifies archive parts automatically, and supports custom instances/resources, backed-up v0.2.0 upgrades and recovery. Firmware prereleases and stable installer updates are checked separately.
Run the curl command above, choose a language and installation directory, or extract the installer ZIP and open Install.command. Python 3 and Android Studio SDK Emulator / Platform-Tools are required. Close the target AVD before upgrading. Legacy source workspaces without a release manifest are listed for start/hardware settings; automatic firmware migration is refused. Firmware is downloaded after selection and is not included in this installer release.
HyperOS 4.0.17.0 · Android 17 · Apple Silicon · r1
将小米 18 Pro（hongkong）的官方 OTA 原厂系统与小米扩展移植到 Android Studio ARM64 Emulator，保留完整系统应用、原生桌面、Flutter 玻璃和首次开机引导。与 OS3 的 MysticGSI 方案相比，OS4 提供更完整的原厂软件体验。
| 项目 | 配置 |
|---|---|
| HyperOS / Android | 4.0.17.0.XFRCNXM / Android 17（API 37） |
| 宿主 / 硬件底座 | Apple Silicon macOS / API 36 ARM64 ranchu、4 KB 内核 |
| KernelSU | v3.3.0（32601），LKM；全局 SELinux Enforcing |
| 默认 AVD | HyperOS_4_Official_API_37 / emulator-5574；4 核 / 4 GiB |
| 显示 / 机型配置 | 1120×2436、480 dpi；完整 hongkong.xml |
本次内容
- 预装天气与相册，修复 Flutter 元素、玻璃 / 模糊、相册阴影及天气图形兼容问题。
- 固化小米桌面 Quickstep 身份与手势适配，保留原厂系统应用签名。
- 保留完整开机引导，解除查找设备状态查询造成的黑屏。
- 使用原厂主屏分辨率与密度，默认开启息屏显示并设为始终显示，支持全屏 AOD。
- 关闭调试串口控制台，恢复生产版调试属性以修复开发者选项初始化异常。
- 默认接通虚拟电源并保持常亮；独立 OS4 数据目录和空白 userdata 模板，与 OS3 隔离。
安装
下载本 Release 对应的仓库源码，以及 manifest.json 和全部 .tar.gz.partNNN 分卷，放在同一目录，无需手动解压。本次共 5 个分卷，合计 6.31 GiB。SHA256SUMS 可用于手动核验，安装器也会自动校验全部分卷和安装文件。
需要 Apple Silicon Mac、Python 3，以及 Android Studio SDK 的 Android Emulator / Platform-Tools。首次安装建议预留 40 GiB，更新预留 60 GiB；预构建包无需 OTA、NDK 或 Build-Tools。
chmod +x Setup.command Start-HyperOS*.command
./Setup.command --bundle /path/to/release/manifest.json
./Start-HyperOS4-Official.command等待终端显示 HyperOS is ready 后完成系统引导。后续双击 OS4 启动脚本即可；更新镜像前关闭对应 OS4 AVD，安装器保留用户数据。不要混用不同 Release 的分卷。
验证与限制
本次镜像已重新恢复出厂并完成启动，README 使用重置后重新完成开机引导的 8 张截图。桌面、天气、相册及手势的验收沿用此前已核验版本；开发者选项和 AOD 的界面效果由用户自行测试。
28 项自动测试、35 个镜像内签名 / 原生文件预检、全部分卷与 manifest 校验及 21 个文件的实际导入验证均通过；已确认 userdata 为空白模板。导入校验未注册或启动 AVD。
- 部分后台缩略图可能空白，回桌面动画仍可能有延迟。
- 应用商店更新原生库后可能需要按 OS4 文档刷新补丁；未知 Flutter 引擎版本需另行适配。
- 查找设备状态查询不可用；蓝牙、Google 登录、Play Integrity 和小米云服务未完整验证。
- 相机、音频默认关闭；OS4 GPS 已合入补丁，尚未完成完整坐标回归。
- KSU root 域仍为 permissive；首次着色器初始化可能较慢。
这是实验预发行版本。完整原厂软件移植不等于手机硬件全兼容，详情见仓库 docs/hyperos4.md。
HyperOS 3.0.2.0 · Android 16 · Apple Silicon · r1
镜像信息
| 项目 | 版本 |
|---|---|
| HyperOS | 3.0.2.0.WMCCNXM |
| Android | 16 / API 36 |
| 来源 | 小米 13（fuxi）MysticGSI |
| 宿主平台 | Apple Silicon macOS / ARM64 |
| KernelSU | v3.3.0（32601），LKM |
| 项目工具 / 镜像修订 | v0.1.0 / r1 |
本次更新
- 支持官方 Android Studio ARM64 Emulator 原生启动。
- 提供安装、启动脚本及首次启动 KernelSU 自动初始化。
- 修复圆角、挖孔比例，以及复现到的 GNSS 回调死锁。
- 保持全局 SELinux Enforcing；KSU root 域仍为 permissive。
安装
下载本 Release 的 manifest.json 和全部 .tar.gz.partNNN 分卷，放在同一目录，按仓库 README 安装。无需手动解压；安装器会校验 SHA-256。
./Setup.command --bundle /path/to/release/manifest.json
./Start-HyperOS.command验证与限制
已完成分卷导入、空白数据首次启动、KernelSU 初始化，以及两组坐标 / 四次 GPS 启停测试。
- 网络融合定位、小米云服务、Google 登录及 Play Integrity 未验证。
- 相机和音频默认关闭，蓝牙未验证。
- 首次设备设置曾出现一次锁屏杂志导致的 SystemUI 崩溃，随后恢复。
- Android Studio 内嵌窗口未验证；请先通过项目启动脚本运行。
实验版本，完整兼容范围见仓库 docs/compatibility.md。