Skip to content

Repository files navigation

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.18.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(负一屏完整模糊建议 8 GiB) 4 核 / 4 GiB
发布说明 兼容范围 v0.2.2 / r3 v0.1.0 / r1

Pad 使用独立的 pad-v* 版本线;手机与 OS3 的版本号继续沿用 v*。各版本独立保存镜像与用户数据,可同时安装。镜像在 GitHub Releases 分卷提供,勿混用不同 Release 的文件。

Pad OS4 截图

Pad OS4 横屏桌面与小组件
平板桌面与小组件
Pad OS4 设置中的系统版本与机型
系统版本与机型
Pad OS4 KernelSU 与 SELinux 强制执行
Root / 强制执行

手机 OS4 截图

r3:OS4.0.18.0 与独立背屏窗口。

OS4 r3 系统版本与独立妙享背屏窗口

以下 4×2 为 r2 的界面参考,r3 保留这些功能。

OS4 首次开机引导
首次开机引导
OS4 语言设置
语言设置
OS4 小米账号
小米账号
OS4 设置完成
设置完成
OS4 原生桌面与玻璃
原生桌面与玻璃
OS4 KernelSU / Enforcing
Root / 强制执行
OS4 系统版本
系统版本
OS4 全天候息屏
全天候息屏
OS3 截图
OS3 桌面
桌面
OS3 KernelSU
Root
OS3 设置
设置
OS3 系统版本
系统版本

安装与升级

需要 Apple Silicon Mac、Python 3、Android Studio SDK 的 Emulator / Platform-Tools。建议预留 60 GiB 加用户数据备份空间,无需 NDK 或手机 OTA;新建 / 扩容用户分区需 brew install e2fsprogs。

在终端运行,选择中文 / English 和安装目录即可自动拉取正式安装器:

curl -fsSL https://github.com/NEORUAA/HyperOS-AVD/releases/latest/download/install.sh | bash

ASCII 菜单自动下载并校验 OS3 / 手机 OS4 / Pad OS4 镜像,可自定义 AVD 名称、RAM、存储和 CPU,支持备份后升级与恢复。默认存储 32 GiB;手机 r3 需 Installer 1.2.0 或以上,Pad 版需 1.1.0 或以上。也可下载 Installer ZIP 后双击 Install.command。

安装器与镜像独立发版:安装器使用 installer-v* 正式 Release,镜像继续使用各自的 Pre-release。也可直接从源码运行:

git clone https://github.com/NEORUAA/HyperOS-AVD.git
cd HyperOS-AVD
chmod +x Install.command
./Install.command

r2 → r3:关闭目标 AVD → Installer 1.2.0 选“升级” → 选择原实例与 r3。 自动备份 userdata、QCOW2 和加密密钥,保留应用及个人设置,失败可恢复。r1 先升 r2;已安装旧版实验相机模块时,先按安装指南处理兼容检查。Pad 与手机版不能互相覆盖升级;安装后从安装器或实例目录的 Start.command 启动。

安装 / 升级 / 恢复指南 · Installer 1.2.0 · 发布流程

兼容范围

手机 OS4: r3 全局 HWUI Vulkan,新增原版妙享背屏、独立窗口、双击息屏 / 唤醒及右侧边缘返回;修复锁屏编辑预览花屏。保留桌面手势、Flutter 玻璃、天气 / 相册、完整引导、60 Hz、Mac 色彩和声音适配;新用户默认常亮与 AOD。

Pad OS4: 保留平板布局与原机配置,已核验首次引导、横屏、天气背景与权限弹窗、KernelSU 和冷启动;沿用原厂 yingtian.xml 配置,不开启 AOD。

均为实验镜像:Pad 曾出现模拟器 / Vulkan 同步崩溃,长期稳定性仍需观察;相机基础预览与拍照已有适配,手机后摄录像仍掉帧,Pad 拍照保存存在延迟、录像未验收。蓝牙、小米云服务、Google 登录与 Play Integrity 未完整验证,KSU root 域仍为 permissive。应用商店更新未知原生库版本后可能需要重新适配。

OS3 说明 · 手机 OS4 适配 · Pad OS4 适配 · Pad 验证记录

致谢:小米、MysticGSI、Android Emulator / AOSP、KernelSU。镜像保留 SDK 的 NOTICE.txt,第三方组件归各自权利人所有。

About

HyperOS in the official ARM64 Android Studio Emulator

Resources

Stars

100 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages