在 iPhone 上原生运行 Windows 游戏？Madeira 让非越狱 iOS 设备变身掌上 PC 游戏机

你是否想过，不用越狱、不依赖云游戏、不连电脑，仅靠一台 iPhone 就能直接启动《Thumper》《ULTRAKILL》等 Windows PC 游戏？Madeira 正是这样一个突破性开源项目——它不是模拟器套壳，也不是远程串流，而是通过深度定制的跨架构翻译与图形栈重定向技术，在 iOS 系统底层构建出一个“可执行 Windows PE 程序”的封闭沙盒环境。它解决了 iOS 长期以来因 ABI 锁定、JIT 限制和图形 API 隔离导致的“无法原生运行 x86-64 Windows 游戏”这一根本性难题。

核心功能

非越狱 iPhone 直接运行 Windows 游戏：无需越狱、无需 Mac 远程控制、无需订阅服务，仅需 sideload 安装，即可在 A15 及更新芯片的 iPhone（如 iPhone 13 Pro）上本地启动 Windows 游戏可执行文件（.exe），真正实现“手机即主机”。
完整 x86-64 → ARM64 指令实时翻译：基于定制版 FEX-Emu 实现高性能二进制翻译，将 Windows 游戏的 x86-64 机器码动态转译为 iOS 原生 ARM64 指令，绕过 Apple 对 x86 指令的硬件级封锁，且支持复杂控制流与系统调用拦截。
D3D11 游戏画面无缝转译至 Metal：集成 DXMT（DirectX-to-Metal）修改版，将游戏调用的 Direct3D 11 API 调用逐层映射为 iOS 原生 Metal 绘图指令，避免 OpenGL ES 兼容层带来的性能损耗与渲染错误，保障光影、粒子与后处理效果基本可用。
单进程沙盒化 Wine 运行时：颠覆传统 Wine 多进程模型，将 wineserver 作为线程嵌入主 Mach 进程，消除进程间 IPC 开销与 iOS 对后台进程的严格管控，显著提升响应速度并规避系统级杀进程行为。
ARM64EC 兼容模式支持：针对微软 ARM64EC（Emulation Compatible）规范进行深度适配，使 Wine 能以混合模式加载部分 ARM64 原生 DLL 与 x86-64 PE 模块，减少翻译压力，提升关键路径性能。
用户数据持久化保障：利用 iOS App Container 机制，Wine Prefix（含注册表、C盘模拟目录）、存档文件、配置均保存在应用沙盒内；即使每周需重签名重装（因免费 Apple ID 证书 7 天过期），所有游戏进度与设置自动保留，无需重复配置。
调试级 JIT 启用方案落地：通过 StikDebug 工具在运行时附加调试器，合法触发 iOS 的 JIT 编译权限（Apple 要求调试器存在才允许动态代码生成），为 FEX 的运行时翻译提供合规基础，避开企业签名或开发者账号年费门槛。
Visual C++ 运行库按需注入支持：项目明确要求用户自行获取微软官方 vcruntime140.dll 等 VC++ 2015–2022 运行库 DLL，并通过工具链注入到 Wine Prefix 中，确保依赖完整的 Windows 运行环境，避免“缺少 dll”类崩溃。

技术亮点

三层协同架构设计：Madeira 并非简单堆砌组件，而是构建了“FEX（CPU 指令翻译）→ Wine（Windows API 兼容层）→ DXMT（GPU 图形翻译）”的垂直栈，三者深度耦合：FEX 提供寄存器状态透传，Wine 修改为 ARM64EC 模式以减少 ABI 转换开销，DXMT 则复用 FEX 的内存管理器实现 GPU 内存零拷贝映射，形成低延迟闭环。
全栈 GPL-3.0 强制开源治理：作者对上游 Wine、FEX、DXMT 均创建了专属 fork，并依据 LGPL-2.1 §3 条款将 Wine 重新授权为 GPL-3.0，FEX/DXMT 的修改部分也明确采用 GPL-3.0，确保所有衍生分发必须开源——这既是法律合规要求，也倒逼社区共同维护 iOS 适配补丁，避免碎片化。
规避 App Store 分发限制的工程智慧：主动放弃上架可能，转而利用 Xcode 自签名 + StikDebug JIT 注入组合，在不违反 Apple 开发者协议前提下达成技术目标；其 build.sh 脚本严格分离 Unix 侧编译（Linux/macOS）与 iOS 侧构建（xcodebuild），体现对平台隔离的清醒认知。
AI 辅助开发但严守上游贡献边界：README 明确指出核心 fork 中大量使用 AI 辅助重构与注释生成，但同步强调“绝不向 FEX-Emu 等上游提交 AI 生成代码”，尊重各项目贡献政策（如 FEX 禁止 AI 代码），体现负责任的开源协作观。

适合哪些人用

Madeira 不是面向普通用户的“一键安装”工具，而是为资深 iOS 开发者、逆向工程师、Wine/FEX 贡献者及硬核游戏技术爱好者打造的研究型平台。它适合两类真实场景：

场景一：iOS 图形兼容性研究者——你想验证某款 D3D11 游戏在 Metal 下的纹理采样精度、深度测试行为或异步计算队列调度表现？Madeira 提供了最贴近真实设备的测试沙盒，所有 DXMT 修改可直接调试，日志粒度达 API 调用级。

场景二：ARM64 Windows 游戏移植探路者——你正在为一款独立游戏开发 ARM64 版本，但缺乏真机测试环境？通过 Madeira 运行 x86-64 原版，可快速暴露 ARM64EC 混合调用中的栈对齐、浮点异常或原子操作竞态问题，比纯 QEMU 模拟更反映实际芯片特性。

快速上手

确保已安装 Xcode、Command Line Tools、Homebrew；使用 Apple ID 登录 Xcode 并启用自动签名。执行以下命令：

git clone --recurse-submodules https://github.com/willfaust/Madeira
cd Madeira
# 构建底层依赖（需 macOS/Linux 环境）
./build/fex/build.sh
./build/dxmt/build.sh
./build/wine/build.sh
# 构建 iOS App（需 Xcode）
xcodebuild -project Madeira.xcodeproj -scheme Madeira -destination 'platform=iOS,name=Your iPhone' build

安装 StikDebug 后连接 iPhone，运行 StikDebug 并选择 Madeira 进程附加调试器，随后启动应用即可。首次运行会提示安装 VC++ 运行库，请参照 tools/fetch-vcruntime.md 下载对应版本并放入 ~/.wine/drive_c/windows/system32/。

同类对比 / 注意事项

vs. Parallels Mobile（已下架）：Parallels 依赖虚拟化扩展，仅限 M1 iPad；Madeira 无硬件虚拟化要求，A15 iPhone 即可运行，但牺牲了完整 Windows 系统支持，专注游戏可执行文件。
vs. Cloud Gaming（如 GeForce NOW）：Madeira 所有计算在本地完成，无网络延迟、无订阅费用、无内容版权限制，但游戏兼容性远低于云端 Windows 实例。
重要注意事项：目前仅 Thumper、ULTRAKILL 等少数游戏达到流畅可玩水平；Marvel Cosmic Invasion 存在随机崩溃与触控失灵；所有游戏需手动配置分辨率（默认 1280×720）、关闭垂直同步；A14 及更早芯片暂未验证，不建议尝试。