NX Play：Mac 上原生运行 Switch 游戏

项目简介

NX Play 是一款 Mac 应用（附带 nxplay 命令行脚本），通过 nxnative 让 Switch 游戏在 Mac 或 iPhone/iPad 上原生运行。它把游戏构建一次，之后每次启动就能直接进入游戏。本仓库就是 nx-native-wrapper。

每个游戏各占一个独立文件夹，原始文件、构建产物、存档和 IPA 并排放置；移动文件夹或者整个游戏库，都不影响继续使用。一个应用就能管理所有游戏，无需为每个游戏单独打包一个 App。

主要功能

• 游戏库：显示游戏图标，支持提取、在 Mac 上运行和重新构建；工具栏可在网格视图与可排序列表之间切换（⌘1 / ⌘2）。
• Console Mode：全屏运行，由游戏手柄操作，适合在沙发上用。
• 安装到 iPhone/iPad：通过 Xcode 签名安装，或者构建未签名的 IPA，供 AltStore、Sideloadly 等工具侧载。
• 存档：先在 Mac 与设备之间比较存档的新旧，再把其中一份拷到另一边；被覆盖的存档保留在 <title ID>_build/run/save-backups；还可以把存档备份到自己的私有 Git 仓库。
• 云存档：借助 iCloud Drive 或自选文件夹，让 Mac 与 iPhone 共用同一份存档（使用 nxnative 自带的同步）。
• 跟进 nxnative 更新：更新前会询问选择「立即更新」还是「继续当前构建」；也支持用 Tools › Update All Builds… 批量重建。
• 其他：Keep This Build 锁定当前可用的构建；Make Mac App 生成可双击的独立 App；Tools › Free Up Space 列出可清理的内容和大小。

安装与使用

要求：Apple 芯片 Mac、macOS 15 或更高版本；Xcode（需打开过一次）、Homebrew。Intel Mac 可以构建 IPA 和安装到设备，但无法在 Mac 上运行游戏。

1. 从 latest release 下载 DMG，把 NX Play 拖进「应用程序」。
2. 如果还没有 Homebrew，先安装它。
3. 打开 NX Play：Setup 会自动弹出，检查 Mac 与 Xcode；点 Install Missing 会安装 Metal Toolchain、uv、xcodegen、zstd、glslang、.NET SDK，用 uv 安装 Python 与 nxnative，最后克隆 nxnative。

从源码安装：

git clone https://github.com/varyform/nx-native-wrapper.git
cd nx-native-wrapper
bin/setup

游戏库按「一个游戏一个子文件夹」组织：

Switch/
├── Metroid Dread/
│   └── Metroid Dread [010093801237C000][v0].nsp
└── Super Mario Bros Wonder/
    └── ….nsz

把自己的 prod.keys 放到 ~/.switch/prod.keys，或者在设置里选择该文件。

注意事项

• 需要自备游戏文件（NSP、NSZ、XCI、XCZ）和自己的 prod.keys；本项目不下载游戏或密钥。
• 构建游戏从几分钟到一小时不等，时间主要花在翻译 shader 上；Xcode 更新后，每个游戏都会重新编译一次。
• 卸载（NX Play › Uninstall NX Play…）会移除应用、设置和缓存，但保留游戏文件夹、prod.keys、存档备份仓库和 Homebrew。
• NX Play 不会在游戏运行或构建进行时用弹窗打断你；如果它从 DMG 或「下载」目录运行，会提示把应用移到「应用程序」。

本作品整理自 GitHub 开源项目 varyform/nx-native-wrapper，原作者 @varyform，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。