Guide: Running Switch games natively on Mac with nxnative
AppleGamingWiki · 英文来源
查看原文/视频 →用自己的游戏文件和密钥,构建可在 Apple 芯片 Mac、iPhone 或 iPad 上运行的游戏应用。nxnative 让游戏代码直接运行在苹果芯片上,并通过 Metal 绘制画面。
两种方式都从 Mac 开始构建:在电脑上打开 Mac 应用,或将 IPA 侧载到 iPhone 和 iPad。
构建时添加 --platform mac-app,生成游戏应用后,从 Finder 打开即可游玩。
在 Mac 上生成 IPA 后侧载安装。上游要求 iOS / iPadOS 26+,以及 A17 Pro / M1 或更新芯片。
准备游戏本体、可选更新与 DLC,以及 prod.keys。项目不提供游戏文件或密钥。
游戏列表收录已通过 Mac 或 iPhone 实机游玩测试的作品。详情页提供测试版本、移植说明和已知限制。
基于 d2r-mobile、Ryujinx 的着色器转换器、Atmosphère、yuzu、LibHac、SPIRV-Cross 等项目。详见致谢。
以下游戏已通过 Mac 或 iPhone 游玩测试,但不代表每款都已在所有设备上验证。点击游戏查看具体版本和已知问题。































































































































