nxnative：把自己的 Switch 游戏变成 iPhone、iPad 可侧载的 IPA

阿喵前言

把自己的 Switch 游戏放到 iPhone、iPad 上玩，这次有个挺特别的开源项目：nxnative。它把你准备的游戏文件打包成能侧载的 IPA，让游戏代码直接在苹果芯片上运行。不过先别急着下载：设备门槛不低，还得有一台 Mac 来构建，适合愿意动手折腾的朋友。

资源介绍

nxnative 是一个将 Nintendo Switch 游戏转换为苹果平台应用的开源项目。你需要准备自己的游戏文件和 prod.keys，再由脚本完成提取、代码改写、图形转换与打包，生成供 iPhone、iPad 侧载的 IPA。它走的是原生代码执行路线，图形接口转换到 Metal，而非传统的整机模拟方案。

项目采用 MIT 许可证，依赖的第三方组件保留各自许可。仓库不附带商业游戏、游戏密钥或通用的现成游戏 IPA；当前也没有 GitHub Releases 安装包。它更接近一套需要自己构建的工具链，兼容性要逐个游戏看，不能理解为所有 Switch 游戏都能转换成功。

截图

游戏配图：《马力欧卡丁车8 豪华版》《超级马力欧兄弟 惊奇》《塞尔达传说 旷野之息》《哈迪斯》。

特色

• 每个游戏单独生成应用。把同一游戏的基础文件、更新和 DLC 放到同一目录，构建脚本选择目录中的较新版本并打包，应用可以带上对应游戏的名称、图标与版本。
• 苹果芯片原生执行与 Metal 图形层。项目通过代码改写和系统服务替代，让游戏在苹果平台运行，同时转换图形调用。这个方向很有意思，但并不消除逐游戏适配和图形问题。
• 触控与手柄都能用。提供 2D、3D 触控布局，连接手柄后可隐藏屏幕触控按钮。部分游戏还能使用手机的动作输入与震动反馈，具体效果以对应游戏说明为准。
• 启动前集中调参数。游戏支持的帧率、渲染比例、掌机/底座模式、语言、震动等选项可以在启动界面调整，支持范围会随游戏不同而变化。
• 同一工具链也能面向 Mac。构建脚本提供 mac-app 模式，可为 Apple Silicon Mac 生成应用；如果你更喜欢图形界面，社区另有 NX2Apple 分支，和 nxnative 本体是两个项目。

注意

• 先看硬件要求。移动端需要 iOS/iPadOS 26 或更新系统；iPhone 为 iPhone 15 Pro 起、A17 Pro 或更新芯片，iPad 为 M1 或更新芯片。不要只按“iPhone 15”这个名称判断，普通版与 Pro 的芯片并不相同。
• 构建端需要 Mac、Xcode 和多项依赖。源码不是下载后直接在手机里打开的应用，仍需构建、签名与侧载。
• 游戏名单不等于全部完美运行。仓库中的测试可能在 Mac 或 iPhone 上完成，需打开每款游戏的说明看测试平台和已知问题。未适配游戏即使打出了 IPA，也可能无法启动。
• 内存和存储都要留余量。较大的游戏可能需要签名工具支持 Increased Memory Limit 权限；没有该权限时可能因内存限制被系统结束。构建需要的磁盘空间约为游戏文件大小的两倍再加 10 GB，实际占用随游戏变化。
• 目前不支持 amiibo 和在线功能。首次遇到新场景可能因图形编译出现短暂停顿，不能据此承诺全程流畅。
• 请自行准备有权使用的游戏备份和密钥；项目与任天堂及游戏发行商没有隶属关系。封面借用 Switch 标识说明平台，不代表官方授权或官方客户端。

使用教程

1. 先查游戏和设备。核对系统、芯片与存储空间，并在仓库的 per-game notes 中查看目标游戏的测试平台和限制。
2. 在 Mac 上准备构建环境。安装 Xcode，按 README 准备 Homebrew、XcodeGen、zstd、SPIRV-Cross、glslang、.NET SDK，以及 Python 的 lz4、capstone、fonttools 等依赖。不同 Python 版本还有条件依赖，请以项目当前命令为准。
3. 准备一个游戏的文件夹。放入自己有权使用的基础 NSP，更新和 DLC 按需加入；prod.keys 单独保存在自己的电脑上。项目也说明支持 XCI，以及经额外处理的 NSZ/XCZ 格式。
4. 执行构建。在 nxnative 项目目录运行下方命令，把示例路径换成自己的游戏目录和密钥文件位置。首次构建需要时间，完成后到游戏目录寻找生成的 IPA。

python3 scripts/build_ipa_from_nsp.py ~/Games/MyGame -k ~/keys/prod.keys

5. 签名并侧载。用合适的签名/侧载工具安装生成的 IPA；较大游戏需留意内存权限。启动后先检查画面、声音和操作，不要直接照搬其他游戏的性能设置。
6. 备份存档再重装。游戏的存档和日志可在“文件”App 中找到。部分侧载工具重装后会更换数据目录，升级前应先备份 save 等数据。

资源获取

GitHub 项目：nxnative 源码与完整 README

游戏兼容说明：逐游戏测试记录与已知问题；图形界面分支：NX2Apple。

下方获取的是项目源码，不是预编译游戏 IPA；游戏文件和 prod.keys 不在仓库内。