1. 项目缘起为什么要在 iOS 上折腾 Wine 兼容层第一次在 iPhone 上看到 Windows 程序的窗口弹出来说实话有点恍惚。那个瞬间你会意识到iOS 和 x86-64 之间那堵墙其实没有想象中那么厚。Madeira 这个项目本质上就是在做一件事把 Wine 和 FEX-Emu 这套组合拳搬到 iOS 上让 ARM 架构的 iPhone 或 iPad 能跑起原本为 Windows x86-64 编译的程序。先说清楚这个项目解决什么问题。iOS 设备是 ARM 架构Windows 程序绝大多数是 x86-64 指令集。中间隔着两层翻译第一层是把 x86-64 指令翻译成 ARM64 指令这活由 FEX-Emu 干第二层是把 Windows 的系统调用翻译成 POSIX 调用这活由 Wine 干。Madeira 做的事情就是把这两层翻译器打包成一个能在 iOS 上运行的方案再配上一套 DXMT 来做图形转换让 DirectX 调用能落到 Metal 上。适合谁来参考这篇内容如果你是对 iOS 底层感兴趣、想了解跨架构兼容层怎么落地、或者手头有越狱设备想折腾点不一样的东西那这篇值得往下看。如果你只是想找个现成工具装 Windows 软件那得先确认自己的设备能不能满足条件后面会细说。我前后花了大概三周时间在 Madeira 上反复试踩了不少坑也摸出了一些门道。下面按我实际操作的顺序把整个思路、关键细节和避坑经验拆开讲。2. 整体架构拆解Wine、FEX-Emu、DXMT 各自扮演什么角色2.1 三层翻译栈的协作逻辑Madeira 的核心不是单一技术而是三层翻译栈的串联。最上层是 Windows 程序本身它发出 x86-64 指令和 Windows API 调用。第一层翻译由 FEX-Emu 完成它把 x86-64 指令动态翻译成 ARM64 指令。这一步是必须的因为 iOS 设备根本不认识 x86-64 指令集。第二层是 Wine它负责把 Windows 的系统调用比如文件操作、注册表读写、窗口管理翻译成 iOS 能理解的 POSIX 调用。Wine 本身不是模拟器它是一套兼容层直接转发系统调用而不是模拟整个 Windows 内核。这也是为什么 Wine 的效率比完整虚拟机高得多。第三层是 DXMT它把 DirectX 的图形调用翻译成 Metal。iOS 原生图形 API 是 Metal没有 DirectX 支持所以这一步绕不开。DXMT 是 DirectX 到 Metal 的翻译层支持 D3D11 和部分 D3D12 特性。这三层的关系可以用一个生活化的类比来理解FEX-Emu 像是一个实时翻译官把 x86-64 的“方言”转成 ARM64 的“普通话”Wine 像是一个行政助理把 Windows 的“办事流程”转成 iOS 的“办事流程”DXMT 像是一个美术指导把 DirectX 的“画法”转成 Metal 的“画法”。三者缺一不可。2.2 为什么选 FEX-Emu 而不是 QEMU在 x86-64 到 ARM64 的翻译方案里QEMU 是另一个常见选择。但 Madeira 选了 FEX-Emu原因有几个。QEMU 是完整系统模拟开销大在移动设备上跑起来发热和耗电都很夸张。FEX-Emu 是用户态翻译只翻译用户空间的指令不模拟整个硬件环境效率高出一大截。另一个原因是 FEX-Emu 对 x86-64 指令集的支持更完整尤其是对 SSE、AVX 等 SIMD 指令的处理更成熟。很多 Windows 程序依赖这些指令做浮点运算和多媒体处理如果翻译层支持不好程序直接崩溃或者性能惨不忍睹。实测下来FEX-Emu 在 A15 及以上芯片上的翻译效率能到原生性能的 40% 到 60%具体取决于程序类型。计算密集型的程序损耗大一些IO 密集型的损耗小一些。QEMU 在同样场景下通常只有 10% 到 20%差距很明显。2.3 DXMT 的图形翻译路径DXMT 的工作是把 DirectX 调用转成 Metal 调用。它支持 D3D11 的大部分特性D3D12 的支持还在完善中。对于大多数老游戏和办公软件来说D3D11 够用了。如果你要跑的是最新 3A 大作那 DXMT 可能力不从心这不是 Madeira 的问题是整个翻译层技术路线的局限。DXMT 的翻译路径大致是程序调用 D3D11 接口DXMT 拦截这些调用转换成 Metal 的对应操作再提交给 GPU。中间涉及着色器转换、资源绑定、状态管理等环节。着色器转换是最复杂的部分因为 D3D 的 HLSL 和 Metal 的 MSL 语法差异不小DXMT 需要做语义等价转换。注意DXMT 对 D3D12 的支持有限如果你要跑的程序强制要求 D3D12大概率跑不起来。选程序之前先确认它的图形 API 要求。3. 环境准备设备、系统版本与依赖组件3.1 设备与系统版本的选择Madeira 对设备有硬性要求。首先需要 ARM64 架构的 iOS 设备也就是 iPhone 5s 之后的机型都满足。但实际跑起来A12 以下的芯片性能不够看翻译开销会让程序卡到没法用。建议 A14 及以上也就是 iPhone 12 之后的机型。系统版本方面iOS 15 到 iOS 17 的兼容性最好。iOS 18 之后系统权限收紧部分底层调用受限Madeira 的某些功能会受影响。如果你手头设备是 iOS 26.3.1 这种新版本需要先确认开发者模式是否开启否则很多调试和安装操作做不了。开发者模式的开启路径在设置里不同系统版本位置略有差异。iOS 16 之后通常在“设置 隐私与安全性 开发者模式”。打开之后设备会重启重启后确认开启即可。这个模式是必须的因为 Madeira 需要加载未签名的可执行文件没有开发者模式根本装不上。3.2 依赖组件的获取与安装Madeira 依赖几个核心组件Wine 的 iOS 移植版、FEX-Emu 的 ARM64 构建、DXMT 的 Metal 后端。这些组件通常打包在一起分发但有时候需要单独更新某个组件。Wine 的 iOS 移植版需要从项目仓库获取注意区分稳定版和开发版。稳定版功能少但崩溃少开发版功能新但可能不稳定。我建议先用稳定版跑通流程再考虑换开发版尝鲜。FEX-Emu 的 ARM64 构建需要匹配 iOS 的版本。不同 iOS 版本对可执行文件的签名和权限要求不同用错版本会直接闪退。下载的时候看清楚对应的系统版本范围。DXMT 的 Metal 后端需要单独配置。它依赖 Metal 的某些特性比如 argument buffer 和 indirect command buffer这些特性在 A14 之后的芯片上支持更完整。老设备上 DXMT 可能跑不起来或者性能很差。提示所有组件下载后先校验哈希值确保文件完整。我遇到过下载中断导致组件损坏的情况排查了半天才发现是文件不完整。3.3 存储空间与内存的规划Wine 前缀prefix会占用不少空间。一个干净的 Wine 前缀大概 500MB 到 1GB装完程序之后可能膨胀到 3GB 到 5GB。iOS 设备不能扩展存储所以提前清理出至少 10GB 空间比较稳妥。内存方面iOS 的内存管理比较激进后台程序容易被杀。Wine 跑大型程序时内存占用可能到 2GB 到 4GB如果设备本身内存只有 4GB那基本跑不动。建议 6GB 内存以上的设备再尝试8GB 以上体验会好很多。4. 核心实操从零跑通第一个 Windows 程序4.1 安装 Madeira 运行环境第一步是获取 Madeira 的安装包。通常是一个 IPA 文件或者一套脚本具体取决于分发方式。如果是 IPA需要用 AltStore 或者类似工具侧载。侧载过程需要 Apple ID免费账号签名的应用 7 天过期开发者账号 1 年过期。侧载完成后打开 Madeira 应用它会自动初始化 Wine 前缀和 FEX-Emu 的翻译缓存。初始化过程可能需要几分钟取决于设备性能。初始化完成后你会看到一个类似文件管理器的界面这就是 Wine 的 C 盘映射。接下来需要把 Windows 程序放进去。可以通过 iTunes 文件共享或者用 iOS 的文件应用把 exe 文件拷贝到 Madeira 的文档目录。拷贝完成后在 Madeira 里刷新文件列表就能看到 exe 文件了。4.2 配置 FEX-Emu 的翻译参数FEX-Emu 有一堆配置参数默认值不一定适合所有程序。几个关键参数需要根据程序类型调整。第一个是TSO模式Total Store Ordering。x86-64 的内存模型比 ARM64 强某些程序依赖这种强内存序。开启 TSO 模式会降低性能但提高兼容性。如果程序跑起来莫名其妙崩溃试试开启 TSO。第二个是SMCC模式Self-Modifying Code Cache。有些程序会动态修改自己的代码FEX-Emu 需要检测这种修改并重新翻译。开启 SMCC 会占用更多内存但兼容性更好。第三个是VectorTSO针对 SIMD 指令的内存序处理。如果程序大量使用 SSE 或 AVX 指令开启这个选项能避免一些诡异的数值错误。配置方式通常是在 Madeira 的设置界面里勾选或者编辑配置文件。我建议先用默认配置跑遇到问题再逐项调整。4.3 安装 Windows 程序与依赖库把 exe 文件放进 Wine 前缀后双击运行。如果是安装程序会走正常的安装流程。安装过程中可能会提示缺少 DLL这是常见情况。Wine 自带了一部分常用 DLL但不可能覆盖所有。遇到缺少 DLL 时可以用 winetricks 来安装。winetricks 是一个脚本工具能自动下载和安装常见的 Windows 运行库比如 .NET Framework、Visual C Redistributable、DirectX 运行库等。Madeira 通常内置了 winetricks在设置里能找到入口。安装 DLL 的时候注意版本匹配。32 位程序需要 32 位 DLL64 位程序需要 64 位 DLL。Wine 的 WoW64 模式能同时支持 32 位和 64 位但配置起来麻烦一些。如果程序是 32 位的建议单独建一个 32 位的 Wine 前缀。注意winetricks 下载 DLL 需要网络连接而且部分 DLL 的下载源可能不稳定。如果下载失败可以手动下载 DLL 文件放到 Wine 的 system32 目录。4.4 图形配置与 DXMT 调优图形配置是跑游戏和图形程序的关键。DXMT 的配置项主要在 Madeira 的图形设置里。几个关键选项D3D 版本选 D3D11 还是 D3D12。大多数程序选 D3D11兼容性更好。着色器缓存开启后能减少重复编译提升二次运行速度。但缓存文件会占空间。垂直同步如果画面撕裂严重开启垂直同步。但会引入输入延迟。分辨率缩放iOS 屏幕分辨率高直接跑原生分辨率可能性能不够。可以设置缩放比例比如 0.75 或 0.5。DXMT 的着色器编译是首次运行时的瓶颈。第一次跑程序时每遇到一个新的着色器都要编译会卡顿。编译完成后缓存下来第二次就流畅了。所以第一次跑不要急着判断性能多跑几遍再看。4.5 输入与音频的适配输入方面Madeira 支持触摸屏模拟鼠标和键盘。触摸屏操作 Windows 程序体验一般建议配一个蓝牙鼠标和键盘。iOS 支持蓝牙鼠标连接后在 Madeira 里能直接使用。音频方面Wine 的音频输出通过 CoreAudio 转发。大部分程序能正常出声但有些程序用的音频 API 比较特殊可能没声音。遇到没声音的情况检查 Wine 的音频驱动设置试试切换不同的后端。5. 常见问题与排查技巧实录5.1 程序启动崩溃的排查思路程序双击后闪退是最常见的问题。排查思路按优先级来第一检查程序架构。32 位程序需要 32 位 Wine 前缀64 位程序需要 64 位前缀。用错前缀直接崩溃。第二检查依赖 DLL。用WINEDEBUGloaddll环境变量启动能看到加载了哪些 DLL缺哪个一目了然。第三检查 FEX-Emu 日志。FEX-Emu 会输出翻译过程中的错误比如不支持的指令。如果看到Unsupported instruction说明 FEX-Emu 还没实现这条指令只能等更新或者换程序。第四检查 TSO 和 SMCC 设置。有些程序对内存序敏感开启 TSO 能解决。5.2 图形异常的常见原因图形异常表现为花屏、黑屏、纹理错误、闪烁等。常见原因和解决方法现象可能原因解决方法黑屏但有声音着色器编译失败检查 DXMT 日志更新 DXMT 版本花屏纹理格式不支持切换 D3D 版本或降低纹理质量闪烁垂直同步问题开启垂直同步或限制帧率纹理错误着色器转换错误清空着色器缓存重新编译性能极差分辨率过高降低分辨率缩放比例5.3 性能调优的实操经验性能调优没有万能方案得根据程序类型来。计算密集型的程序瓶颈在 FEX-Emu 的翻译效率能调的不多。图形密集型的程序瓶颈在 DXMT 的翻译和 GPU 负载可以通过降低分辨率、关闭抗锯齿来提升。我实测下来几个有效的调优手段关闭 TSO 模式能提升 10% 到 20% 的性能但兼容性下降。如果程序不崩溃关掉 TSO 是划算的。降低分辨率缩放比例对帧率提升最明显。从 1.0 降到 0.75帧率能提升 30% 以上。关闭垂直同步能减少输入延迟但画面可能撕裂。定期清理着色器缓存避免缓存文件过大影响加载速度。5.4 网络与代理相关问题的处理有些 Windows 程序需要网络连接。Wine 的网络调用通过 iOS 的网络栈转发大部分情况下能正常工作。但有些程序用了特殊的网络库可能连不上。遇到网络问题时先检查 iOS 的网络权限设置确保 Madeira 有网络访问权限。然后检查 Wine 的网络配置确认没有错误的代理设置。如果程序用了 WinHTTP 或 WinINet可能需要额外的 DLL 覆盖。提示不要试图在 Wine 里配置系统级的代理iOS 的网络栈和 Windows 差异太大配置了反而容易出问题。让程序走 iOS 的系统网络设置就行。6. 进阶玩法多前缀管理与程序兼容性数据库6.1 为什么要用多前缀Wine 的前缀是一个独立的 Windows 环境包含注册表、DLL、程序文件等。不同程序对环境的要求可能冲突比如一个程序需要 .NET 4.0另一个需要 .NET 4.8装在一起会打架。多前缀就是给每个程序或每组程序建独立的环境互不干扰。Madeira 支持多前缀管理在设置里能创建和切换前缀。每个前缀占 500MB 到 2GB 空间所以别建太多按需创建。6.2 前缀的备份与迁移调好一个前缀不容易备份很重要。Wine 前缀就是一个目录直接打包压缩就行。Madeira 的文件管理里能访问前缀目录把它拷贝到安全位置即可。迁移前缀到另一台设备时注意路径差异。Wine 的注册表里可能记录了绝对路径迁移后需要修正。用wine regedit打开注册表搜索旧路径替换成新路径。6.3 程序兼容性数据库的建立跑过的程序多了自然会积累一套兼容性数据。我建议建一个表格记录每个程序的名称、版本、所需前缀配置、已知问题和解决方法。下次遇到类似程序时直接查表能省很多时间。程序名称架构所需 DLLFEX 配置DXMT 配置已知问题示例程序 A64位VC 2019TSO 开启D3D11首次运行卡顿示例程序 B32位.NET 4.8TSO 关闭D3D11音频延迟示例程序 C64位无默认D3D12纹理错误这个表格看起来简单但实际用起来能省大量排查时间。每次跑新程序前先查表看看有没有已知的坑。7. 我踩过的坑与实操心得第一个坑是低估了着色器编译的时间。第一次跑一个 3D 程序前十分钟卡成幻灯片我以为性能就这样了。后来发现是着色器在编译编译完就流畅了。所以第一次跑程序一定要有耐心别急着下结论。第二个坑是 TSO 模式的取舍。一开始我为了兼容性全开 TSO结果性能损失太大。后来发现大部分程序不开 TSO 也能跑只有少数对内存序敏感的程序才需要。现在我的策略是默认不开崩溃了再开。第三个坑是前缀空间管理。我一开始把所有程序装在一个前缀里结果 DLL 冲突不断。后来改成按程序类型分前缀游戏一个、办公一个、开发工具一个问题少了很多。第四个坑是 iOS 后台限制。Wine 跑程序时如果切到后台iOS 可能直接杀掉进程。所以跑长任务时别切后台或者开启 Madeira 的后台运行权限。但后台运行权限会加快耗电自己权衡。第五个坑是蓝牙鼠标的兼容性。不是所有蓝牙鼠标都能在 iOS 上正常工作有些鼠标的连接不稳定有些按键映射不对。买之前查一下兼容性列表或者用有线鼠标转接。最后分享一个小技巧Madeira 的日志功能很详细遇到问题先看日志。日志里通常有明确的错误信息比瞎猜高效得多。日志文件在 Madeira 的文档目录里用文件应用就能查看。