用自己的游戏文件构建未签名的 iPhone / iPad IPA,或可在 Mac 运行的应用。首次构建约需 30–60 分钟,之后会复用已完成的步骤。
上游当前要求。构建需 macOS 26.6+、Xcode 27.1、Homebrew 和 ARM64 Python 3.12+;构建 iPhone 版还需安装 Xcode 的 iOS 平台。iPhone / iPad 游玩需 iOS / iPadOS 26+、A17 Pro / M1 或更新芯片。预留约游戏大小两倍再加 10 GB 的磁盘空间。
不想用终端?社区项目 NX2Apple 把这些步骤做成了一个 macOS 应用。
在 Mac 上只需做一次。
xcodebuild -downloadComponent MetalToolchain
git clone https://github.com/seedds/nxnative.git && cd nxnative
brew install xcodegen zstd glslang
brew install --cask dotnet-sdk
python3 -m pip install lz4 "capstone>=5,<6" fonttools nsz zbic "backports.zstd; python_version < '3.14'"将游戏本体、可选更新和 DLC 放在同一文件夹,支持 NSP、XCI、NSZ 和 XCZ。
~/Games/MarioWonder/
Super Mario Bros. Wonder [010015100B514000][v0].nsp
Super Mario Bros. Wonder [010015100B514800][v327680].nspIPA 或 Mac 应用会出现在游戏文件夹中;添加 --platform mac-app 可在 Apple 芯片 Mac 上游玩。
python3 scripts/build_ipa_from_nsp.py ~/Games/MarioWonder -k ~/keys/prod.keys
# Mac app instead of an iPhone IPA:
python3 scripts/build_ipa_from_nsp.py ~/Games/MarioWonder -k ~/keys/prod.keys --platform mac-appMac:从 Finder 打开生成的应用。iPhone / iPad:用 AltStore、Sideloadly 或 LiveContainer 侧载 IPA;较大游戏需要在工具支持时启用 Increased Memory Limit。
点击顶部的 2D / 3D 切换触控布局。连接手柄后触控按键会隐藏。3D 模式下,在屏幕右侧三分之一处滑动来控制视角。摇晃手机即可摇动手柄。
若 IPA 太大无法安装,用 --romfs separate 重新构建,然后执行脚本打印的文件复制命令。操作、存档和设置见游玩说明。下方 iOS 16.1/17 社区分支的兼容性声明与上游不同。
根据 2026 年 10 月 30 日 Google 检索结果筛选,排名因地区与时间而异。旧教程与项目当前文档冲突时,以项目文档为准;视频标题不代表支持所有游戏。
AppleGamingWiki · 英文来源
查看原文/视频 →seedds / nxnative · 英文来源
查看原文/视频 →Andrew Tsai’s Tips · 11:59 · 英文来源
查看原文/视频 →blackheart909 · 8:41 · 英文来源
查看原文/视频 →默认英文。打包时用 -l 指定(例如 -l zh-Hans),或在 Documents/env.txt 中加入 DM_LANG=zh-Hans。
在“文件”应用里,位于应用名称下:save/ 和 log.txt。出问题时请发送 log.txt。
场景第一次出现时的短暂卡顿是正常的:图形只编译一次,之后会被记住。
部分侧载工具会给重装的应用新的数据文件夹。请把旧文件夹里的 save/ 和 pso_user.tsv 复制过来。
在 Documents/env.txt 中加入:DM_OPMODE=0 为掌机模式,DM_FPS_TARGET=30 省电,DM_SHOW_FPS=1 显示帧率。
没有 amiibo,没有联网功能。其他游戏会得到一份分析报告和尽力而为的 IPA,不一定能启动。
需要图形化构建、游戏库管理,或旧版 iOS 兼容支持?了解这些由社区独立维护的项目,进入详情页查看功能、要求与源码链接。
面向 Mac、iPhone 和 iPad 的图形启动器与游戏库,可构建并管理游戏。v1.0 起,iPhone 与 iPad 共用统一的壳应用,包含游戏库、Cover Flow、手柄和键盘导航及逐游戏设置;引擎随发布打包并每日跟随上游。
查看详情 →将解包、游玩、打包和存档管理集中在同一个游戏库中,并新增 iPhone 与 iPad 配套的 NX Play 启动器。移动端可列出 Mac 游戏、通过局域网请求安装、启动已安装游戏、使用手柄,并提醒续签。
查看详情 →LumaNX 原名 LumaDock,把 nxnative、图形化游戏库、构建队列和格式转换工具整合在一起。0.3.0 新增仅限 Mac 的实验性解密 Switch 2 游戏目录导入,并复用未变化准备阶段,同时保留 Mac 启动和未签名 IPA 导出。
查看详情 →面向旧版 iOS 设备的兼容性开发分支,包含传统 Metal 渲染路径、按设备划分的着色器约束和逐构建游戏适配。维护分支现已更名为 ios16-ios17-compat;它是实验性的源码构建路线,并非通用的即装即玩包。
查看详情 →nx2android 将 nxnative 的直接执行思路带到 Android:游戏自身的 ARM64 代码在设备上运行,项目把 Switch 的 NVN 图形调用转换到 Vulkan,并由构建器生成 APK 和游戏数据。
查看详情 →MacNativeGames 是以《塞尔达传说:旷野之息》和《王国之泪》为主要目标的独立原生运行项目,覆盖 Mac 与 Apple 移动设备,并提供早期 Apple Vision Pro 支持。它不是单纯的 nxnative 图形界面。
查看详情 →xbunax/nxnative 是带本地 WebUI 构建工作室的 nxnative 分支,在保留上游引擎的同时增加浏览器导入、任务管理,并记录 Windows 启动和 IPA 构建路径。
查看详情 →CA-NINAPPLE 是源自 NXNativeWindows 的 Windows 向 nxnative 分支,提供桌面 GUI 和 PowerShell 流程,可在没有 Mac 的情况下把游戏转储与密钥构建成 iOS IPA。
查看详情 →NX OS 是基于 nxnative 的主机风格 macOS 前端,可发现已构建游戏、全屏启动并统计游玩时间,也能发起新的 Mac 或 iPhone 构建。
查看详情 →nxnative-gui 是轻量级 macOS 图形前端,本身不是另一套运行时。它自动克隆或更新 nxnative、检查工具链,并把原本在终端中完成的选择汇总到同一个构建表单。
查看详情 →ns2ios-shell 把可复用的、与具体游戏解耦的 iOS 壳与本地逐游戏打包分开。CI 负责构建壳,打包器则可在 Windows、Linux 或 macOS 上把用户游戏文件与壳组合,不需要 Xcode。
查看详情 →