登录 注册

nxnative （Switch游戏转苹果原生应用）

曾爆款
去点 Star
游戏与娱乐
14,469
Stars
0
Forks
0
Watchers
0
Open Issues
未知
许可证
Python
语言
创建时间
最近更新

项目能做什么

该项目能将 Switch 游戏打包为 Mac 应用或 IPA，无需模拟器，让游戏直接原生运行在 Apple 设备上。
来源：AI 基于仓库事实生成 · 内容以仓库实际 README 为准

使用说明 查看原始 README 原仓库文档

项目简介

nxnative 是一个支持在 Apple silicon 架构的 Mac、iPhone 和 iPad 设备上原生运行 Nintendo Switch 以及 Switch 2 游戏的开源工具。

该项目不是模拟器，而是通过重写 NSO，让游戏自身的代码直接运行在 Apple 芯片上，并将 Switch 原生的 NVN 图形指令通过 Metal 重建渲染。只需运行一个脚本，即可将你的游戏文件打包为 Mac 原生 App 或用于侧载（Sideloading）的未签名 IPA 文件。本项目不包含任何游戏专有资源，也与 Nintendo 或任何游戏发行商无关。

核心功能

  • 原生执行：直接在 Apple 芯片运行游戏二进制代码，基于 Metal API 重新构建图形管线。
  • 一键打包：通过 Python 脚本直接将游戏本体、更新补丁（Update）和 DLC 打包为未签名 IPA 或 Mac 原生 App。
  • 多平台支持：支持 Apple silicon Mac、搭载 A17 Pro 及以上芯片的 iPhone，以及 M1 及以上芯片的 iPad。
  • Switch 2 支持：支持从 .nup 文件或 dump 目录构建经过 Mac 运行验证的 Switch 2 游戏。
  • 丰富的社区前端：生态中已有 NX2Apple、NX Play、NxNative Launcher、LumaNX、GameCase 等免命令行 GUI 工具及管理库。

适合谁用

  • 拥有 Apple silicon Mac（用于编译构建）的中国个人开发者或高阶玩家。
  • 拥有自购正版 Switch/Switch 2 游戏备份文件（.nsp / .xci / .nsz / .xcz / .nup）及 prod.keys 的用户。
  • 想要在配备高性能 Apple 芯片的 Mac、iPhone（A17 Pro+）或 iPad（M1+）上原生畅玩 Switch 游戏的用户。

安装步骤

硬件与环境要求

  • Mac：Apple silicon，macOS 26.6 或更高版本；构建游戏需要 Xcode 27.2；Homebrew；arm64 架构的 Python 3.12+。若要打包 iPhone 版本，还需要安装 Xcode 的 iOS 平台组件（Xcode → Settings → Components）。
  • iPhone：A17 Pro 芯片或更新机型，iOS 26 或更高版本（旧款 iPhone 不支持游戏的 BC 纹理压缩格式）。
  • iPad：M1 芯片或更新机型，iPadOS 26 或更高版本。

1. 安装构建依赖

在 Terminal 中确保选中 Xcode 27.2 的编译器并执行以下命令：

# 切换 Xcode 路径（若有多个版本，请调整路径指向 Xcode 27.2）
sudo xcode-select -s /Applications/Xcode.app

# 下载 Metal 工具链
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'"

2. 准备游戏文件

把游戏本体、Update 与 DLC（格式支持 .nsp、.xci、.nsz、.xcz）放入同一目录，例如：

~/Games/MarioWonder/
  Super Mario Bros. Wonder [010015100B514000][v0].nsp
  Super Mario Bros. Wonder [010015100B514800][v327680].nsp

3. 构建 IPA 或 Mac App

指定你的游戏目录与 prod.keys 密钥路径：

# 构建 iOS/iPadOS 的未签名 IPA 文件
python3 scripts/build_ipa_from_nsp.py ~/Games/MarioWonder -k ~/keys/prod.keys

提示：首次构建需要 30–60 分钟，并需要约游戏体积 2 倍加 10 GB 的空闲磁盘空间；后续重新构建会快很多。打包完成的 IPA 会输出在游戏文件夹下。

4. 安装到移动设备

使用 AltStore、Sideloadly 或 LiveContainer 等侧载工具将 IPA 安装到 iPhone/iPad。 - 注意：如果侧载工具包含 Increased Memory Limit（增加内存限制）选项，务必勾选开启，大型游戏必需此项。

配置说明

