在 Apple Silicon Mac 的 Android Studio ARM64 模拟器中运行小米 HyperOS，支持 ADB、KernelSU root、GPU 加速和全局 SELinux Enforcing。
手机与平板 OS4 均由小米官方 OTA 原包移植，保留原厂系统应用、桌面、首次开机引导及 Flutter 玻璃界面；OS3 使用 MysticGSI，适合体验基础功能。
| HyperOS 3 | HyperOS 4 手机 | HyperOS 4 Pad | |
|---|---|---|---|
| 系统 | 3.0.2.0.WMCCNXM / Android 16 | 4.0.24.0.XFRCNXM / Android 17 | 4.0.15.0.XBMCNXM / Android 17 |
| 来源 | 小米 13（fuxi）MysticGSI | 小米 18 Pro（hongkong）官方 OTA | Xiaomi Pad 9 Pro Max（yingtian）官方 OTA |
| 显示 | 手机布局 | 主屏 1120×2436 / 480 dpi，背屏 912×596 / 450 dpi | 横屏 3408×2272 / 400 dpi |
| 默认资源 | 2 核 / 2.5 GiB | 4 核 / 6 GiB RAM / 32 GiB 存储（负一屏完整模糊建议 8 GiB RAM） | 4 核 / 4 GiB RAM / 32 GiB 存储 |
| 发布说明 | 兼容范围 | r6 完整包 · r6.2 | r3 完整包 · r3.2 |
Pad 采用独立的 pad-v* 版本号，手机与 OS3 沿用 v* 版本号。各版本镜像与用户数据完全独立，支持多实例共存。发布镜像均在 GitHub Releases 提供分卷下载，请不要混用不同 Release 的分卷文件。
Phone r6.2 与 Pad r3.2 搭载 Core 20 / Apps 8 自适应 KernelSU 模块与离线状态页，支持 Magic Trackpad 双指滑动。Phone 同时加入系统 AC-3 / E-AC-3 解码支持。虚拟机的 CPU、内存与存储空间均可自由调整，平板默认 4 GiB 内存为推荐起步配置。
本次使用仅增量发行，需要 Installer 1.3.1。Phone r6、r6.1 可分别直达 r6.2，Pad r3、r3.1 可分别直达 r3.2。已有用户只下载当前版本对应的增量，新用户直接选择最新版，安装器自动使用原 r6 / r3 完整包和到最新版的一条增量完成安装，无需安装或启动中间版本。原始完整包及历史修订继续保留。
 平板桌面与小组件 |
 系统版本与机型 |
 Root / 强制执行 |
r3：OS4.0.18.0 与独立背屏窗口。
以下 4×2 为 r2 的界面参考，后续手机版保留这些功能。
 首次开机引导 |
 语言设置 |
 小米账号 |
 设置完成 |
 原生桌面与玻璃 |
 Root / 强制执行 |
 系统版本 |
 全天候息屏 |
OS3 截图
 桌面 |
 Root |
 设置 |
 系统版本 |
- 系统与硬件：Apple Silicon Mac（M 系列芯片）、Python 3
- 开发工具：Android Studio SDK 的 Emulator 与 Platform-Tools
- 磁盘工具：新建或扩容用户分区需执行
brew install e2fsprogs - 磁盘空间：建议预留 60 GiB 以上可用空间（用于解压镜像与数据备份）。直接使用预构建镜像时，无需安装 NDK 或下载手机官方 OTA。
在 macOS 终端中运行以下命令，按提示选择语言及安装目录，即可自动拉取并启动安装器：
curl -fsSL https://github.com/NEORUAA/HyperOS-AVD/releases/latest/download/install.sh | bash也可前往 Releases 下载 Installer ZIP，解压后双击 Install.command；或克隆仓库直接运行：
git clone https://github.com/NEORUAA/HyperOS-AVD.git
cd HyperOS-AVD
chmod +x Install.command
./Install.command安装器提供了交互式终端菜单，支持自动下载并校验 OS3、手机 OS4 与平板 OS4 镜像，支持自定义 AVD 名称、内存大小、存储空间及 CPU 核心数，并支持实例管理、硬件配置修改、备份升级与一键回滚。
- Phone / Pad：先关闭目标 AVD，使用 Installer 1.3.1 或更新版本，在“升级”中选中当前实例与 Phone r6.2 / Pad r3.2，即可从同一 r 大版本下的任一旧修订直接升级。
- 安全保障：升级前安装器会自动对完整用户数据（userdata）、磁盘覆盖层（QCOW2）、加密密钥及配置进行快照备份，验证兼容性后再行切换，发生异常可随时恢复。
- 注意：手机和平板属于不同设备系列，不支持互相覆盖升级；同时不支持保留用户数据的降级操作。历史版本的升级说明请查阅 安装与升级指南。
- 触控板手势：通过项目启动器打开 AVD 后，Magic Trackpad 和 Mac 内置触控板支持双指上下滚动、左右滑动切页。滑动从指针所在的屏幕位置开始，方向遵循 macOS 的滚动设置，松手后由 Android 处理惯性。Phone、Pad、背屏与 OS3 共用该适配，安装器已附带预编译文件。
- 手机 OS4：完整保留原厂开机引导、官方系统应用（天气、相册等）、全局 HWUI Vulkan 与 Flutter 玻璃模糊效果；已适配 60 Hz 刷新率、macOS 色彩与音频输出；支持小米 18 Pro 独特的副屏（妙享背屏）独立窗口、双击息屏/唤醒与侧滑手势，默认启用全天候息屏（AOD）与常亮支持。
- 平板 OS4：保留原版横屏平板桌面布局与原厂设备特性，独立调校了显示与 Vulkan 渲染参数。内存推荐 4 GiB 起步且支持自由调大；原机硬件不支持的 AOD 功能保持关闭。
- Phone r6.2 音频适配：系统 MediaCodec 支持 AC-3 / E-AC-3 立体声及 5.1 声道音源，5.1 输出会下混为立体声。E-AC-3 JOC 与 AC-4 目前仅完成解码器注册，暂不提供完整 Atmos 支持。Pad 本次不包含该音频适配。
- 已知限制：
- 相机目前仅支持虚拟场景基础预览与普通拍照，高级夜景、人像、变焦算法及高质量录像尚未完整适配；
- 蓝牙、小米云服务、Google 登录以及 Play 完整性认证（Play Integrity）暂未完成兼容；
- 全局 SELinux 严格保持 Enforcing 状态，KernelSU root 运行域依官方规则保持 permissive；
- 更多技术细节与测试边界请参考 双端验证报告。
OS3 兼容性说明 · 手机 OS4 适配文档 · 平板 OS4 适配文档 · 补丁架构与维护
致谢：小米、MysticGSI、Android Emulator / AOSP、KernelSU。镜像保留 SDK 的 NOTICE.txt，第三方组件归各自权利人所有。