Guide: Running Switch games natively on Mac with nxnative
AppleGamingWiki · 英文來源
查看原文/影片 →用自己的遊戲檔案與金鑰,建立可在 Apple 晶片 Mac、iPhone 或 iPad 執行的應用程式。遊戲程式碼直接在 Apple 晶片上執行,並透過 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 遊玩測試,但不代表每款都已在所有裝置驗證。點選遊戲查看詳情。































































































































首次建置約需 30–60 分鐘,之後會重用已完成的步驟。輸出為 Mac 應用程式或未簽署的 IPA。
建置需求:macOS 26.6+、Xcode 27.1、Homebrew、ARM64 Python 3.12+。iPhone 版本還需要 Xcode 的 iOS 平台。請預留約遊戲大小兩倍再加 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].nsp輸出會出現在遊戲資料夾;Mac 版本請加入 --platform mac-app。
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 相容性由社群分支另外提供。 開玩.
根據 2026 年 10 月 30 日 Google 搜尋結果篩選,排名因地區與時間而異。舊教學與目前專案文件衝突時,以專案文件為準;影片標題不代表支援所有遊戲。
AppleGamingWiki · 英文來源
查看原文/影片 →seedds / nxnative · 英文來源
查看原文/影片 →Andrew Tsai’s Tips · 11:59 · 英文來源
查看原文/影片 →blackheart909 · 8:41 · 英文來源
查看原文/影片 →預設為英文。打包時用 -l 選擇其他語言(例如 -l ja),或在 Documents/env.txt 中加入 DM_LANG=zh-Hans。
在「檔案」App 中以 App 名稱命名的資料夾裡:save/ 和 log.txt。出問題時請提供 log.txt。
場景第一次出現時的短暫卡頓是正常的:圖形只會編譯一次,之後就會被記住。
有些側載工具會給一個新的資料夾。請把舊資料夾裡的 save/ 和 pso_user.tsv 複製過去。
Documents/env.txt 中的行:DM_OPMODE=0 為掌機模式,DM_FPS_TARGET=30 可省電,DM_SHOW_FPS=1 顯示 FPS 計數器。
沒有 amiibo,沒有線上功能。其他遊戲會得到一份分析報告和盡力而為的 IPA,可能無法啟動。
需要圖形化建置、遊戲庫管理或舊版 iOS 支援?了解這些由社群獨立維護的專案,並在詳情頁查看需求與原始碼連結。
面向 Mac、iPhone 與 iPad 的圖形啟動器與遊戲庫,可建置並管理遊戲。v1.0 起,iPhone 與 iPad 共用統一殼應用,包含遊戲庫、Cover Flow、手把與鍵盤導覽及逐遊戲設定;引擎隨發行版打包並每日跟隨上游。
查看詳情 →把解包、Mac 執行、打包、裝置安裝與存檔管理集中在同一遊戲庫,並新增 iPhone 與 iPad 的 NX Play 啟動器。行動端可列出 Mac 遊戲、透過區域網路請求安裝、以手把啟動已安裝遊戲並提醒續簽。
查看詳情 →LumaNX(原名 LumaDock)整合 nxnative、圖形遊戲庫、建置佇列與轉換工具。0.3.0 新增僅限 Mac 的實驗性解密 Switch 2 資料夾匯入,並重複使用未變更的準備階段。
查看詳情 →面向舊版 iOS 的實驗性相容開發分支,使用傳統 Metal、依裝置限制的著色器與逐建置遊戲轉接。維護分支現已更名為 ios16-ios17-compat。
查看詳情 →nx2android 將 nxnative 的直接執行方式帶到 Android:遊戲自身的 ARM64 程式碼在裝置上執行,NVN 繪圖呼叫轉譯至 Vulkan,建置器會產生 APK 和遊戲資料。
查看詳情 →MacNativeGames 是聚焦《曠野之息》與《王國之淚》的獨立原生執行專案,涵蓋 Mac、iPhone、iPad,並提供早期 Vision Pro 支援。
查看詳情 →xbunax/nxnative 是加入本機 WebUI 建置工作室的分支,提供瀏覽器匯入、XCI 轉換、工作管理,以及 Windows 與 macOS 的 IPA 建置路徑。
查看詳情 →CA-NINAPPLE 是源自 NXNativeWindows 的 Windows 向分支,GUI 與 PowerShell 可在沒有 Mac 時從遊戲和金鑰建置 iOS IPA。
查看詳情 →NX OS 是建構於 nxnative 的主機風格 macOS 啟動器,可尋找已建置遊戲、全螢幕啟動、記錄遊玩時間,並發起新的 Mac 或 iPhone 建置。
查看詳情 →nxnative-gui 是輕量 macOS 圖形前端,本身不是另一套執行環境。它會複製或更新 nxnative、檢查工具鏈,並把終端機中的建置選項集中到同一個表單。
查看詳情 →ns2ios-shell 將可重用的遊戲無關 iOS 殼與逐遊戲本機打包分開。CI 建置殼,打包器可在 Windows、Linux 或 macOS 無 Xcode 環境把遊戲與殼組合。
查看詳情 →