在运行 build_ipa_from_nsp.py 脚本时支持以下常用参数配置：

  • -k <path>：指定 Switch 的 prod.keys 文件路径。
  • --platform mac-app：构建适用于 Mac 的原生 App（可直接在 Finder 中双击运行），而非 IPA。
  • --romfs separate：将游戏数据文件（RomFS）分离打包。构建后根据终端提示命令一次性将游戏资源同步至手机，便于排查与快速重新安装。
  • --shader-files：使用 AltServer 安装时，若单文件大于或等于 2 GiB 将无法正常安装，添加此参数拆分 Shader 资源以满足安装限制。
  • Switch 2 游戏构建配置：此部分原文未说明完整，请查看原仓库。

常见问题

Q: 游戏遇到未配置/无 Profile 怎么办？
A: 对于脚本尚未适配 Profile 的游戏，打包脚本会自动生成一份调查信息并尝试使用预估参数临时构建；但该构建可能无法正常启动。

Q: 安装包太大导致 AltServer 侧载失败？
A: 增加 --shader-files 参数，并配合 --romfs separate 重新打包。

Q: 手柄按键映射、存档同步及其他控制器设置？
A: 此部分原文未说明具体参数，请查看原仓库 docs/playing.md。

原始 README 摘录（英文原文，节选前 3000 字符） 
# nxnative

Play your own Nintendo Switch and Switch 2 games natively on Apple silicon Macs, iPhone and iPad. One script packs your game into a Mac app or an unsigned IPA that you sideload.

It is not an emulator: the game's own code runs directly on the Apple chip, with Switch graphics rebuilt on Metal. Nothing from any game is in this repository, and the project is not affiliated with Nintendo or any game publisher.

