Play your own Switch games on iPhone/iPad — one-click macOS app, no terminal. | 把 Switch 游戏装进 iPhone:图形界面一键构建,不用命令行。Bring your own game.
Swift apple-siliconcustom-formathomebrewiosipaipadipadosiphonemetalnative-portnintendo-switchnxnativeromfsswitch-games
Release notes v1.2.2: add the changes merged since rc3
v0lumehi442bf96f4ed3
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 283ebfcb..ccd6a470 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -6,7 +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.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). **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). 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) |+| 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). **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). 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) || 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) || 2026-11-03 | v1.1.0 | **Switch 2 games in the launcher** (#603, #604, #605, #606, #607, #608, #609, #610): the Mac and the Windows launcher take a Switch 2 game folder or a `.nup` file, with no `prod.keys`. Games get a Switch 2 mark and a note for the chosen target, the build stages have names in every language, and a failure row says when the keys are older than the game. Nobody has played one through the launcher yet. **Touch controls** (#582, #581, #580, #600): a size setting, a left stick place, a hint for the right stick of the 3D layout, and an editor in the shell settings that moves each control. **Quit and delete**: hold the controller's Home button for 2 seconds to quit a Mac game on macOS 27 (#579). On iPhone and iPad, the gear menu in the game or a Home hold quits, and the app closes and opens on the library (#601). Delete a game from the launcher, with its saves kept unless chosen (#562). **Also new**: Cloud saves folder in the Mac launcher (#561), Start in console mode (#565), controller button mapping on iPhone and iPad by @Haseenesss (#495, #576), picture Fill or Fit (#575), iPhone Duo layouts by @jonochocki (#230), per-game mods and env.txt (#573, #566), moving the cache folder (#584, #567), the Finder way to send game data (#586), a clearer framework error (#568). **Engine pin** `641d1480021a` (#598): new Switch 2 and other games, by upstream's notes, not played by us. **Fixed**: NSPs without a title ID in the file name by @Haseenesss (#548), the Duo outer screen row (#563), the Windows IPA handoff by @tmrsm (#182), the Windows first sync (#597, #602). **Docs**: README in German, Swedish and French (#569), Italian documents by @PikaMan80 (#527), Italian texts reviewed by @Dino0005 (#541, #570). Requires macOS 27 for the Home quit. |diff --git a/CHANGELOG.zh-CN.md b/CHANGELOG.zh-CN.mdindex 1b0f0326..12087ee6 100644--- a/CHANGELOG.zh-CN.md+++ b/CHANGELOG.zh-CN.md@@ -6,7 +6,7 @@ NX2Apple 的版本历史,最新在上,每个版本的完整说明见[发布| 日期 | 版本 | 变更 ||---|---|---|-| 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)。**修复**:引擎把 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)。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) |+| 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)。**修复**:引擎把 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)。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) || 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) || 2026-11-03 | v1.1.0 | **启动器里的 Switch 2 游戏**(#603、#604、#605、#606、#607、#608、#609、#610):Mac 和 Windows 启动器可以选择 Switch 2 游戏文件夹或 `.nup` 文件,不需要 `prod.keys`。游戏带 Switch 2 标记和按目标显示的说明,构建阶段的名称有所有语言的版本,密钥比游戏旧时有专门的失败提示。还没有人通过启动器玩过。**触控按键**(#582、#581、#580、#600):大小设置、左摇杆位置、3D 布局右摇杆的提示,以及壳 App 设置里移动每个按键的编辑器。**退出和删除**:在 macOS 27 上按住手柄 Home 键 2 秒退出 Mac 游戏(#579)。在 iPhone 和 iPad 上,从游戏内齿轮菜单或按住 Home 退出,App 会关闭并在下次回到游戏库(#601)。在启动器里删除游戏,除非选择一并删除,否则存档保留(#562)。**其他新增**:Mac 启动器的云存档文件夹(#561)、启动时进入主机模式(#565)、iPhone 和 iPad 的手柄按键映射,作者 @Haseenesss(#495、#576)、画面填充或适应(#575)、iPhone Duo 布局,作者 @jonochocki(#230)、每个游戏的 mod 和 env.txt(#573、#566)、移动缓存文件夹(#584、#567)、用 Finder 发送游戏数据(#586)、更清楚的框架错误(#568)。**引擎固定点** `641d1480021a`(#598):新增 Switch 2 等游戏,出自上游的说明,我们没有玩过。**修复**:文件名里没有 title ID 的 NSP,作者 @Haseenesss(#548)、Duo 外屏的游戏行(#563)、Windows 的 IPA 交接,作者 @tmrsm(#182)、Windows 首次同步(#597、#602)。**文档**:德语、瑞典语和法语 README(#569)、意大利语文档,作者 @PikaMan80(#527)、由 @Dino0005 审校的意大利语文字(#541、#570)。用 Home 键退出需要 macOS 27。 |diff --git a/release-notes/v1.2.2.md b/release-notes/v1.2.2.mdindex f5825489..4fb41de6 100644--- a/release-notes/v1.2.2.md+++ b/release-notes/v1.2.2.md@@ -5,6 +5,7 @@**New**- **Experimental builder runs `nxb build` end to end**: when Settings, Use experimental builder is turned on, the Mac launcher now runs `nxb build` for the whole game build and does not run the Python build script at all, for a Mac app and for the iPhone and iPad options. It reads NSP, NSZ, XCI, merged packages, a Switch 2 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. The app bundles `nxbuild 0.5.1`. The setting is off by default and nothing changes for a default build (#749, #794)- **Controller texts in French, Italian and Swedish**: 26 controller and Steam Controller (2026) strings are now translated into French, Italian and Swedish, waiting for a native review. By @v0lumehi (#789)+- **Guide: updating a built Mac game**: the English and Chinese player guides now walk through **Rebuild**, the update picker and the existing output folder, say which work the build can reuse, and explain why the same title keeps its saves. This documents the current workflow and is not an in-place updater. Asked in #796. By @thehobbit85 (#796, #805)**Fixed**- **iPhone and iPad shared app build (`FAIL: copy the shader libraries`)**: since the 1.2.0 engine pin `7249ee9f95ed`, an NVN game's iOS shader library is packed into the single file `shader/ios/b-<chain>.img` and the folder `b-<chain>/` is removed. The framework build step for the shared iPhone and iPad app still looked for the folder, so every NVN game build for the shared shell stopped at `rsync: .../shader/ios/b-223f10d34f97/: (l)stat: No such file or directory` and `FAIL: copy the shader libraries`. It now copies `b-<chain>.img` into the game framework's `msl/` folder, where the host loads it. Reported by @zhukangyu26-stack, @tnt739660506-prog and @caixukun1919810114514. By @xiaofeng-han (#781, #795, #800, #782)@@ -12,10 +13,15 @@- **Windows game folder build (`FileNotFoundError: [WinError 2]` at `pack v...`)**: `pack_dump.py` tried `cp -c` for an APFS clone before falling back to `shutil.copy2`, which raised `FileNotFoundError` on Windows where `cp` does not exist. The Windows driver and shim now copy directly without spawning `cp` or `xattr` (#803)- **Windows shader split on 32+ thread CPUs (`ValueError: max_workers must be <= 61`)**: the Windows build environment and `ProcessPoolExecutor` now cap worker count at 61, CPython's `WaitForMultipleObjects` limit on Windows (#803)- **Windows iOS shader build in Chinese or non-ASCII folders (`no iOS shader libraries`)**: Apple's Windows `metal.exe` and `metallib.exe` fail to open paths containing non-ASCII characters or spaces. The Windows `xcrun` shim and shader cache/PCH helpers now stage non-ASCII inputs and outputs through a pure-ASCII temporary folder (#810)+- **Shader split sitting at 99%**: the Mac launcher's build activity bar can stay at 99% for several minutes while the last batch of shader files is scanned. When the engine reports 1 to 16 files left in the splitting step, the bar now says that scanning the last few files can take several minutes, in all six languages. The scan time itself is not changed. By @thehobbit85 (#489, #806)+- **iPhone data transfer skipped for an updated game with the same size**: the Mac launcher could say an iPhone already held the game data when an update produced a different `romfs.img` of exactly the same size. It now compares the RomFS identity (size, a hash of the header and index, and the framework version and build) with a receipt of the last successful copy for that title, device and app container, and copies the image when the receipt is missing or different. The receipt only knows this Mac's copies, and a change confined to payload bytes under the same version and index is not seen. The prompt text about the version change from #261 stays open. By @thehobbit85 (#261, #807)+- **Qt launcher tests on macOS's Python 3.9**: the pre-push check failed nine tests with the system Python 3.9.6. The Windows shim installer used a Python 3.10-only keyword and now writes the exact UTF-8 bytes, keeps timestamps on a second install, and four Qt-free tests call the underlying function. The README now says Python 3.9 or later for the launcher and its tests, and 3.12 or later for the game build scripts. Reported by @Koshindai. By @thehobbit85 (#799, #804)- **Windows first-run setup assistant**: opening the Windows launcher for the first time now presents the guided setup dialog automatically once dependency detection finishes (#803)**Known issues**- **Experimental builder (`nxb build`)**: the iPhone and iPad path and the new input kinds have not yet been run on a device with real game files (#749, #794)+- **Shader split hint and iPhone data receipt**: both were checked with synthetic progress events and a synthetic device container on an Apple Silicon Mac, not with a real game build or a real iPhone (#806, #807)+- **Qt shim installer**: the fix was tested on macOS with Python 3.9.6 and 3.14.6, and the Windows execution was not run (#804)**Requires**- iOS or iPadOS 26 or later@@ -26,6 +32,7 @@**新增**- **实验性构建器全程运行 `nxb build`**:开启设置里的「使用实验性构建器」后,Mac 启动器现在直接运行 `nxb build` 完成整个游戏构建,完全不运行 Python 构建脚本,Mac App 和 iPhone、iPad 选项都是如此。它读取 NSP、NSZ、XCI、合并包、Switch 2 NUP、游戏文件夹和 DLC,并勘测没有配置的游戏。不会退回脚本:`nxb` 不支持的情况或失败时,会显示 `nxb` 的退出代码和最后一条错误。App 内置 `nxbuild 0.5.1`。该设置默认关闭,默认构建不受影响(#749、#794)- **法语、意大利语和瑞典语手柄设置本地化**:补齐 26 条手柄设置与 Steam Controller(2026)的法语、意大利语和瑞典语翻译,等待母语者审校。作者 @v0lumehi(#789)+- **指南:更新已构建的 Mac 游戏**:中英文玩家指南现在逐步说明「重新构建」、更新包选择和已有的输出文件夹,指出构建可以复用哪些工作,并解释为什么同一游戏的存档会保留。这记录的是现有流程,不是原地更新功能。需求见 #796。作者 @thehobbit85(#796、#805)**修复**- **iPhone 和 iPad 共用壳 App 构建(`FAIL: copy the shader libraries`)**:从 1.2.0 的引擎版本 `7249ee9f95ed` 起,NVN 游戏的 iOS 着色器库会被打包成单个文件 `shader/ios/b-<chain>.img` 并删除原文件夹 `b-<chain>/`。共用 iPhone 和 iPad 壳 App 的框架构建步骤仍在查找原文件夹,导致所有 NVN 游戏的共用壳构建都在最后停在 `rsync: .../shader/ios/b-223f10d34f97/: (l)stat: No such file or directory` 和 `FAIL: copy the shader libraries`。现在它会把 `b-<chain>.img` 复制进游戏框架的 `msl/` 目录供宿主直接读取。由 @zhukangyu26-stack、@tnt739660506-prog 和 @caixukun1919810114514 报告。作者 @xiaofeng-han(#781、#795、#800、#782)@@ -33,10 +40,15 @@- **Windows 游戏文件夹构建(`pack v...` 阶段报 `FileNotFoundError: [WinError 2]`)**:`pack_dump.py` 在回退到 `shutil.copy2` 前会先尝试运行 `cp -c` 做 APFS 克隆,而在没有 `cp` 命令的 Windows 上直接抛出了 `FileNotFoundError`。现在 Windows 驱动和垫片层直接复制文件,不再调用 `cp` 或 `xattr`(#803)- **Windows 32 线程及以上 CPU 在 `shader split` 阶段报 `ValueError: max_workers must be <= 61`**:Windows 构建环境与 `ProcessPoolExecutor` 现在将工作进程数上限封顶在 61(Windows 版 Python `WaitForMultipleObjects` 的硬上限)(#803)- **Windows 中文或非 ASCII 目录构建 iOS 着色器失败(`no iOS shader libraries`)**:苹果 Windows 版 `metal.exe` 与 `metallib.exe` 无法打开含中文或空格的路径。现在 Windows `xcrun` 垫片及着色器预编译头/编译缓存会自动通过纯 ASCII 临时目录暂存并回写输入输出文件(#810)+- **着色器拆分停在 99%**:Mac 启动器的构建活动条在扫描最后一批着色器文件时可能停在 99% 数分钟。当引擎报告拆分步骤还剩 1 到 16 个文件时,活动条现在会提示扫描最后几个文件可能需要几分钟,六种语言都有。扫描时间本身没有变。作者 @thehobbit85(#489、#806)+- **更新后大小相同的游戏被跳过 iPhone 数据传输**:更新生成了大小完全相同但内容不同的 `romfs.img` 时,Mac 启动器可能误判 iPhone 已有游戏数据。现在它会比较 RomFS 标识(大小、头部与索引的哈希、框架版本和构建号)与该游戏、设备和 App 容器上次成功复制的回执,回执缺失或不同就复制镜像。回执只记录这台 Mac 的复制,只改动数据内容而版本和索引不变的变化看不到。#261 中提示框要说明版本变化的需求仍未完成。作者 @thehobbit85(#261、#807)+- **Qt 启动器测试在 macOS 自带的 Python 3.9 上失败**:推送前检查在系统 Python 3.9.6 上有九个测试失败。Windows 垫片安装器用了只有 Python 3.10 才有的参数,现在改为写入精确的 UTF-8 字节,第二次安装保留时间戳,四个不依赖 Qt 的测试改为调用底层函数。README 现在写明启动器及其测试需要 Python 3.9 或更高,游戏构建脚本需要 3.12 或更高。由 @Koshindai 报告,作者 @thehobbit85(#799、#804)- **Windows 首次启动设置向导**:全新首次打开 Windows 启动器时,依赖检测完成后会自动弹出引导式设置向导(#803)**已知问题**- **实验性构建器(`nxb build`)**:iPhone 和 iPad 路径以及真实游戏文件的新输入类型尚未在真机上运行过(#749、#794)+- **着色器拆分提示和 iPhone 数据回执**:两者只在 Apple 芯片 Mac 上用模拟的进度事件和模拟的设备容器检查过,没有用真实的游戏构建或真实的 iPhone(#806、#807)+- **Qt 垫片安装器**:修复在 macOS 上用 Python 3.9.6 和 3.14.6 测试过,没有在 Windows 上运行(#804)**系统要求**- iOS 或 iPadOS 26 或更高版本