30分钟快速上手用Madeira在iPhone上启动你的第一款Windows游戏【免费下载链接】MadeiraRun x86-64 Windows PC games on jailed iOS via FEX-Emu Wine DXMT项目地址: https://gitcode.com/GitHub_Trending/mad/Madeira想用iPhone 运行 Windows 游戏Madeira 是一个把 Wine、FEX-Emu 和 DXMT 整合到一台越狱 iPhone 上的开源项目让 x86-64 Windows PC 游戏直接跑在 iOS 系统上无需越狱。本教程带你 30 分钟完成从环境准备到启动第一款游戏的完整流程。一、先了解Madeira 能玩什么Madeira 的核心理念是让 Windows 游戏以单个 Mach 进程在 iOS 上运行——Wine 的 wineserver 不是独立进程而是作为线程嵌入其中大幅降低了系统开销。目前已可游玩的游戏官方状态游戏状态Thumper✅ 可游玩ULTRAKILL✅ 可游玩Marvel Cosmic Invasion⚠️ 已进入游戏但偶有异常其他 3A 大作⚠️ 低帧率进入属研究性质 这是一个研究项目而非产品请做好遇到边缘问题、每款游戏表现不一的心理准备。架构层面游戏走这样一条链路详见 ARCHITECTURE_ANALYSIS.mdFEX-Emu负责 x86-64 → ARM64 的即时翻译WineARM64EC把 Windows API 翻译成 iOS/Darwin 系统调用DXMT把 DirectX 11 直接翻译成 Apple Metal 图形指令二、开始前的硬件与账号准备在动手之前请确认三样东西齐备一台未越狱的 iPhone开发机为 A15 芯片的 iPhone 13 Pro建议使用 A15 及以上机型一个 Apple ID免费账号即可但注意其描述文件7 天后过期需要每周重新编译安装App 容器会保留游戏进度不丢StikDebugJIT 调试器iOS 上 JIT 需要调试器附加才能工作这是整个方案的基石相关实现在 StikJITHelper.swift⚠️ 正因依赖 JIT 调试器附加该 App无法上架 App Store只能通过侧载安装。三、获取源码第 1–5 分钟在 Mac 上打开终端执行git clone --recurse-submodules https://gitcode.com/GitHub_Trending/mad/Madeira⚠️关键提醒FEX、wine、research/dxmt都是指向特定 fork 的子模块——上游原版克隆过来是编译不过的必须用仓库自带的子模块地址。仓库中已预置了不少即拿即用的产物例如 app/Madeira/ 目录下的libgmp.a、libgnutls.a、libnettle.a静态库以及 app/Madeira/prefix-template.tar.gz 游戏前缀模板首次启动时自动解压生成 Wine 的 C 盘结构。四、编译构建第 5–25 分钟完整构建分为多条工具链全部流程记录在 docs/BUILDING.md。简化路径如下第 1 步检查/准备构建输入仓库外的几样关键输入工具链、iOS 版 LLVM、Metal Shader Converter 安装包等获取方式见 docs/BUILDING.md 的表格。另外别忘了Microsoft Visual C 运行库——仓库不含这些 DLL需要自行从vc_redist.x64.exe提取步骤见 tools/fetch-vcruntime.md。第 2 步按顺序执行原生构建链GnuTLS/GMP/Nettle → 生成四个静态库FEXbuild/fex-ios/build.sh与build/fex-arm64ec/build.shWine unix 侧与 PE 侧 DLLntdll.dll等产物已随仓库分发在 app/Madeira/arm64ec-windows/DXMT 与 D3D12 运行时产物如 app/Madeira/arm64ec-windows/madeira_d3d12.dll 已内置原生 D3D12 运行库如果你只是普通玩家仓库里已经跟踪了大部分预编译产物可以直接跳到第 3 步。第 3 步用 Xcode 构建 Appxcodebuild -project app/Madeira.xcodeproj -scheme Madeira \ -destination generic/platformiOS -allowProvisioningUpdates build然后打包Payload/Madeira.app为 IPA用免费 Apple ID 签名侧载到手机。 小坑预警Debug 配置才是能跑游戏的配置——Release 构建曾导致游戏崩溃别搞混了。五、部署并启动你的第一款游戏第 25–30 分钟App 首次启动会自动解压前缀模板创建 Wine 的drive_c目录结构。接下来把游戏塞进C 盘xcrun devicectl device copy to \ --device 设备ID \ --source Mac上的游戏目录 \ --destination Documents/wine/drive_c/Program Files/游戏名 \ --domain-type appDataContainer \ --domain-identifier com.madeira.emulator这条命令与仓库中的 scripts/deploy-thumper.sh 完全一致——从 Wine 的视角看游戏就躺在C:\Program Files\下。870MB 左右的 Thumper 大约推送 30–60 秒。然后打开 Madeira App点击Run Thumper (D3D11 / win10)你的第一款 Windows 游戏就在 iPhone 上跑起来了六、怎么操作手柄与触屏输入Madeira 通过统一的 XInput 快照支持物理手柄和触屏两套输入详细说明见 docs/CONTROLLERS.md蓝牙手柄配对的 iOS 手柄以 250Hz 采样最多 4 个物理手柄槽位断开不会打乱其他槽位触屏虚拟手柄横屏下打开触摸编辑器把 A/B/X/Y、摇杆 LT/RT、LB/RB 等映射到屏幕任意位置触屏输入会合并到 1 号玩家混合输入物理按键与触屏可同时使用扳机取较大值物理摇杆优先想关闭相关功能时在Documents/madeira.cfg中设置env.MADEIRA_XINPUT 0或env.MADEIRA_TOUCH_XINPUT 0即可。七、常见问题速查问题解答装 7 天后闪退免费 Apple ID 描述文件过期重新编译安装即可进度保留能上 App Store 吗不能JIT 需要调试器附加游戏存档在哪App 容器内Documents/wine/下重装不丢帧率低正常吗正常这是研究项目3A 大作普遍低帧率许可证项目为GPL-3.0-or-later见 LICENSE 与 docs/LICENSING.md写在最后30 分钟后当 Thumper 的节奏在 iPhone 里敲起来的那一刻你会理解这个项目真正的意义——它证明了Windows x86 游戏在纯 iOS 环境跑通是完全可行的。接下来可以阅读 docs/BUILDING.md 深入各构建链细节或参考 CONTRIBUTING.md 参与这个仍在高速演进的研究项目。【免费下载链接】MadeiraRun x86-64 Windows PC games on jailed iOS via FEX-Emu Wine DXMT项目地址: https://gitcode.com/GitHub_Trending/mad/Madeira创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考