Guide: Running Switch games natively on Mac with nxnative
AppleGamingWiki · 영어 자료
원문 보기 →보유한 게임 파일과 키로 Apple Silicon 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 플랫폼도 필요합니다. 게임 크기의 약 2배 + 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에서는 화면 오른쪽 3분의 1을 스와이프해 카메라를 움직입니다. 폰을 흔들면 컨트롤러가 흔들립니다.
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 같은 줄을 추가하세요.
파일 앱의 앱 이름 아래에 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 게임을 빌드하고 관리하는 macOS 런처 겸 게임 라이브러리입니다. v1.0부터 iPhone/iPad는 게임 라이브러리, Cover Flow, 컨트롤러·키보드 탐색, 게임별 설정을 갖춘 공용 셸을 사용하며 엔진은 릴리스에 포함되고 매일 상위 프로젝트를 따릅니다.
자세히 보기 →추출, Mac 실행, IPA 생성, 기기 설치, 세이브 관리와 iPhone/iPad용 NX Play 런처를 하나의 라이브러리로 묶습니다. 모바일 런처는 Mac 게임을 나열하고 로컬 네트워크로 설치를 요청해 실행할 수 있습니다.
자세히 보기 →nxnative와 게임 라이브러리, 빌드 큐, 패키지 변환 도구를 합친 LumaNX(이전 LumaDock)입니다. 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 빌드 스튜디오를 추가한 nxnative 포크입니다. 브라우저 기반 가져오기, 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 없이 게임과 결합합니다.
자세히 보기 →