azmasm/switch2mac

选用指南

AI 根据 README 整理 · 2026/11/3 22:07:11

使用方式

通过命令行工具 switch2mac.py 进行 setup、build、install 等操作，构建后生成可双击运行的 Mac 应用。

查看 README 依据

- About 50 GB free disk space during the build (the game image is 22 GB; on the same APFS disk the app shares it instead of copying it). - Your dump of Mario Kart World 1.0.0: a folder with `exefs/` (main, main.npdm, sdk, subsdk0, rtld) and `romfs/`, or `base/exefs` and `base/romfs`. Already extracted, as dump tools write it: switch2mac needs no keys and decrypts nothing. ## Build it ```bash git clone https://github.com/azmasm/switch2mac.git ``` ```bash cd switch2mac ``` ```bash ./switch2mac.py setup ``` ```bash ./switch2mac.py build "/path/to/your/dump" ``` ```bash

./switch2mac.py install ``` `setup` makes a Python environment in `.venv` and checks Xcode, Metal and .NET. `build` does everything else, writing only into `./work`: 1. **Game files**: the code modules and one RomFS image (dump-tool leftovers such as `.listing` files are left out). 2. **Code**: rewrites the game's modules so they run on the Mac. 3. **Shaders**: takes the shaders from the game's archives and the ones it builds at run time from the dump, lowers them, translates them to Metal and compiles them. The long step: 10-20 minutes the first time, using every core.

部署要求

需要 Apple 芯片 Mac 和 macOS 26 或更高版本，Xcode 及 Metal 工具链，.NET 10 SDK，Python 3.12 或更新，约 50 GB 磁盘空间，以及游戏 dump。

查看 README 依据

- A Mac with Apple silicon and **macOS 26 or later** (the runtime draws with Metal 4, new in macOS 26). The app is built for the macOS version of the Mac that builds it (tested: M1 Max, 64 GB, macOS 26.6; reported working: M4 Pro, 24 GB, macOS 26.5). The game uses about 13-16 GB of memory. - **Xcode** with the Metal toolchain (Xcode → Settings → Components), and its command line tools. - **.NET 10 SDK** ([dot.net](https://dot.net)): the shader translator runs on it. - **Python 3.12 or newer** (python.org or Homebrew).

- About 50 GB free disk space during the build (the game image is 22 GB; on the same APFS disk the app shares it instead of copying it). - Your dump of Mario Kart World 1.0.0: a folder with `exefs/` (main, main.npdm, sdk, subsdk0, rtld) and `romfs/`, or `base/exefs` and `base/romfs`. Already extracted, as dump tools write it: switch2mac needs no keys and decrypts nothing. ## Build it ```bash git clone https://github.com/azmasm/switch2mac.git ``` ```bash cd switch2mac ``` ```bash ./switch2mac.py setup ``` ```bash ./switch2mac.py build "/path/to/your/dump" ``` ```bash

已知限制

仅测试了 Mario Kart World 1.0.0，其他版本会停止构建；首次启动需等待 1-3 分钟；未覆盖的着色器可能导致卡顿。

查看 README 依据

4. **Host** (the native runtime) and **app**. `install` moves the app to `/Applications`, replacing an older one. ### The first start waits After every install macOS scans the new 22 GB app before it lets it run: **1-3 minutes with no window and no Dock icon**. Wait; do not open it a second time. Later starts are immediate. The app is signed ad hoc (not notarized), so the very first time macOS may ask: right-click the app → Open. ### First start: a short "preparing" screen

Only 1.0.0 is tested. `build` checks the dump's build ID and stops on any other version, because the profile ([`nxnative/dm/games/0400C3F00006E000/game.tsv`](nxnative/dm/games/0400C3F00006E000/game.tsv)) names the exact modules and build IDs it rewrites. To try an update, see [games/mario-kart-world/README.md](games/mario-kart-world/README.md#other-versions); expect new problems. ## Problems - The log: `~/Library/Logs/nxnative/0400C3F00006E000.log` (`.prev.log` is the run before). Lines with `[RED]` are things the runtime does not handle.