Madeira

项目概述

Madeira 让 Windows PC 游戏在 iPhone 上免越狱运行，游戏不经修改、以原样跑在一个 iOS 应用里。它是一个活跃的研究项目，不少游戏能启动、一些能流畅玩，但性能与兼容性因游戏而异，变化很快。

技术栈由四层组成：FEX-Emu 在运行时把 x86/x86-64 代码转译为 ARM64；Wine 11.4 以 ARM64EC 构建，自身原生运行、只转译游戏代码，32 位游戏走 WoW64；DXMT 用 Metal 实现 Direct3D 9/10/11；自研的 madeira-d3d12 则用 Metal Shader Converter 在运行时转换 DXIL 着色器实现 Direct3D 12。

项目	内容
平台	iPhone，iOS 26+
形态	IPA 侧载分发
图形	DXMT（D3D9/10/11）与 madeira-d3d12（D3D12）
许可	GPL-3.0 或更高

把一台 Windows 游戏机塞进 iPhone：免越狱、单进程、游戏原样跑。

主要功能

• 游戏库：带封面图与搜索的游戏库，内含一个 Windows 桌面会话
• Steam 集成：登录后浏览已拥有的游戏，通过 Valve 官方 Windows Steam 客户端（Madeira Dock）安装、更新并启动
• Steam 云存档：启动 Madeira 与启动游戏前同步存档，双向变更不覆盖、被替换内容有备份
• 手柄支持：经 XInput 连接蓝牙手柄，另有可自定义的屏幕触控控件
• 键鼠穿透：键盘、鼠标与触控板作为真实输入设备传给游戏
• 影音支持：过场动画与音乐经 FFmpeg、VideoToolbox 与 AudioToolbox 播放
• 单进程架构：iOS 不允许拉起其他程序，连 Wine server 也以线程形式运行

适用人群

• 想在 iPhone 上玩 Steam 游戏库的玩家
• 对 x86 转译与图形层转译感兴趣的技术爱好者
• 愿意折腾侧载与 JIT 设置的进阶 iOS 用户
• 关注 Wine 与 FEX 项目的研究者

快速上手

1. 从最新 Release 下载 IPA
2. 用 SideStore、AltStore、Sideloadly 等工具以自己的 Apple ID 侧载
3. 打开 Madeira 并启用 JIT（可用 StikDebug 或内置 StikJIT 引导）
4. 在设置中确认 JIT 与 Memory+ 均为绿色对勾，显示 Ready to play
5. 登录 Steam 或导入本地游戏，开始安装游玩

核心优势

• 原样运行：游戏不做修改，兼容层全部在系统层面解决
• 原生优先：Wine 以 ARM64EC 原生运行，只转译游戏自身代码，损耗更低
• D3D12 自研：不依赖第三方 D3D12 方案，DXIL 运行时转换自主可控
• 存档安心：云存档冲突不盲覆，任何替换都有备份

系统要求

项目	要求
设备	iPhone（iOS 26 或更高）
JIT	依赖调试器附加，用 StikDebug 或内置 StikJIT
侧载	任意 Apple ID，免费账号签名 7 天有效
可选	部分 64 位游戏需要 Microsoft VC++ 运行时（不随包附带）

注意事项

• 研究项目：兼容性与性能因游戏而异，随时变化，请对毛边有心理预期
• 无法上架：JIT 依赖调试器，Madeira 不可能出现在 App Store
• 免费签名限时：免费 Apple ID 签名 7 天过期需续签，游戏与存档在重装间保留