okooooooo/UniXNU
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge pull request #74 from UniXNU/docs/qemu-metal

Browse Source 
docs: record the QEMU Metal device on the Mac GPU
This commit is contained in:
UniXNU Docs committed 2026-10-23 00:25:41 +08:00
2 parents e19e517448 2b1e3a9aee
commit 86740fd459
4 files changed
+12 -10
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

docs/devices/index.md
+1 -1
View File
@@ -13,7 +13,7 @@ The ports listed here are independent. Their maintainers own the repositories; t
| Device | SoC | State | Maintainer |
| --- | --- | --- | --- |
| [DroidVM guest (crosvm on Gunyah)](/devices/droidvm) | crosvm-gunyah | iPadOS 17 home screen; CPU presentation; Metal widgets and icons; virtio-net works | Droid-VM |
| [QEMU virt](/devices/qemu) | QEMU virt | iPadOS 17 home screen and Settings; CPU-rendered | xVanTuring |
| [QEMU virt](/devices/qemu) | QEMU virt | iPadOS 17 home screen and Settings; Metal on the Mac GPU with `--metal` | xVanTuring |
| [Lenovo Xiaoxin Pad 2022 (tb128fu)](/devices/tb128fu) | SM6225 | iPadOS 17 home screen with touch; Metal frames presented by the GPU; Adreno 610 runs | xVanTuring |
| [Xiaomi 13 (fuxi)](/devices/fuxi) | SM8550 | Kernel links and prelinks; stage B archive chain near complete; no hardware run | matejkoo217, hanzi123-bilp |
| [OnePlus 7 Pro (guacamole)](/devices/guacamole) | SM8150 | iOS 16.7.16 userland reached; GPU pending | wochgn |
docs/devices/qemu.md
+5 -4
View File
@@ -4,7 +4,7 @@ The QEMU target runs UniXNU on the AArch64 `virt` machine. It substitutes for a
| Repository | Maintainer | State |
| --- | --- | --- |
| [UniXNU-qemu](https://github.com/xVanTuring/UniXNU-qemu) | [xVanTuring](https://github.com/xVanTuring) | iPadOS 17 home screen and Settings |
| [UniXNU-qemu](https://github.com/xVanTuring/UniXNU-qemu) | [xVanTuring](https://github.com/xVanTuring) | iPadOS 17 home screen and Settings; Metal on the Mac GPU with `--metal` |
## State
@@ -17,11 +17,12 @@ The QEMU target runs UniXNU on the AArch64 `virt` machine. It substitutes for a
| AMFI and original launchd | start with the original trust cache |
| SystemOS union and dyld shared cache | work |
| Data ramdisk | works |
| Display | NativeLegacyDisplay on ramfb; CPU-rendered |
| Display | NativeLegacyDisplay on ramfb; CPU-rendered without `--metal`, and composed on the Mac's GPU with `--metal` |
| Touch and Home | work; typing not yet |
| GPU | no Metal device |
| GPU | QemuMetal device; `--metal` runs the render server's Metal work on the Mac's GPU. Without it there is no Metal device and QuartzCore uses the CPU renderer |
| Settings | without `--metal` it stays white; with it the app opens and lists everything, with some row icons missing |
The repository README records the commands that stage the ESP and boot QEMU.
`--metal` needs the plugin, owner trust cache and Data seed built by `scripts/build-qemu-metal.py`. The repository README records the commands that stage the ESP and boot QEMU.
## Maintenance
docs/zh/devices/index.md
+1 -1
View File
@@ -13,7 +13,7 @@
| 设备 | SoC | 状态 | 维护者 |
| --- | --- | --- | --- |
| [DroidVM 客户机（Gunyah 上的 crosvm）](/zh/devices/droidvm) | crosvm-gunyah | iPadOS 17 主屏幕，CPU 呈现，Metal widget 和图标，virtio-net 工作 | Droid-VM |
| [QEMU virt](/zh/devices/qemu) | QEMU virt | iPadOS 17 主屏幕和 Settings，CPU 渲染 | xVanTuring |
| [QEMU virt](/zh/devices/qemu) | QEMU virt | iPadOS 17 主屏幕和 Settings；使用 `--metal` 时在 Mac GPU 上运行 Metal | xVanTuring |
| [联想小新 Pad 2022（tb128fu）](/zh/devices/tb128fu) | SM6225 | 已到 iPadOS 17 主屏幕，触控可用；Metal 帧由 GPU 呈现；Adreno 610 已运行 | xVanTuring |
| [小米 13（fuxi）](/zh/devices/fuxi) | SM8550 | 内核可链接和预链接，阶段 B archive 链接近完成，未在真机运行 | matejkoo217、hanzi123-bilp |
| [一加 7 Pro（guacamole）](/zh/devices/guacamole) | SM8150 | 已到达 iOS 16.7.16 用户态，GPU 待完成 | wochgn |
docs/zh/devices/qemu.md
+5 -4
View File
@@ -4,7 +4,7 @@ QEMU 目标在 AArch64 `virt` 机器上运行 UniXNU，用于在没有平板时
| 仓库 | 维护者 | 状态 |
| --- | --- | --- |
| [UniXNU-qemu](https://github.com/xVanTuring/UniXNU-qemu) | [xVanTuring](https://github.com/xVanTuring) | iPadOS 17 主屏幕和 Settings |
| [UniXNU-qemu](https://github.com/xVanTuring/UniXNU-qemu) | [xVanTuring](https://github.com/xVanTuring) | iPadOS 17 主屏幕和 Settings；使用 `--metal` 时在 Mac GPU 上运行 Metal |
## 状态
@@ -17,11 +17,12 @@ QEMU 目标在 AArch64 `virt` 机器上运行 UniXNU，用于在没有平板时
| AMFI 和原始 launchd | 使用原始 trust cache 启动 |
| SystemOS union 和 dyld shared cache | 工作 |
| Data ramdisk | 工作 |
| 显示 | ramfb 上的 NativeLegacyDisplay，CPU 渲染 |
| 显示 | ramfb 上的 NativeLegacyDisplay；不带 `--metal` 时 CPU 渲染，带 `--metal` 时由 Mac GPU 合成 |
| 触控和 Home | 工作，键盘输入尚未工作 |
| GPU | 没有 Metal 设备 |
| GPU | QemuMetal 设备；`--metal` 让 render server 的 Metal 工作跑在 Mac GPU 上。不带该选项时没有 Metal 设备，QuartzCore 使用 CPU 渲染 |
| Settings | 不带 `--metal` 时为白屏；带上后可以打开并列出全部项目，部分行图标缺失 |
仓库 README 记录了构建 ESP 和启动 QEMU 的命令。
`--metal` 需要 `scripts/build-qemu-metal.py` 生成的插件、owner trust cache 和 Data 种子。仓库 README 记录了构建 ESP 和启动 QEMU 的命令。
## 维护