企业官网建设流程全解析

如何读懂Madeira的3个自检程序：hello_x86、fib与proc-test测试工具详解

【免费下载链接】MadeiraRun x86-64 Windows PC games on jailed iOS via FEX-Emu + Wine + DXMT项目地址: https://gitcode.com/GitHub_Trending/mad/Madeira

Madeira 是一个让你在 iOS 上运行 x86-64 Windows 游戏的开源项目，它通过 FEX 模拟器 + Wine + DXMT 这条技术链把 PC 游戏“搬”上 iPhone。但翻译引擎、进程模型这些底层组件是否正常，普通用户很难直观判断。为此，项目内置了 3 个轻量级自检程序：hello_x86（引擎心跳）、fib 系列（64 位运算校验）和proc-test（进程冒烟测试）。本文带你逐个读懂它们的测试点、预期输出和退出码含义，几分钟掌握 Madeira 的自检机制 🔍

为什么需要自检程序？

Madeira 的运行时是一个层层叠加的“翻译栈”：

任何一层出错，游戏就会闪退或黑屏，却很难定位到具体原因。3 个自检程序各自只压测一层，输出可验证、退出码可判断，相当于给整个链条装上了“分段报警器” 🚨。

自检一：hello_x86 —— FEX 引擎的“心跳检测”

hello_x86 是最小的一条 x86-64 可执行程序，只有952 字节，以静态字节数组的形式直接嵌在 App 里：

• 源码数据：hello_x86.h
• 加载器实现：FEXBridge.mm

它的加载流程就是 FEX 自检的完整缩影：

1. 校验 ELF 文件头（确认是 64 位 x86-64 二进制）；
2. 解析 PT_LOAD 段，计算地址范围；
3. mmap申请内存并映射各段；
4. 通过 FEX 翻译执行入口指令。

怎么读结果：只要它成功打印 hello 信息并正常退出，就说明 FEX 的 ELF 加载器 + 指令翻译器这条最短路径是通的——这是整个项目能否跑起来的“地基” 🧱。任何一步失败都会在日志里看到FAIL: Invalid ELF binary之类的明确提示。

自检二：fib 系列 —— 64 位算术的“压力测试”

fib 系列位于 build/x64-tests/，编译成 x86_64 格式 PE，随 ARM64EC 系统库一起放在 arm64ec-windows/ 中运行。三个程序逐级加压：

fib-x64：调用栈冒烟测试

• 源码：fib-x64.c
• 递归计算 fib(30)，产生大量深层 CALL/RET 调用，压测 FEX 的调用栈处理
• 刻意不用 printf，只用裸WriteFile输出，缩小测试面

预期输出：

fib(30) = 832040

退出码为832040 % 256 = 232（0xE8），可在日志中二次核对。

fib2：64 位大数运算校验

• 源码：fib2-x64.c
• 计算 fib(85) ≈ 2.6×10¹⁷（超过 2³²），专门验证 64 位加减、除法取模
• 内置已知值对照表，自我比对并打印verdict: N/9 passed

预期输出：每行iter fib(N) = 已知值全部匹配，最后一行verdict: 9/9 passed，退出码 0。

fib3：命令行参数链路测试

• 源码：fib3-x64.c
• 从argv[1]读入 N（默认 30），验证“Wine 命令行 → argc/argv → main”的完整传参链路
• 退出码等于N % 256，能确认参数被正确解析

三个 fib 工具正好覆盖了翻译器最容易翻车的三块：调用栈、64 位寄存器运算、参数传递 ✅

自检三：proc-test —— 进程模型的“冒烟测试”

proc-test 位于 build/proc-tests/，由两部分组成：

• 父进程：proc_parent.c
• 子进程：proc_child.c

它的测试设计相当精巧，一次性验证了 Steam 启动游戏所依赖的全部进程能力：

怎么读结果：全部通过时，父进程输出[proc-test] === RESULT: PASS ===，最终退出码 42。若某一层失败，退出码是精心设计的“故障代码”：51 = 环境变量没继承、52 = 孙进程创建失败、53 = 孙进程退出码不对、7/8 = 内存读写异常——一眼定位卡在哪一环 🎯

三条自检路线，层层递进

把 3 个工具串起来，就是一条由浅入深的诊断路线：

1. hello_x86 失败→ FEX 翻译器或 ELF 加载器有问题，一切免谈；
2. hello_x86 通过但 fib 失败→ Wine 用户态运行 x86_64 PE 时出错，看具体是调用栈还是 64 位运算；
3. fib 通过但 proc-test 失败→ 多进程/伪进程模型或环境继承有问题；
4. 三者全过→ 底层链路健康，问题多半在图形（DXMT）或游戏本身。

配套的构建脚本见 build/x64-tests/ 与 build/proc-tests/，编译产物会同步到 aarch64-windows/ 和 arm64ec-windows/ 两套系统目录中，分别对应 ARM64 原生与 ARM64EC 混合两种运行路径。

读懂这三个小工具，你就拿到了排查 Madeira 问题的“地图”：不再对着黑屏干着急，而是用退出码和日志行，把故障精确锁定到具体那一层 ⚡

【免费下载链接】MadeiraRun x86-64 Windows PC games on jailed iOS via FEX-Emu + Wine + DXMT项目地址: https://gitcode.com/GitHub_Trending/mad/Madeira