NEORUAA / HyperOS-AVD

# HyperOS-AVD
在 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 完整包和到最新版的一条增量完成安装，无需安装或启动中间版本。原始完整包及历史修订继续保留。
## Pad OS4 截图
 平板桌面与小组件 
 系统版本与机型 
 Root / 强制执行 
## 手机 OS4 截图
**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 终端中运行以下命令，按提示选择语言及安装目录，即可自动拉取并启动安装器：
 [code] 
也可前往 Releases 下载 `Installer ZIP`，解压后双击 **`Install.command`**；或克隆仓库直接运行：
 [code] 
安装器提供了交互式终端菜单，支持自动下载并校验 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；
 - 更多技术细节与测试边界请参考 双端验证