iOS 16.1/17 compatibility fork
面向旧版 iOS 设备的兼容性开发分支，包含传统 Metal 渲染路径、按设备划分的着色器约束和逐构建游戏适配。维护分支现已更名为 ios16-ios17-compat；它是实验性的源码构建路线，并非通用的即装即玩包。
第三方核对于 2026 年 11 月 3 日
使用要求
- 使用更名后仍在维护的 ios16-ios17-compat 分支；main 保留上游基线，旧分支名和标签仅作归档。
- legacy 路径面向 iOS / iPadOS 16.1+，区分 a10x 和 m2 GPU 目标；Metal 4 路径要求 iOS 26 且仍属实验性，一个 IPA 不能同时覆盖两类路径。
操作步骤
- 进入分支，先阅读 docs/fork-status.md 中当前游戏和设备验证表。
- 选择 legacy 或 Metal 4 渲染器及匹配的设备目标；文档中的选择变量为 DM_IOS_RENDERER 和 DM_LEGACY_TARGET。
- 按该分支的构建文档使用自己的游戏文件和密钥；固定源码版本，并为每款游戏重建匹配的着色器资源。
- 为所选目标打包并在对应设备测试；分别记录游戏画面与实际游玩结果，不能仅以构建或安装成功判断可玩。
使用与排错
- 截至 2026-11-01，用户确认 M2 上《动物森友会》可玩；M2 iPad 在 iPadOS 16.1 上可玩《巫师 3》，约 30 帧，但仍可能出现画面异常。M2 的 Need for Speed 也已由用户确认可玩，间歇性场景画面异常和音频卡顿仍未解决。
- Pokken 在 M2 上画面已恢复，但长时间运行和 A10X 结果尚未确认。Arceus 在一台 Air 上恢复第三人称画面，仍有可复现的任务结束崩溃；A10X 的分层资源审计仍未通过。
- 《宝可梦传说 Z-A》安装包可以安装，但不能据此认定所有场景或设备通过验证；目前也没有经过确认的 Switch 2 iOS 目标。A10X 在若干游戏上仍受分层渲染与采样路径限制。
- 现代帧插值仍属实验功能；项目未承诺稳定 120 帧或所有旧设备通用兼容，构建与打包成功不等于可玩。