Skip to content

Play your own Switch games on iPhone/iPad — one-click macOS app, no terminal. | 把 Switch 游戏装进 iPhone:图形界面一键构建,不用命令行。Bring your own game.

Release v1.2.3: experimental builder with nxbuild 0.6.2

v0lumehiff15478b386f
diff --git a/BUILDING.md b/BUILDING.md
index 52b88be1..5b16fcab 100644
--- a/BUILDING.md
+++ b/BUILDING.md
@@ -68,7 +68,7 @@ NXB_ENGINE=engine nxb build <NSP folder> --platform mac-app -k <prod.keys> --tit
-o <app> --work-dir <build folder> --engine engine --progress json
```
-- The program is the `nxb` binary the player chose in Settings (the binary, or the folder that holds it), else the copy inside the app, which `frontend/nxbuild.pin` names. It needs nxb 0.5.1 or newer: the launcher reads `nxb version` first and stops with a message when the nxb is older.
+- The program is the `nxb` binary the player chose in Settings (the binary, or the folder that holds it), else the copy inside the app, which `frontend/nxbuild.pin` names. It needs nxb 0.6.2 or newer: the launcher reads `nxb version` first and stops with a message when the nxb is older.
- The command line is the script's own: the launcher builds the arguments it gives the script (input folder, `.nup` file or dump folder, `-k`, `--work-dir`, `--platform`, `-o`, `--shell-framework`, `--team-id`, `--romfs`, `--env-file`) and runs `nxb build` with them, so the same cases reach nxb. DLC, NSZ, XCI and merged packages in the folder are found by nxb itself. A game with no profile is surveyed by nxb, and the launcher does not pass `--no-heap-check`, as it does not for the script, so nxb stops with exit code 4 and names the step it cannot do yet.
- `--progress json` prints one JSON event per line (`stage`, `step`, `progress`, `stage_end`, `say`, each with `code` and `severity`). The launcher shows them as its own stages and writes every line to the build log.
- There is no fallback. A failure, or a game or step nxb does not take, shows nxb's exit code in words and its last error line. The exit codes are 0 done, 1 error, 2 bad arguments, 3 damaged data, 4 not supported yet, 6 missing key and 130 interrupted. Turning the setting off builds with the script again.
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 2c9d88e0..4ae9dfd6 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,7 @@ Newest first. The fork follows upstream daily, so its game list and host fixes a
| Date | Version | What changed |
|---|---|---|
+| 2026-11-06 | v1.2.3 | **Fixed**: the experimental builder builds again. The app bundles `nxbuild 0.6.2`, which reads the engine from `NXB_ENGINE` (1.2.2 stopped with "--engine <engine folder> is required") and is ported to the engine pin `88c7e03f51e3` (0.6.1 refused its `patch_nso.py`). The extract stage has a name and a bar with the time left, and no raw `%@`. The launcher needs nxb 0.6.2 or newer. **Changed**: `nxb 0.6` translates the shaders with its own translator, without `spirv-cross`. No whole game has been built with it yet (#PRNUM). |
| 2026-11-06 | v1.2.2 | **New**: the experimental builder (Settings, Use experimental builder) now builds the whole game with nxbuild: the launcher runs `nxb build` and does not run the build script at all, for a Mac app and for the iPhone and iPad options. It reads NSP, NSZ, XCI, merged packages, a NUP, a game folder and DLC, and surveys a game with no profile. There is no fallback to the script: a case nxb does not take, or a failure, shows nxb's exit code and its last error line. It needs nxb 0.5.1 or newer, which the app bundles when its release is pinned. The setting is off by default and nothing changes for a default build. Not yet run on a device: the iPhone and iPad path, and the new input kinds on real game files (#749, #794). French, Italian and Swedish controller and Steam Controller (2026) texts, waiting for a native review, by @v0lumehi (#789). A guide for updating a built Mac game and keeping its saves, by @thehobbit85 (#796, #805). The Windows launcher is `NX2Apple.exe` now, with an in-app update, the old settings and library stay (#812). Engine pin `88c7e03f51e3` (28 upstream commits): Ocarina of Time on Switch 2 plays on the Mac at about 59 fps through Kokiri Forest (seedds/nxnative#1299) and Kirby Air Riders on Switch 2 at 60 fps, Mac only, by upstream's notes, nobody has played them on this fork (#813). **Fixed**: building an NVN game for the shared iPhone and iPad app no longer stops at `FAIL: copy the shader libraries` after the engine packed the shader library into `b-<chain>.img`, reported by @zhukangyu26-stack, @tnt739660506-prog and @caixukun1919810114514, by @xiaofeng-han (#781, #795, #800, #782). Library cover banners for the eight Switch 2 and Nintendo Classics games not yet in `titledb`, on the Mac and on Windows (#808). The build activity bar says that scanning the last few shader files can take several minutes instead of looking stuck at 99%, by @thehobbit85 (#489, #806). The Mac launcher copies the game data to an iPhone again when an update produced a different `romfs.img` of the same size, by @thehobbit85 (#261, #807). The Qt launcher tests pass on macOS's Python 3.9, reported by @Koshindai, by @thehobbit85 (#799, #804). iOS 26.0 no longer crashes before the first frame with Metal 4 pipelines, upstream PR #1213 by @mmkzer0. Games with a big memory layout work on the Mac and a game whose memory pool does not fit an iPhone keeps its guest memory in files. Audio renderers play from their own PCM blocks. A reboot no longer packs the game data again, upstream PR #1354 by @lunks. A missing `zbic` package is found at the start, and an Oodle shader table is proven by a decode. Game fixes from the engine include Mario Strikers: Battle League by @sen-6ei and Assassin's Creed Revelations by @Fbenhaddou, plus Axiom Verge, Super Smash Bros. Ultimate, Fire Emblem Fortune's Weave, Super Mario Galaxy 2, Splatoon Raiders, Breath of the Wild and Unreal games (#813). The Windows Library game strip no longer widens the page (#812). On Windows, building from an extracted game folder no longer stops at `pack v...` with `FileNotFoundError: [WinError 2]` on `cp -c`, the shader split no longer fails with `ValueError: max_workers must be <= 61` on a PC with 32 or more CPU threads, a game or build folder with Chinese or other non-ASCII characters no longer fails at `[5/7] iOS shaders` with `no iOS shader libraries`, and a fresh install opens the first-run setup assistant automatically (#803, #810). Not yet run on a device: the shader split hint and the iPhone data receipt were checked with synthetic events only (#806, #807). Every NVN game built before is built again once, because the shader chain moved (#449, #813). No real game was run on the new engine build by us, and the Windows self-update was not run from a real release (#812, #813) |
| 2026-11-06 | v1.2.1 | **New**: Steam Controller (2026) over USB-C, Bluetooth and the Puck, with per-game mappings in the launcher, games must be rebuilt, by @thehobbit85 (#764, #731). A note in Launch options that says why a game has no resolution setting, by @Haseenesss (#574, #754). **Fixed**: the Mac launcher builds a Switch 2 NUP or a game folder of a game with no profile when the engine can survey it, the game itself does not run yet and needs upstream work (seedds/nxnative#1299), the Qt launcher still refuses it, reported by @xdgpx (#748, #783). The Mac host build uses the selected Python, reported by @temmiegreen, by @thehobbit85 (#711, #729). Windows finds `python.exe` in the install folder when it chains into the venv (#774). 20 Italian shell texts reworded by @zatteogit (#744). The README says Switch 2 games need no `prod.keys`, by @rivitt (#734). The compatibility switch for older iPhones and iPads writes the key the game reads, by @thehobbit85 (#719, #723). Build progress and log stay across launcher windows, by @thehobbit85 (#405, #724). A failure row for low disk space while building the Metal archive, by @thehobbit85 (#463, #725). `DM_PSO_BUNDLE=off` from env files works on iPhone and iPad, by @thehobbit85 (#726). The Tool tests job reports engine test failures and the shell and language-row tests are repaired (#690, #698, #722, #727, #728, #786) |
| 2026-11-05 | v1.2.0 | **Fixed**: wrong library covers such as a Switch 2 Edition or a bundle instead of the game, 164 of 167 titles with several shop products now pick the game, reported by @zatteogit (#403, #632). About 120 iPhone shell texts that were English in German, Swedish, French and Italian, and three error messages that were English everywhere, now in six languages, machine translated and waiting for review (#631). SideStore installs of a shared IPA with a very large shader tree, by @Silverhza (#587, #593). iPhone Duo rotation and the tabletop layout, by @jonochocki (#642). Game files with an upper case extension (#554). Games in a subfolder whose update or DLC sits in a sibling subfolder (#760, #762). The Mac app build on a disk without an atomic swap (#595, #742). The game language row for a Switch 2 game with a NUP update (#619). The game language row for a Switch 2 game with no control data, read from the game's own files, on the Mac and on iPhone and iPad (#668, #693). The iPhone quit prompt text (#620), the game data out of the iCloud backup (#618), the iPhone and iPad shell controller input order and tap echo guard by @Haseenesss (#660), the console mode pointer staying hidden while a game starts by @Haseenesss (#380, #741), the Windows engine recovery crash (#613), and the Windows Python install chaining directly into the venv and offline wheels setup plus 1.2 engine `tree_tar` and single-file shader library support (#765, #772). The stale shader notice popup for both reasons, texts waiting for a native review, by @djdev0010 (#320, #470). **New**: engine pin `777a5f6c618a` with 105 upstream commits, Mario Kart World, Mario Tennis Fever, Super Mario 3D All-Stars and more (#689), and `7249ee9f95ed` with 28 more upstream commits, Star Fox (Switch 2), Yoshi and the Mysterious Book (Switch 2) and DRAGON QUEST BUILDERS 2 at 60 fps, up to 120 fps for Fire Emblem Fortune's Weave and Mario & Luigi: Brothership, and single-file shader libraries and compile caches, by upstream's notes and not played by us, built games are rebuilt on the first Play (#712, #761). The Windows release (`NX2Apple-windows-x64.zip`) on the releases page with the 1.2.0 interface, the bundled engine tree so a Windows player needs no git, multi-core parallel NSO rewriting, cache management and an in-place iPhoneOS 27.2 SDK upgrade (#615, #616, #765, #768, #771, #772). Each iPhone and iPad game framework carries its own host binary (`loader: "FH"`), so future engine updates no longer require rebuilding existing games before they can start (#451, #756). Experimental builder (`nxbuild 0.2.0`, off by default) for Rust extraction and shader splitting of NSP, XCI, NSZ, dump folders and Switch 2 `.nup` packages (#749, #752, #766, #767). Split a Bluetooth Joy-Con pair into two sideways controllers on the Mac (#740, #745, #770). iPhone Duo side column for the chips and Back (#622, #633). "Preparing game…" after Play, by @Silverhza (#652). 24 Italian texts reworded, by @zatteogit and @Dino0005 (#687, #704). The .NET check follows the dotnet the build runs, by @oliphantaaron (#342). **Known issues**: of the Switch 2 games only Donkey Kong Bananza was tried, through the launcher on a Mac, an iPhone and an iPad (#445), the Switch 2 game language list is not seen on a device and has no Thai or Polish (#693), of the Switch 2 games only Donkey Kong Bananza has a store cover (#632), and the Duo side column is only checked in the Simulator (#622) |
diff --git a/CHANGELOG.zh-CN.md b/CHANGELOG.zh-CN.md
index 8910456e..a77b4f41 100644
--- a/CHANGELOG.zh-CN.md
+++ b/CHANGELOG.zh-CN.md
@@ -6,6 +6,7 @@ NX2Apple 的版本历史,最新在上,每个版本的完整说明见[发布
| 日期 | 版本 | 变更 |
|---|---|---|
+| 2026-11-06 | v1.2.3 | **修复**:实验性构建器可以再次构建。App 自带 `nxbuild 0.6.2`,它从 `NXB_ENGINE` 读取引擎(1.2.2 会以「--engine <engine folder> is required」停止),并已移植到引擎固定点 `88c7e03f51e3`(0.6.1 拒绝了它的 `patch_nso.py`)。解包阶段有名称和显示剩余时间的进度条,不再显示原始的 `%@`。启动器需要 nxb 0.6.2 或更新版本。**变更**:`nxb 0.6` 用自己的转换器转换着色器,不再使用 `spirv-cross`。还没有用它构建过完整的游戏(#PRNUM)。 |
| 2026-11-06 | v1.2.2 | **新增**:实验性构建器(设置里的「使用实验性构建器」)现在用 nxbuild 构建整个游戏:启动器直接运行 `nxb build`,完全不运行构建脚本,Mac App 和 iPhone、iPad 选项都是如此。它读取 NSP、NSZ、XCI、合并包、NUP、游戏文件夹和 DLC,并勘测没有配置的游戏。不会退回脚本:nxb 不支持的情况或失败时,会显示 nxb 的退出代码和最后一条错误。需要 nxb 0.5.1 或更新版本,固定版本后 App 会自带。该设置默认关闭,默认构建不受影响。尚未在真机上运行:iPhone 和 iPad 路径,以及真实游戏文件的新输入类型(#749、#794)。法语、意大利语和瑞典语的手柄设置与 Steam Controller(2026)文字,等待母语者审校,作者 @v0lumehi(#789)。更新已构建 Mac 游戏并保留存档的指南,作者 @thehobbit85(#796、#805)。Windows 启动器现在叫 `NX2Apple.exe`,带应用内更新,旧设置和游戏库保持不变(#812)。引擎固定点 `88c7e03f51e3`(上游 28 个提交):《时之笛》Switch 2 版在 Mac 上穿过科奇里森林时约 59 fps(seedds/nxnative#1299),Switch 2 版 Kirby Air Riders 60 fps,按上游说明只限 Mac,我们这个分支还没有人玩过(#813)。**修复**:引擎把 NVN 游戏的着色器库打包成单个文件 `b-<chain>.img` 后,为共用 iPhone 和 iPad 壳 App 构建游戏不再在 `FAIL: copy the shader libraries` 处停止,由 @zhukangyu26-stack、@tnt739660506-prog 和 @caixukun1919810114514 报告,作者 @xiaofeng-han(#781、#795、#800、#782)。Mac 和 Windows 游戏库为 `titledb` 中尚未收录的 8 款 Switch 2 与 Nintendo Classics 游戏补齐封面横幅(#808)。构建活动条会提示扫描最后几个着色器文件可能需要几分钟,不再看起来像停在 99% 卡住,作者 @thehobbit85(#489、#806)。更新生成大小相同但内容不同的 `romfs.img` 时,Mac 启动器会重新向 iPhone 复制游戏数据,作者 @thehobbit85(#261、#807)。Qt 启动器测试在 macOS 的 Python 3.9 上通过,由 @Koshindai 报告,作者 @thehobbit85(#799、#804)。iOS 26.0 开启 Metal 4 管线时不再在第一帧前崩溃,上游 PR #1213,作者 @mmkzer0。内存布局很大的游戏可在 Mac 上运行,内存池放不进 iPhone 的游戏会把来宾内存放在文件里。音频渲染器从自己的 PCM 块播放。重启后不再重新打包游戏数据,上游 PR #1354,作者 @lunks。缺少 `zbic` 包会在开始时被发现,Oodle 着色器表由解码来证明。引擎带来的游戏修复包括 @sen-6ei 的 Mario Strikers: Battle League、@Fbenhaddou 的 Assassin's Creed Revelations,以及 Axiom Verge、Super Smash Bros. Ultimate、Fire Emblem Fortune's Weave、Super Mario Galaxy 2、Splatoon Raiders、Breath of the Wild 和 Unreal 游戏(#813)。Windows 游戏库的横向条不再撑宽页面(#812)。Windows 上从解压的游戏文件夹构建不再因 `cp -c` 在 `pack v...` 阶段报 `FileNotFoundError: [WinError 2]`,32 线程及以上 CPU 在 `shader split` 阶段不再报 `ValueError: max_workers must be <= 61`,包含中文或其他非 ASCII 字符的游戏目录或构建目录不再在 `[5/7] iOS shaders` 阶段报 `no iOS shader libraries`,全新首次启动时会自动弹出设置向导(#803、#810)。尚未在真机上运行:着色器拆分提示和 iPhone 数据回执只用模拟事件检查过(#806、#807)。以前构建的每个 NVN 游戏都要重新构建一次,因为着色器链变了(#449、#813)。我们没有在新引擎构建上运行过真实游戏,Windows 自更新也没有用真实发布版本运行过(#812、#813) |
| 2026-11-06 | v1.2.1 | **新增**:Steam Controller(2026)支持 USB-C、蓝牙和 Puck,启动器里有每个游戏的映射,旧游戏需要重新构建,作者 @thehobbit85(#764、#731)。启动选项里新增说明游戏为什么没有分辨率设置的提示,作者 @Haseenesss(#574、#754)。**修复**:引擎能勘测游戏时,Mac 启动器可以构建没有配置的 Switch 2 NUP 或游戏文件夹,游戏本身还不能运行,需要上游的工作(seedds/nxnative#1299),Qt 启动器仍然拒绝,由 @xdgpx 报告(#748、#783)。Mac 宿主构建使用所选的 Python,由 @temmiegreen 报告,作者 @thehobbit85(#711、#729)。Windows 链接虚拟环境时在安装文件夹里找到 `python.exe`(#774)。@zatteogit 改写了 20 条意大利语壳 App 文字(#744)。README 说明 Switch 2 游戏不需要 `prod.keys`,作者 @rivitt(#734)。老 iPhone 和 iPad 的兼容开关写入游戏读取的键,作者 @thehobbit85(#719、#723)。构建进度和日志在多个启动器窗口之间保持,作者 @thehobbit85(#405、#724)。构建 Metal 归档时磁盘空间不足有了失败提示,作者 @thehobbit85(#463、#725)。env 文件里的 `DM_PSO_BUNDLE=off` 在 iPhone 和 iPad 上生效,作者 @thehobbit85(#726)。Tool tests 任务会报告引擎测试失败,壳 App 和语言行测试已修复(#690、#698、#722、#727、#728、#786) |
| 2026-11-05 | v1.2.0 | **修复**:游戏库封面不对(选成 Switch 2 版或套装而不是游戏本身),在有多个商店商品的 167 个游戏里 164 个现在选对,由 @zatteogit 报告(#403、#632)。约 120 条 iPhone 壳 App 文字在德语、瑞典语、法语和意大利语里是英文,另有三条错误信息在所有语言里都是英文,现已有六种语言,机器翻译,等待审校(#631)。着色器文件很多的共用 IPA 用 SideStore 安装失败,作者 @Silverhza(#587、#593)。iPhone Duo 旋转和桌面布局,作者 @jonochocki(#642)。扩展名为大写的游戏文件(#554)。子文件夹里的基础游戏与同级子文件夹里的更新或 DLC 自动关联(#760、#762)。在不支持原子替换的磁盘上构建 Mac App(#595、#742)。带 NUP 更新的 Switch 2 游戏的语言一行(#619)。没有控制数据的 Switch 2 游戏的语言一行,读自游戏自己的文件,Mac 和 iPhone、iPad 上都有(#668、#693)。iPhone 退出提示文字(#620)、游戏数据不进 iCloud 备份(#618)、iPhone 和 iPad 壳 App 手柄输入事件顺序与触控回声保护,作者 @Haseenesss(#660)、主机模式启动游戏期间鼠标指针保持隐藏,作者 @Haseenesss(#380、#741)、Windows 引擎恢复崩溃(#613),以及 Windows 安装 Python 后直接连装虚拟环境与内置离线 wheel 包、iOS 交叉构建支持 1.2 引擎 `tree_tar` 和单文件着色器库(#765、#772)。过期着色器提示在两种原因下都会弹出,文字等待母语者审校,作者 @djdev0010(#320、#470)。**新增**:引擎版本 `777a5f6c618a`(含上游 105 个提交,Mario Kart World、Mario Tennis Fever、Super Mario 3D All-Stars 等,#689)及 `7249ee9f95ed`(再进上游 28 个提交,Star Fox(Switch 2)、Yoshi and the Mysterious Book(Switch 2)和 DRAGON QUEST BUILDERS 2 60 帧,Fire Emblem Fortune's Weave 和 Mario & Luigi: Brothership 最高 120 帧,单文件着色器库与编译缓存,#712、#761),按上游的说明,我们没有玩过,已构建的游戏第一次点 Play 会重新构建。Windows 正式版(`NX2Apple-windows-x64.zip`)随发布页提供,对齐 1.2.0 界面并自带引擎目录(Windows 玩家不需要 git),支持多核并行 NSO 重写、缓存管理及就地升级到 iPhoneOS 27.2 SDK(#615、#616、#765、#768、#771、#772)。iPhone 和 iPad 每个游戏框架自带独立宿主二进制(`loader: "FH"`),后续引擎更新不再强制已构建游戏重新构建才能启动(#451、#756)。实验性构建器(`nxbuild 0.2.0`,默认关闭),用 Rust 快速完成 NSP、XCI、NSZ、解包目录及 Switch 2 `.nup` 软件包的解包与着色器拆分(#749、#752、#766、#767)。Mac 端支持将一对蓝牙 Joy-Con 拆分为两个独立横握手柄(#740、#745、#770)。iPhone Duo 侧边栏放置按钮和返回键(#622、#633)。点 Play 后显示「Preparing game…」,作者 @Silverhza(#652)。24 条意大利语文字改写,作者 @zatteogit 和 @Dino0005(#687、#704)。「.NET 检查」跟随构建实际使用的 dotnet,作者 @oliphantaaron(#342)。**已知问题**:Switch 2 游戏里只试过 Donkey Kong Bananza,通过启动器在 Mac、iPhone 和 iPad 上玩过(#445),Switch 2 游戏的语言列表没有在真机上看过,也没有泰语和波兰语(#693),Switch 2 游戏里只有 Donkey Kong Bananza 有商店封面(#632),Duo 侧边栏只在模拟器里检查过(#622) |
diff --git a/frontend-qt/nspb_qt/app_update.py b/frontend-qt/nspb_qt/app_update.py
index 01c23706..1b26fc37 100644
--- a/frontend-qt/nspb_qt/app_update.py
+++ b/frontend-qt/nspb_qt/app_update.py
@@ -20,7 +20,7 @@ import urllib.request
import zipfile
#: Bump together with each release tag and `AppUpdateStore.appVersion` in Swift.
-APP_VERSION = '1.2.2'
+APP_VERSION = '1.2.3'
LATEST_RELEASE_URL = 'https://api.github.com/repos/LNPANDY/NX2Apple/releases/latest'
RELEASES_PAGE_URL = 'https://github.com/LNPANDY/NX2Apple/releases/latest'
diff --git a/frontend/Sources/NXCore/BuildProgress.swift b/frontend/Sources/NXCore/BuildProgress.swift
index 2bd3af9a..9e5643fb 100644
--- a/frontend/Sources/NXCore/BuildProgress.swift
+++ b/frontend/Sources/NXCore/BuildProgress.swift
@@ -24,7 +24,8 @@ package struct Stage: Identifiable {
func known(_ key: String) -> String? { let s = t(key); return s == key ? nil : s }
let key = "stage." + name.lowercased().replacingOccurrences(of: "[^a-z0-9]+", with: "_", options: .regularExpression)
.trimmingCharacters(in: CharacterSet(charactersIn: "_"))
- if let s = known(key) { return s }
+ // a bare "extract" (nxb 0.6.1 and older) has no part for the table's "extract %@"
+ if let s = known(key), !s.contains("%@") { return s }
if name.hasPrefix("extract "), let f = known("stage.extract") { return String(format: f, String(name.dropFirst("extract ".count))) }
// A game folder packs each version into an image ("pack v458752", pack_dump.py), a NUP unpacks it ("unpack v196608", pack_nup.py)
if name.hasPrefix("pack "), let f = known("stage.pack") { return String(format: f, String(name.dropFirst("pack ".count))) }
diff --git a/frontend/Sources/NXCore/ExperimentalBuilder.swift b/frontend/Sources/NXCore/ExperimentalBuilder.swift
index d19fa40c..12b5b310 100644
--- a/frontend/Sources/NXCore/ExperimentalBuilder.swift
+++ b/frontend/Sources/NXCore/ExperimentalBuilder.swift
@@ -36,8 +36,9 @@ package enum ExperimentalBuilder {
["NXB_ENGINE": engine]
}
- /// The oldest nxbuild that has the whole `nxb build` command line of the NSP script (NSZ, XCI, merged packages, a NUP, a dump folder, DLC, a game with no profile, the iPhone options).
- package static let minimumVersion = "0.5.1"
+ /// The oldest nxbuild that builds with this app: it has the whole `nxb build` command line of the NSP script, reads the engine from
+ /// `NXB_ENGINE` and takes the pinned engine's `patch_nso.py` (0.5.1 to 0.6.1 stop with "--engine is required" or at the rewrite).
+ package static let minimumVersion = "0.6.2"
/// The command line of `nxb build` from the script's: the same options in the same names, with `build` in place of the script's path (the first element).
package static func arguments(fromScript args: [String]) -> [String] {
diff --git a/frontend/Sources/NXModel/AppUpdateStore.swift b/frontend/Sources/NXModel/AppUpdateStore.swift
index 1c23b5b2..a6d467d9 100644
--- a/frontend/Sources/NXModel/AppUpdateStore.swift
+++ b/frontend/Sources/NXModel/AppUpdateStore.swift
@@ -19,7 +19,7 @@ import NXCore
@MainActor package final class AppUpdateStore: ObservableObject {
/// Bump together with each release tag: the update check compares it with the latest release.
/// `build-mac-app.yml`, `sync-upstream.yml`, `tools/try-local` and `RELEASING.md` read this line. Keep it in this form.
- nonisolated package static let appVersion = "1.2.2"
+ nonisolated package static let appVersion = "1.2.3"
/// The version this store compares releases with: `appVersion`, unless a test passes another.
nonisolated package let version: String
diff --git a/frontend/Tests/NX2AppleTests/ControlsTests.swift b/frontend/Tests/NX2AppleTests/ControlsTests.swift
index cb461a86..a093c33c 100644
--- a/frontend/Tests/NX2AppleTests/ControlsTests.swift
+++ b/frontend/Tests/NX2AppleTests/ControlsTests.swift
@@ -80,6 +80,9 @@ final class StageNameTests: IsolatedDefaultsTestCase {
XCTAssertEqual(Stage.localizedName("Vulkan shader capture", zh), "Vulkan 着色器捕获")
XCTAssertEqual(Stage.localizedName("a stage added later", zh), "a stage added later", "an unknown name stays as the script wrote it")
XCTAssertEqual(Stage.localizedName("Mac app", { $0 }), "Mac app")
+ let de = { (k: String) in L10n.string(k, Lang("de")) }
+ XCTAssertEqual(Stage.localizedName("extract", de), "extract", "nxb 0.6.1 names the stage without a version: no \"%@ extrahieren\"")
+ XCTAssertEqual(Stage.localizedName("extract v0 + v327680", de), "v0 + v327680 extrahieren")
}
/// A Switch 2 game folder packs its versions (pack_dump.py), a NUP unpacks them (pack_nup.py): build_ipa_from_nsp.py's
diff --git a/frontend/Tests/NXCoreTests/ExperimentalBuilderTests.swift b/frontend/Tests/NXCoreTests/ExperimentalBuilderTests.swift
index a72f2950..e58bdb1e 100644
--- a/frontend/Tests/NXCoreTests/ExperimentalBuilderTests.swift
+++ b/frontend/Tests/NXCoreTests/ExperimentalBuilderTests.swift
@@ -35,10 +35,11 @@ final class ExperimentalBuilderTests: XCTestCase {
}
func testTheVersionThatHasTheWholeCommandLine() {
- XCTAssertTrue(ExperimentalBuilder.isNewEnough("nxb 0.5.1\n"))
- XCTAssertTrue(ExperimentalBuilder.isNewEnough("nxb 0.5.10"))
+ XCTAssertTrue(ExperimentalBuilder.isNewEnough("nxb 0.6.2\n"))
+ XCTAssertTrue(ExperimentalBuilder.isNewEnough("nxb 0.6.10"))
XCTAssertTrue(ExperimentalBuilder.isNewEnough("nxb 1.0.0"))
- XCTAssertFalse(ExperimentalBuilder.isNewEnough("nxb 0.5.0"))
+ XCTAssertFalse(ExperimentalBuilder.isNewEnough("nxb 0.6.1"), "reads no engine from NXB_ENGINE or refuses the engine's patch_nso.py")
+ XCTAssertFalse(ExperimentalBuilder.isNewEnough("nxb 0.5.1"))
XCTAssertFalse(ExperimentalBuilder.isNewEnough("nxb 0.4.0"))
XCTAssertFalse(ExperimentalBuilder.isNewEnough("usage: nxb <command>"), "no version in it")
XCTAssertFalse(ExperimentalBuilder.isNewEnough(""))
diff --git a/frontend/Tests/NXModelTests/BuildStoreTests.swift b/frontend/Tests/NXModelTests/BuildStoreTests.swift
index a11976b0..86848b0a 100644
--- a/frontend/Tests/NXModelTests/BuildStoreTests.swift
+++ b/frontend/Tests/NXModelTests/BuildStoreTests.swift
@@ -174,7 +174,7 @@ import XCTest
XCTAssertEqual(store.experimentalBuilderBinary, nxb)
runner.answer = { _ in ProcessResult(status: 0, out: "nxb 0.4.0\n") }
XCTAssertEqual(store.experimentalBuilderProblem(), String(format: store.t("nxb.tooOld"), "nxb 0.4.0", ExperimentalBuilder.minimumVersion))
- runner.answer = { _ in ProcessResult(status: 0, out: "nxb 0.5.1\n") }
+ runner.answer = { _ in ProcessResult(status: 0, out: "nxb 0.6.2\n") }
XCTAssertNil(store.experimentalBuilderProblem(), "a game or a step nxb does not take ends with its own exit code 4")
XCTAssertTrue(runner.commands.contains("nxb version"))
store.experimentalBuilder = false
diff --git a/frontend/Tests/NXModelTests/GameFolderStoreTests.swift b/frontend/Tests/NXModelTests/GameFolderStoreTests.swift
index 14f8a17c..28ff51c8 100644
--- a/frontend/Tests/NXModelTests/GameFolderStoreTests.swift
+++ b/frontend/Tests/NXModelTests/GameFolderStoreTests.swift
@@ -131,7 +131,7 @@ import XCTest
let nxb = root + "/nxbuild/nxb"
write(nxb)
try? FileManager.default.setAttributes([.posixPermissions: 0o755], ofItemAtPath: nxb)
- runner.answer = { _ in ProcessResult(status: 0, out: "nxb 0.5.1\n") }
+ runner.answer = { _ in ProcessResult(status: 0, out: "nxb 0.6.2\n") }
store.experimentalBuilder = true; store.experimentalBuilderPath = nxb
store.startBuild()
XCTAssertEqual(store.lastBuildCommand, [nxb, "build"] + standard.dropFirst(2), "nxb build in place of the interpreter and the script, the same options after")
diff --git a/release-notes/v1.2.3.md b/release-notes/v1.2.3.md
new file mode 100644
index 00000000..92a0790f
--- /dev/null
+++ b/release-notes/v1.2.3.md
@@ -0,0 +1,37 @@
+**v1.2.3: The experimental builder builds again, with the bundled nxbuild 0.6.2.**
+
+## English
+
+**Fixed**
+- **Experimental builder stopped at once (`--engine <engine folder> is required`)**: in 1.2.2 the bundled `nxb 0.5.1` read the engine folder only from `--engine`. The launcher passes the engine as `NXB_ENGINE`. Every build with Settings, Use experimental builder stopped before its first stage. The app now bundles `nxbuild 0.6.2`, which reads `NXB_ENGINE` (#PRNUM)
+- **Experimental builder stopped at the rewrite (`patch_nso.py of the engine ... differs`)**: `nxb` checks the engine's code rewriter against the version its own rewriter was ported from. The 1.2.2 engine pin `88c7e03f51e3` changed `patch_nso.py` (Unreal dynamic buffers keep 4 copies) and `nso_match.py`. `nxb 0.6.1` refused every build with this engine. `nxb 0.6.2` is ported to it (#PRNUM)
+- **Extract stage label and bar**: with the experimental builder, the first stage showed the raw text "extract %@" and a bar with no value. `nxb 0.6.2` names the stage after its versions, for example `extract v0 + v327680`, and reports the bytes written. The bar fills and shows the time left. The launcher no longer shows a raw `%@` for a stage name without a part (#PRNUM)
+- **The launcher needs nxb 0.6.2 or newer**: an older `nxb` chosen in Settings now stops with the "too old" message before the build (#PRNUM)
+
+**Changed**
+- **Shaders in the experimental builder**: `nxb 0.6` translates the shaders with its own translator and no longer uses `spirv-cross` or the C# translator. The default build with the script is not changed (#PRNUM)
+
+**Known issues**
+- **Experimental builder (`nxb build`)**: no whole game has been built with `nxb 0.6.2` yet. Super Mario Bros. Wonder got through the extract stage. The iPhone and iPad path has not been run on a device (#749, #PRNUM)
+
+**Requires**
+- iOS or iPadOS 26 or later
+- To build NVN games on a Mac: Xcode 27.2 and macOS 26.6 or later
+
+## 中文
+
+**修复**
+- **实验性构建器立即停止(`--engine <engine folder> is required`)**:1.2.2 自带的 `nxb 0.5.1` 只从 `--engine` 读取引擎文件夹。启动器通过 `NXB_ENGINE` 传递引擎。开启「设置」里的「使用实验性构建器」后,每次构建都在第一个阶段之前停止。App 现在自带 `nxbuild 0.6.2`,它会读取 `NXB_ENGINE`(#PRNUM)
+- **实验性构建器在重写阶段停止(`patch_nso.py of the engine ... differs`)**:`nxb` 会把引擎的代码重写器和它移植时的版本做比对。1.2.2 的引擎固定点 `88c7e03f51e3` 修改了 `patch_nso.py`(Unreal 动态缓冲区保留 4 份副本)和 `nso_match.py`。`nxb 0.6.1` 因此拒绝了使用这个引擎的每次构建。`nxb 0.6.2` 已移植到这个引擎(#PRNUM)
+- **解包阶段的名称和进度条**:使用实验性构建器时,第一个阶段显示原始文本「extract %@」,进度条没有数值。`nxb 0.6.2` 用版本命名这个阶段,例如 `extract v0 + v327680`,并报告已写入的字节数。进度条会前进并显示剩余时间。阶段名称没有版本部分时,启动器不再显示原始的 `%@`(#PRNUM)
+- **启动器需要 nxb 0.6.2 或更新版本**:在设置里选择的旧版 `nxb` 现在会在构建之前以「版本过旧」的提示停止(#PRNUM)
+
+**变更**
+- **实验性构建器中的着色器**:`nxb 0.6` 用自己的转换器转换着色器,不再使用 `spirv-cross` 或 C# 转换器。使用脚本的默认构建没有变化(#PRNUM)
+
+**已知问题**
+- **实验性构建器(`nxb build`)**:还没有用 `nxb 0.6.2` 构建过完整的游戏。Super Mario Bros. Wonder 通过了解包阶段。iPhone 和 iPad 路径尚未在真机上运行过(#749、#PRNUM)
+
+**系统要求**
+- iOS 或 iPadOS 26 或更高版本
+- 在 Mac 上构建 NVN 游戏:Xcode 27.2 和 macOS 26.6 或更高版本