README

你的 Switch 游戏，跑在你的 iPhone 上。

不是模拟器。不用命令行。一个 macOS 或 Windows App 点几下就把整个构建做完。
















 🆕 最近重点更新

- Windows 版启动器上线（NX2Apple-windows-x64.zip）：在 Windows 上使用与 Mac 版一致的 1.2 界面构建 iPhone 和 iPad IPA，自带完整引擎目录（无需安装 git），支持首次启动引导向导与工具链一键安装、多核并行 NSO 重写及应用内自动更新（NX2Apple.exe）
- 支持 Switch 2 游戏：在 Mac 或 Windows 启动器中直接选择 Switch 2 游戏文件夹或 .nup 文件，无需 prod.keys，即可在 Mac、iPhone 或 iPad 上构建和游玩
- 虚拟手柄自定义、双 Joy-Con 横握拆分与 Steam Controller（2026）：在 iPhone 和 iPad 的可视化编辑器中自由调整触控按键大小、摇杆位置与整体布局（2D/3D 独立保存）。外接手柄支持全局或按游戏改键，Mac 端支持将一对蓝牙 Joy-Con 拆分为两个独立横握手柄，并支持新款 Steam Controller（2026）
- iPhone 和 iPad 共用一个 App：所有游戏装进同一个壳 App（也支持导出未签名 IPA），每个游戏自带独立宿主框架（后续引擎更新无需重编旧游戏），支持横屏 Cover Flow、按游戏独立设置与 Mod、保留存档删除游戏，以及 6 种系统语言
- 主机模式：插上手柄按 Select 或设置开机直达，游戏库即刻变为全屏手柄界面，长按 Home 键 2 秒即可退出游戏

所有版本见更新日志。



---

 这是什么

NX2Apple 用你自己导出的游戏文件，在你的 Mac 和 iPhone 上运行 Nintendo Switch 游戏。它不是模拟器：
游戏自己的代码直接在 Apple 芯片上运行，由 Metal 负责绘制。一个 Mac App（启动器）点几下就完成构建
（解包、改写、翻译 shader、打包），然后把你的游戏放进游戏库，像 Switch 一样点 Play 启动。



它是 nxnative 的社区 fork。真正的工作（代码改写器、Horizon
宿主层、NVN-on-Metal 和每个游戏的 profile）都是 nxnative 的；本 fork 在其上增加启动器和少量补丁，
并每天跟随 nxnative 更新。

 环境要求

- Apple Silicon Mac。 启动器支持 macOS 13 或更新。构建需要装了 iOS SDK 的 Xcode；NVN 游戏需要
  Xcode 27.2（macOS 26.6 或更新），除非加 --allow-other-metal。
  请从 Apple 的下载页面获取 27.2，而不是 App Store 里更新的 Xcode。如果同时装了更新的 Xcode，把 27.2 改名为
  Xcode-27.2.app 并选中它：sudo xcode-select -s /Applications/Xcode-27.2.app。
- 你自己的游戏文件（NSP 或 XCI）和你自己主机里导出的 prod.keys。本项目不自带、不下载、
  也不替你查找任何东西。一份 prod.keys 能解你所有的 Switch 游戏。新导出的一份覆盖所有零售游戏。
  Switch 2 游戏（游戏文件夹或 .nup 文件）不需要 prod.keys。
- 要装到 iPhone 或 iPad：iOS 或 iPadOS 26 或更新，以及较新的设备。更旧的设备未测试。

App 自带构建工具和 Python，不需要装 Homebrew 和 Python；.NET SDK 10 仍由 App 帮你安装。启动器的依赖页会逐项检查，能装的一键安装。

 安装

1. 下载 App：从最新版本下载
   NX2Apple-macOS-arm64.zip，解压。
2. 首次启动：右键 → 打开。 这个 App 没有付费的 Apple 开发者证书签名，所以 macOS 在第一次启动时会
   询问；之后就能正常打开。
3. 按设置页走。 启动器会取回构建用的项目（设置页上的「下载仓库」按钮，浅克隆到 ~/NX2Apple；
   GitHub 不顺手时页面会给出手动 ZIP 的路线），检查上面的工具，之后还会自己更新。全程不需要懂 git。
4. 构建游戏。 选好游戏文件夹（或者分别选本体、更新包、DLC 和 prod.keys），选择「这台 Mac」或
   「iPhone / iPad」，按构建。页面显示真实的阶段和剩余时间，中途停止的构建会从上次继续。「iPhone / iPad」
   是装在设备上、容纳你所有游戏的一个共用 App。启动器用 Xcode 为它签名、安装并拷入游戏，需要一台与这台 Mac 配对的设备。

在终端里手动构建见 BUILDING.zh-CN.md。

更新已构建的 Mac 游戏。 在游戏库中选中游戏，点「重新构建」。如果更新包是 NSP，保留已选的游戏本体，
在「更新和附加内容」中选择新的更新包，然后在原输出文件夹中为「这台 Mac」构建。更新可能同时改动游戏代码和数据，
因此启动器会构建新版本，并尽量复用缓存。存档按游戏的标题 ID 保存在 .app 外的独立文件夹中，
在同一游戏库中重新构建会保留原有进度。

 iPhone 和 iPad 上的 App

「iPhone / iPad」目标会构建一个共用的外壳 App，和 Mac 启动器一样容纳你所有的游戏。游戏库用封面展示每个游戏。
竖屏时是单列，选中的游戏在顶部。横过来是 Cover Flow。iPad 显示网格。





- 从 Mac 添加游戏。 用「iPhone / iPad」目标构建游戏，启动器会把它拷进 App。重新签名和重装 App 都会保留游戏数据和存档。
- 游玩。 选一个游戏，点 Play。缺少游戏数据或需要更新 App 的游戏，会在它的卡片上说明并给出解决办法。
- 每个游戏的设置。 设置按钮（手柄上按 X）打开该游戏的启动选项。重置会把所有选择恢复为默认。
- 手柄或键盘。 整个 App 都能用手柄操作：方向键和摇杆移动，A 选择，B 返回，X 打开设置，Y 列出手柄。外接键盘的用法相同。
- 游戏数据文件夹。 每个游戏可以从你在「文件」App 里选的文件夹（例如外置硬盘）读取数据，也可以用 App 自己的文件夹。
- 云存档。 为游戏选一个 iCloud Drive 文件夹，存档就和 Mac 保持同步。
- 语言。 App 跟随系统语言，英文或简体中文。

App 需要 iOS 或 iPadOS 26 或更新。封面是 Mac 启动器为你自己的游戏缓存的 eShop 横幅。

 游玩

在 Mac 上，构建好的游戏带着封面出现在游戏库里，点 Play 启动。启动选项（按游戏保存，重新
构建后仍然保留）可设置帧率、主机模式

Top issues

Discussions

Latest release

v1.3.0: Windows builder improvements, native iPhone and iPad navigation, and Japanese / Windows 构建器优化、iPhone 和 iPad 原生导航与日语支持

 English

Highlights

iPhone and iPad app
- The app has native navigation (787).
- The library layout adapts to iPhone, iPad and iPhone Duo (787).
- A touch controls editor is included (695, 622, 787).
- The Duo outer landscape accepts custom control bounds (809, 787).

New
- Experimental builder is off by default: The setting is in Settings, Build tools, "Use experimental builder". It stays off until you turn it on, and the launcher builds with the NSP script as befor