由于 trendforge.devlive.top 访问受限，请切换到 trendforge.devlive.org 域名
Madeira 5分钟快速开始指南
在非越狱iPhone上运行x86-64 Windows PC游戏。
环境要求
支持的操作系统
所需工具
用于构建iOS应用
用于在iOS上附加调试器以启用JIT
用于代码签名，免费账号即可
操作步骤
克隆仓库并初始化子模块
获取项目源代码及其所有依赖的fork版本。
git clone --recursive https://github.com/willfaust/Madeira.gitcd Madeira预期结果：：看到子模块（如wine, FEX, dxmt）被成功克隆。
确保网络稳定，子模块下载可能需要一些时间。
构建项目
运行构建脚本来编译Wine、FEX-Emu、DXMT等核心组件。
./build/build.sh预期结果：：构建过程顺利完成，没有报错。
此步骤耗时较长，可能超过5分钟，但这是必要的。
使用Xcode构建并安装iOS应用
编译Madeira的iOS客户端应用。
xcodebuild -project Madeira.xcodeproj -scheme Madeira -configuration Release预期结果：：构建成功，生成.app文件。
确保你的Xcode命令行工具已安装。
在iPhone上运行游戏
通过StikDebug启用JIT并运行应用。
预期结果：：游戏在iPhone上启动并可以进入主菜单。
每次安装后7天，需要重新构建和安装。游戏存档会保留在应用容器中。
验证Madeira是否成功运行
确认游戏能够在你的iPhone上启动并显示画面。
快速提示
优先尝试README中提到的已测试游戏（如Thumper, ULTRAKILL）来验证功能。
免费Apple ID的配置文件每7天过期，需定期重新安装。
这是一个研究项目，游戏兼容性和帧率可能不稳定，属于正常现象。
常见问题
构建脚本报错，提示缺少子模块或代码。
确保使用了`--recursive`参数克隆仓库，并检查网络连接。可以尝试`git submodule update --init --recursive`。
在iPhone上安装应用失败。
检查Apple ID的签名是否正确配置。免费账号的描述文件可能需要在'设置->通用->VPN与设备管理'中手动信任。
游戏运行但立即崩溃或黑屏。
查阅项目的GitHub Issues页面，该游戏可能尚未被支持或需要特定的配置。
StikDebug无法附加调试器或启用JIT。
确保你的iPhone连接了电脑，并且StikDebug的开发者模式已正确设置。
下一步
测试更多游戏
参考项目Status部分，尝试其他列出的游戏，观察兼容性。
参与社区
在GitHub Issues中报告问题或分享你的测试结果，帮助项目发展。
阅读文档
深入阅读README和项目中的其他文档，了解技术细节和限制。
相关项目推荐
Genymobile/scrcpy
显示并控制您的安卓设备
microsoft/PowerToys
Windows系统实用工具集，助力生产力最大化
ventoy/Ventoy
一种新的可启动USB解决方案。
redis/redis
对于构建实时数据驱动应用的开发者而言，Redis是首选且最快、功能最丰富的缓存系统、数据结构服务器、文档与向量查询引擎。
obsproject/obs-studio
OBS Studio - 用于直播和屏幕录制的免费开源软件
colbymchenry/codegraph
为Claude Code预索引的代码知识图谱——更少的token、更少的工具调用、100%本地化