[Games](#games) · [Community front ends](#community-front-ends) · [Requirements](#requirements) · [How to play](#how-to-play) · [Discussions](#discussions) · [For developers](#for-developers)

## Games

The full [tested games table](dm/games/README.md#games) includes original Switch games, tested builds, engines and graphics APIs. Each game's note records its tested platforms, progress and known issues.

These Switch 2 games have passed Mac gameplay testing. Build them from a [`.nup` file or a dump folder](#switch-2-games):

- [Donkey Kong Bananza](dm/games/040074A01BF12000/README.md)
- [Fire Emblem Fortune's Weave](dm/games/04007EF01F8AE000/README.md) — up to 120 fps
- [Hyrule Warriors: Age of Imprisonment](dm/games/04003F40232DE000/README.md)
- [Kirby Air Riders](dm/games/040077201BE50000/README.md)
- [Mario Kart World](dm/games/0400C3F00006E000/README.md)
- [Mario Tennis Fever](dm/games/0400D4201C6EA000/README.md)
- [Pokémon Pokopia](dm/games/0400A3A01EE4C000/README.md)
- [Splatoon Raiders](dm/games/0400380020056000/README.md)
- [Star Fox](dm/games/0400E88025B1A000/README.md)
- [The Legend of Zelda: Ocarina of Time](dm/games/0400486024DEC000/README.md)
- [Yoshi and the Mysterious Book](dm/games/0400245021D2C000/README.md)

## Community front ends

Community projects build on nxnative with tools to turn your games into apps for your iPhone, iPad or Mac without the command line, and libraries to organize and launch them. They are separate projects: questions and bugs about them go to their own pages.

- [NX2Apple](https://github.com/LNPANDY/NX2Apple) — Mac builder with a shared iPhone/iPad game library.
- [NX Play](https://github.com/varyform/nx-native-wrapper) — Mac library with device installs and save sync.
- [NxNative Launcher](https://github.com/rennan101/nxnative_Launcher) — Mac launcher with guided builds and controller mapping.
- [LumaNX](https://github.com/Xc1Ym/LumaNX) — Mac game builder with IPA export.
- [GameCase](https://github.com/Tiaoge-tou/GameCase) — iOS game library based on LiveContainer.

## Requirements

- **Mac:** Apple silicon, macOS 26.6 or later. Building games requires Xcode 27.2.
- **iPhone:** A17 Pro chip or later, with iOS 26 or later.
- **iPad:** M1 chip or later, with iPadOS 26 or later.

The games' textures are BC-compressed, which older iPhones cannot read. Switch 2 builds are tested on the Mac; check each game's note for device-specific validation.

For a game without a profile, the script writes a survey and tries a provisional build with guessed settings. That build may not start; see [Port ano
阅读完整原文

商业机会分析 AI 生成

图形化侧载打包与签名管理工具

产品构想针对不熟悉命令行和 Xcode 的用户，开发 macOS 本地 GUI 客户端，自动化整合环境依赖安装、NSO 重写、IPA 打包与签名侧载流程。
核心功能一键拖拽 NSP/.nup 打包、自动化 Xcode 依赖检测与签名、无线侧载推送到 iPhone/iPad、手柄键位可视化映射。
目标用户持有 Mac 与 iOS 设备但缺乏开发技能的普通游戏玩家。
难度/周期中等偏高 · 2 - 3 个月 · 成本：开发设备采购（Apple Silicon Mac + A17 Pro 以上 iPhone）、Apple Developer 开发者账号年费（$99/年）。
收费模式独立软件买断授权制（License Key）或提供高级侧载/证书托管订阅。
竞争风险极高的任天堂法律诉讼与 DMCA 下架风险；苹果对 iOS 侧载限制政策变动的风险；项目本身的真实性存疑（README 标注的版本号异常）。
依据 AI推测

多端游戏进度与着色器云同步服务

产品构想为 nxnative 衍生的游戏应用提供专属的轻量级云服务，解决 Mac 与 iPhone/iPad 之间存档不同步及着色器首次编译卡顿问题。
核心功能游戏本地存档无缝云同步、多设备冲突处理、社区共享优化配置文件与着色器缓存拉取。
目标用户在 Mac 桌面端和 iPhone/iPad 移动端频繁切换游玩的多设备玩家。
难度/周期中等 · 1 - 2 个月 · 成本：云端 API 服务器成本、对象存储与带宽成本。
收费模式按月/按年收取增值会员订阅费（SaaS）。
竞争风险用户规模小导致单位带宽成本难以摊薄；游戏自身存储路径不统一带来的同步失效风险；法律合规边缘风险。
依据 尚需验证的假设

游戏兼容性配置与补丁众包平台

产品构想构建针对非官方原生化移植的 Game Profile 数据库，提供单游戏兼容性补丁、性能优化参数与社区悬赏系统。
核心功能游戏特定参数配置下载（Profile 导入）、画质补丁管理、特定游戏兼容性众筹悬赏板块。
目标用户追求特定 Switch 游戏在 Apple 设备上以高帧率/高分辨率稳定运行的重度硬核玩家与性能极客。
难度/周期高 · 3 - 5 个月 · 成本：大量的游戏逆向与测试工时、多机型测试矩阵设备成本。
收费模式社区众筹分润、创作者赞助抽成、专属优化配置文件会员制。
竞争风险触碰任天堂版权红线导致平台被封禁；社区配置分发易涉及加密资产盗版边界。
依据 尚需验证的假设
AI 基于仓库公开数据分析生成，含推测成分，不构成收益承诺。
报告会保存到 个人中心

竞品与相似项目 GitHub Search 真实检索

项目中文简介Stars语言
LNPANDY/NX2Apple macOS 图形化工具，支持免命令行将自备 Switch 游戏一键构建至 iPhone/iPad 运行。 5,766 Swift
xFractals/pokopia-native 将自备游戏 Dump 构建为 Win/Mac/iPhone 原生应用，支持联机和跨设备存档。 480 C
Xc1Ym/LumaNX nxnative 的 macOS 图形客户端，支持图形化构建 Switch 游戏并导出 IPA。 292 Python
Bium23/NxLibrary 基于 SwiftUI 的 macOS 游戏库与启动器，支持 nxnative 辅助构建与存档管理。 169 Swift
cheemu21/plumber-racer-2 借助 nxnative 在 iPhone 和 Mac 上运行指定赛车游戏，需自备游戏 Dump。 158 Python
varyform/nx-native-wrapper Mac 端工具，用于借助 nxnative 在 Mac 和 iPhone/iPad 上构建与管理 Switch 游戏。 158 Swift
以上为通过 GitHub 官方 Search API 检索的相似项目，功能差异与优劣势需进一步人工确认，配置 AI 后可生成对比分析。

项目优势与风险

技术成熟度创建于 ，最近推送
社区活跃Star 14,469 / Fork 0 / Issue 0（数据支持，可自行核实）
许可证未检测到（需人工确认）
主要风险上游项目方向可能变化；同赛道竞争者较多（见竞品表）；热度与需求不完全等价

安装与使用

快速开始（以仓库 README 为准）
git clone https://github.com/seedds/nxnative.git
cd nxnative
# 请阅读仓库 README 获取确切安装步骤（依赖、配置、启动命令）
阅读原仓库文档
术语说明：Docker＝应用容器（把程序和依赖打包运行）；API Key＝调用外部服务的密钥；Git Clone＝把仓库代码下载到本地。常见错误：API Key 未配置 / 端口占用 / 数据库连接失败，多数项目在 README 的 Troubleshooting 章节有说明。