Skip to content

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

Release notes v1.2.1: add the changes merged since, Qt launcher and #757 known issues

v0lumehibe97e0f14fdc
diff --git a/CHANGELOG.md b/CHANGELOG.md
index bf4461b3..fdbf0640 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.1 | **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), reported by @xdgpx and @kianrafiee (#748, #721, #783). The compatibility switch for older iPhones and iPads writes the key the game reads and its environment file stays in the framework, 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 two shell and language-row tests are repaired, by @thehobbit85 (#690, #698, #722, #727, #728) |
+| 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. |
| 2026-11-02 | v1.0.2 | **Export as IPA, and the game data to a device or a drive** (#531, #416): the Install card of the Mac launcher has a switch with Install on device and Export as IPA. Export needs no device and no signing team. It builds the shared app with the frameworks of the games in the shell's library and writes an unsigned `NX2Apple.ipa` into the shell folder, for AltStore, SideStore or another tool you sign with. With the shared app, the game data is not in the IPA. Step 3 sends it to the app on a paired device or copies it to a drive or a folder, with progress and Stop. **What the IPA holds** (#542, #540): Export as IPA has a second choice. Shared app stays the default. One game, all inside makes one IPA per game with the game data in it, for tools that cannot copy data into an app. It has its own bundle ID, `org.nxnative.<title ID>`, so its saves are separate. It is built through the engine's one-game path. **Not tested end to end:** nobody has run an export on a real device or with a sideloaded app yet, and the one-game IPA was not checked with a sideloading tool either. A very large IPA can fail to install, and we do not know the size limit. See Known issues. **The Italian interface** (#528) by @Dino0005. The 38 texts of the export card, the texts of the new choice and the two new texts `shell.frameworkIncomplete` and `shell.gameLeftOut` are a machine translation for review. **A language is now one JSON file** (#478, #479, #480, #481): the Mac and the Windows launcher read the same files, the language list comes from them, and a test per front end checks every file. **The iPhone shell speaks the player's language** (#482, #485): its texts are lines of these files, and a game's settings rows show in the player's language. **A tap on a Recently played game starts it** (#457, #425), and the rows get more space. **The launcher's code moved into stores** (#456, #458, #460, #462, #466, #467, #469, #471, #473, #476, #530): no visible change. **Engine pin moves to `65501fbb`** (#536): New on the Mac by upstream's own notes, TRIANGLE STRATEGY, Castlevania: Belmont's Curse, SUPER ROBOT WARS Y, Splatoon Raiders, Super Mario RPG and Fire Emblem Fortune's Weave. The Mac settings window leaves the screen on Play. The NSP script decodes AV1 movies with dav1d and reads gzip-wrapped shader archives. Digimon's saves appear. We did not play any of it. We dropped the patches 0045 and 0052 because upstream took both changes. Upstream declined seedds/nxnative#492 (the runtime profile) and closed #755 and #839 for its own pointer hiding, so 0001, 0053, 0046 to 0050, 0032 and 0054 stay in the patch queue as fork-only. **Developer tooling:** `tools/bump_candidates.py` lists the upstream commits of a pin bump that the front ends depend on (#465). Fixes: a cut-off delete of a stale game framework no longer breaks the next build (#539). Quitting while the launcher removed one, about a minute on an external drive, left half a framework in the shared app folder, and the next build of another game failed at Prepare the shared app with "no readable game.manifest.json". Now the delete is a rename plus a background delete, mirror copies land only when complete, and an incomplete framework of another game is left out with a note that names the game and the missing file. Devices on Xcode 27.2 are found again, its `devicectl` changed the layout of the device list (#496, #488). The exFAT `._` files of a volume no longer break the Mac app pack, patch 0057 by @lucaszhongsj (#521, #486). Legacy PFS0 packages without the final name terminator are read, patch 0058, and the rewriter recognizes pointer tail calls before zero padding, patch 0059, both by @BadAppleD (#520, #519). Save to in the Build tab can create folders, by @SifatTaj (#522). **Known issues:** Export as IPA and Send game data are not tested on a real device or with a sideloaded app. One game, all inside is not verified with a sideloading tool, and a very large IPA can fail to install (the size limit is unknown). The first Play after the update rebuilds games, because the shader chain moved. The shader split can sit at 99% for several minutes at its end (#489). Breath of the Wild fills the disk (#413) and a Super Mario Odyssey shader step fails on an M1 with Xcode 27.2 (#361), both still open |
diff --git a/CHANGELOG.zh-CN.md b/CHANGELOG.zh-CN.md
index 374e0d98..1e2c2e30 100644
--- a/CHANGELOG.zh-CN.md
+++ b/CHANGELOG.zh-CN.md
@@ -6,7 +6,7 @@ NX2Apple 的版本历史,最新在上,每个版本的完整说明见[发布
| 日期 | 版本 | 变更 |
|---|---|---|
-| 2026-11-06 | v1.2.1 | **修复**:引擎能勘测游戏时,Mac 启动器可以构建没有配置的 Switch 2 NUP 或游戏文件夹,游戏本身还不能运行,需要上游的工作(seedds/nxnative#1299),由 @xdgpx 和 @kianrafiee 报告(#748、#721、#783)。老 iPhone 和 iPad 的兼容开关写入游戏读取的键,环境文件保留在框架里,作者 @thehobbit85(#719、#723)。构建进度和日志在多个启动器窗口之间保持,作者 @thehobbit85(#405、#724)。构建 Metal 归档时磁盘空间不足有了失败提示,作者 @thehobbit85(#463、#725)。env 文件里的 `DM_PSO_BUNDLE=off` 在 iPhone 和 iPad 上生效,作者 @thehobbit85(#726)。Tool tests 任务会报告引擎测试失败,并修复了两个壳 App 和语言行测试,作者 @thehobbit85(#690、#698、#722、#727、#728) |
+| 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。 |
| 2026-11-02 | v1.0.2 | **导出为 IPA,并把游戏数据发送到设备或磁盘**(#531、#416):Mac 启动器的安装卡片有一个开关,可选「安装到设备」或「导出为 IPA」。导出不需要设备,也不需要签名团队。它用壳 App 游戏库中各游戏的框架构建共用 App,并在壳目录里写出未签名的 `NX2Apple.ipa`,供 AltStore、SideStore 或你自己签名用的其他工具使用。使用共用 App 时,游戏数据不在 IPA 里。第 3 步把数据发送到已配对设备上的 App,或复制到磁盘或文件夹,带进度和停止按钮。**IPA 里放什么**(#542、#540):「导出为 IPA」多了一个选项。默认仍是「共用 App」。「一个游戏,全部在内」为每个游戏生成一个 IPA,游戏数据在里面,适用于无法向 App 复制数据的工具。它有自己的 Bundle ID `org.nxnative.<title ID>`,所以存档是独立的。它通过引擎的单游戏流程构建。**尚未端到端测试:** 还没有人在真机上或用侧载的 App 运行过导出,单游戏 IPA 也没有用侧载工具检查过。过大的 IPA 可能安装失败,大小上限未知。见已知问题。**意大利语界面**(#528),作者 @Dino0005。导出卡片的 38 条文字、新选项的文字以及两条新文字 `shell.frameworkIncomplete` 和 `shell.gameLeftOut` 是机器翻译,等待审校。**一种语言就是一个 JSON 文件**(#478、#479、#480、#481):Mac 和 Windows 启动器读取同一批文件,语言列表来自这些文件,每个前端各有一项测试检查每个文件。**iPhone 壳 App 使用玩家的语言**(#482、#485):它的文字是这些文件里的行,游戏的设置行也以玩家的语言显示。**点按「最近玩过」里的游戏会直接启动它**(#457、#425),行距也更宽松。**启动器的代码改为按 store 划分**(#456、#458、#460、#462、#466、#467、#469、#471、#473、#476、#530):外观无变化。**引擎固定点移到 `65501fbb`**(#536):出自上游的说明,Mac 上新增 TRIANGLE STRATEGY、Castlevania: Belmont's Curse、SUPER ROBOT WARS Y、Splatoon Raiders、Super Mario RPG 和 Fire Emblem Fortune's Weave。点按 Play 时 Mac 的设置窗口会离开屏幕。NSP 脚本用 dav1d 解码 AV1 视频,并能读取 gzip 包裹的着色器归档。Digimon 的存档会出现。我们没有玩过这些内容。补丁 0045 和 0052 已删除,因为上游采纳了这两项改动。上游拒绝了 seedds/nxnative#492(运行时配置),并以自己的指针隐藏关闭了 #755 和 #839,所以 0001、0053、0046 至 0050、0032 和 0054 作为仅限本 fork 的补丁留在补丁队列里。**开发工具:** `tools/bump_candidates.py` 列出升级固定点时上游提交中前端所依赖的部分(#465)。修复:中途中断删除过期的游戏框架,不再让下一次构建失败(#539)。启动器正在删除时退出(外置磁盘上约一分钟),会在共用 App 目录里留下半个框架,之后构建另一个游戏时会在「准备共用 App」一步失败,提示「no readable game.manifest.json」。现在删除改为重命名加后台删除,镜像副本完整后才落位,另一个游戏的不完整框架会被排除在外,并给出说明,写明游戏名和缺少的文件。Xcode 27.2 上的设备能再次被找到,它的 `devicectl` 改了设备列表的布局(#496、#488)。exFAT 卷上的 `._` 文件不再让 Mac 应用打包失败,补丁 0057,作者 @lucaszhongsj(#521、#486)。缺少文件名表结尾终止符的旧版 PFS0 包可以读取,补丁 0058,重写器能识别零填充之前的指针尾调用,补丁 0059,两者作者均为 @BadAppleD(#520、#519)。构建页的「保存到」对话框可以新建文件夹,作者 @SifatTaj(#522)。**已知问题:** 「导出为 IPA」和「发送游戏数据」尚未在真机上或用侧载的 App 测试。「一个游戏,全部在内」没有用侧载工具验证过,过大的 IPA 可能安装失败(大小上限未知)。更新后第一次点 Play 会重新构建游戏,因为着色器链变了。着色器拆分在最后可能在 99% 停留几分钟(#489)。《旷野之息》会占满磁盘(#413),M1 上用 Xcode 27.2 时《超级马力欧 奥德赛》的一个着色器步骤失败(#361),两者仍未解决 |
diff --git a/release-notes/v1.2.1.md b/release-notes/v1.2.1.md
index 1bf7c20b..91c92ec0 100644
--- a/release-notes/v1.2.1.md
+++ b/release-notes/v1.2.1.md
@@ -2,20 +2,30 @@
## English
+**New**
+- **Steam Controller (2026)**: games support the controller over USB-C, Bluetooth and the Puck, with buttons, sticks, rumble, motion and the trackpads. The launcher has per-game keyboard and button mappings and the Steam extras, and the mappings are shared with the in-game mapping panel. Macs need Input Monitoring for direct access, the README says how. Games you built before must be rebuilt to get it. It carries seedds/nxnative#221. Requested in #764. By @thehobbit85 (#764, #731)
+- **Why a game has no resolution setting**: when a game has no render scale row, the Launch options sheet shows a short note and names the closest settings, Console mode and Upscaling. Games with a render scale show no note. By @Haseenesss (#574, #754)
+
**Fixed**
-- **Games with no profile: NUP and game folder**: the Mac launcher no longer refuses a Switch 2 NUP or a game folder of a game the engine has no profile for, and the build button is there. When the engine can survey the game itself, the build starts from a provisional profile. An older engine keeps the old message. This only lets the build start. Such a game does not run yet. The first case is Ocarina of Time on Switch 2, and it needs engine work upstream (seedds/nxnative#1299). Reported by @xdgpx and @kianrafiee (#748, #721, #783)
+- **Games with no profile: NUP and game folder**: the Mac launcher no longer refuses a Switch 2 NUP or a game folder of a game the engine has no profile for, and the build button is there. When the engine can survey the game itself, the build starts from a provisional profile. An older engine keeps the old message. This only lets the build start. Such a game does not run yet. The first case is Ocarina of Time on Switch 2, and it needs engine work upstream (seedds/nxnative#1299). Reported by @xdgpx (#748, #783)
+- **Mac host build uses the selected Python**: a build run with the app's Python 3.13 could still start the host's shader generator with an old Python 3.6 from the `PATH`, and fail after extraction and shader compilation. The host build now gets the exact Python of the pipeline. Reported by @temmiegreen. By @thehobbit85 (#711, #729)
+- **Windows: the Python install chains into the venv**: on a PC with no Python, the step after installing Python looked for a file and got a folder, so creating the virtual environment failed until a second click. The launcher now finds `python.exe` in the install folder (#774)
+- **Italian iPhone and iPad shell texts**: 20 texts are reworded by a native speaker. By @zatteogit (#744)
+- **README requirements**: they say that Switch 2 games (a game folder or a `.nup` file) need no `prod.keys`. By @rivitt (#734)
- **Compatibility switch for older iPhones and iPads (A15, A16)**: the switch wrote a key the game never read, and the iOS build removed its environment file. Now it writes `DM_PROF_TEX_BC_CPU=1`, the game's framework keeps `dm/env.txt`, and the shell loads it after the player's own env files, so a file in Documents still wins. The check for a device without native BC textures reads the same setting. Reported by @Sword-Wen. By @thehobbit85 (#719, #723)
- **Build progress and log across launcher windows**: another or a reopened launcher window showed an idle Builds page while a build kept running. All windows now share the running build, its progress, its log and the Stop button. By @thehobbit85 (#405, #724). Reported by @sshuai001
- **Low disk space while building the Metal archive**: when the engine stops because the build volume is full, both launchers now show a failure row. It names the free space the engine asks for, and tells you to free space or pick a build folder on another drive. The text is in all six languages. Reported in #463. By @thehobbit85 (#725)
- **`DM_PSO_BUNDLE=off` on iPhone and iPad**: the shell ignored it in `Documents/env.txt` when a game or framework had a `pso/` folder. Now the launch settings, the game's env file and the shared env file win over the archive the shell finds by itself. The README says how to turn the archive off for one game. This does not fix the Metal crash on iPhone Air (A19 Pro, iOS 27.0) reported in #640. It only makes the switch usable. By @thehobbit85 (#726). Reported by @sheepyd (#640)
-- **Tests and CI**: the Tool tests job no longer stays green when an engine test file fails, and the tests it then showed are repaired (#690, #722). A shell test accepts the label `16:9 (Switch)` in German, Swedish, French and Italian (#727). The Mac and shell language-row tests now run the synced engine and check its own row, so a new pin cannot change it unseen. The test steps keep a failure when their output goes through `tee` (#698, #728). All three by @thehobbit85
+- **Tests and CI**: the Tool tests job no longer stays green when an engine test file fails, and the tests it then showed are repaired (#690, #722). A shell test accepts the label `16:9 (Switch)` in German, Swedish, French and Italian (#727) and `120 fps` in German, Swedish and Italian (#786). The Mac and shell language-row tests now run the synced engine and check its own row, so a new pin cannot change it unseen. The test steps keep a failure when their output goes through `tee` (#698, #728). #722, #727 and #728 are by @thehobbit85
**Known issues**
-- **Games with no profile do not run yet**: the launcher builds them, but a game such as Ocarina of Time on Switch 2 does not run yet. It needs upstream work (seedds/nxnative#1299). The build was not run with a real game or the real engine (#748, #721, #783)
-- **Preparing the shared app with a provisional profile**: reported in #757, the UI step that prepares the shared iPhone app can stop with "no game profile" for a game whose profile came from the survey. This release does not change that (#757)
+- **Games with no profile do not run yet**: the launcher builds them, but a game such as Ocarina of Time on Switch 2 does not run yet. It needs upstream work (seedds/nxnative#1299). The build was not run with a real game or the real engine (#748, #783)
+- **Qt launcher (Linux and Windows) still refuses games with no profile**: only the Mac launcher got the change. The Qt launcher keeps the profile check and shows the old message until a follow-up (#783)
+- **Preparing the shared iPhone app for a game with a provisional profile**: the Mac launcher does not tell the engine's `build_shell.sh` where the profile of the build lives (`DM_GAMES_DIR`), so the step can stop with "no game profile" for a game whose profile came from the survey. Setting `DM_GAMES_DIR` to the build's `profile/` folder is the workaround. Not fixed in this release (#757)
- **Older iPhones and iPads**: the switch was tested with synthetic checks only. Nobody tried it on an A15 or A16 device with a real game (#723)
- **Low disk space row**: checked with the engine's real messages and a synthetic failure. Nobody filled a disk to see it. The Qt launcher was not run (#725)
- **Build progress across windows**: tested with a synthetic build. Nobody closed and reopened a window during a real game build (#724)
+- **Steam Controller (2026)**: tested by the author only, over Bluetooth, the Puck and USB-C, in Pokémon Legends: Z-A and The Legend of Zelda: Tears of the Kingdom. Holding the middle Steam button opens the quit prompt, and that prompt uses the default Steam A and B layout and not a customized mapping. The new help texts are English in French, Italian and Swedish (#731)
- **Metal archive crash on iPhone Air**: the switch to turn the archive off works, and the crash itself is not understood (#640)
**Requires**
@@ -24,20 +34,30 @@
## 中文
+**新增**
+- **Steam Controller(2026)**:游戏支持这款手柄的 USB-C、蓝牙和 Puck 连接,含按键、摇杆、震动、体感和触控板。启动器提供每个游戏的键盘和按键映射以及 Steam 的额外选项,映射与游戏内的映射面板共用。Mac 需要开启输入监控才能直接访问,README 里有说明。之前构建的游戏必须重新构建才能使用。内容来自 seedds/nxnative#221。需求见 #764。作者 @thehobbit85(#764、#731)
+- **游戏为什么没有分辨率设置**:游戏没有渲染比例一行时,启动选项面板会显示一条简短说明,并指出最接近的设置:主机模式和放大。有渲染比例的游戏不显示说明。作者 @Haseenesss(#574、#754)
+
**修复**
-- **没有配置的游戏:NUP 和游戏文件夹**:Mac 启动器不再拒绝引擎没有配置的 Switch 2 NUP 或游戏文件夹,构建按钮会显示。引擎能自己勘测游戏时,构建从临时配置开始。旧版引擎仍显示原来的提示。这只是让构建可以开始,这样的游戏现在还不能运行。第一个例子是 Switch 2 上的 Ocarina of Time,它需要上游的引擎工作(seedds/nxnative#1299)。由 @xdgpx 和 @kianrafiee 报告(#748、#721、#783)
+- **没有配置的游戏:NUP 和游戏文件夹**:Mac 启动器不再拒绝引擎没有配置的 Switch 2 NUP 或游戏文件夹,构建按钮会显示。引擎能自己勘测游戏时,构建从临时配置开始。旧版引擎仍显示原来的提示。这只是让构建可以开始,这样的游戏现在还不能运行。第一个例子是 Switch 2 上的 Ocarina of Time,它需要上游的引擎工作(seedds/nxnative#1299)。由 @xdgpx 报告(#748、#783)
+- **Mac 宿主构建使用所选的 Python**:用 App 自带的 Python 3.13 构建时,宿主的着色器生成器仍可能被 `PATH` 里的旧 Python 3.6 启动,在解包和着色器编译完成之后失败。现在宿主构建使用流水线实际使用的 Python。由 @temmiegreen 报告。作者 @thehobbit85(#711、#729)
+- **Windows:安装 Python 后接着创建虚拟环境**:在没有 Python 的电脑上,安装 Python 之后的步骤把文件夹当成文件查找,导致创建虚拟环境失败,要再点一次才行。现在启动器会在安装文件夹里找到 `python.exe`(#774)
+- **意大利语的 iPhone 和 iPad 壳 App 文字**:20 条文字由母语者改写。作者 @zatteogit(#744)
+- **README 的系统要求**:说明 Switch 2 游戏(游戏文件夹或 `.nup` 文件)不需要 `prod.keys`。作者 @rivitt(#734)
- **老 iPhone 和 iPad(A15、A16)的兼容开关**:开关写入的键游戏从不读取,iOS 构建还会删除它的环境文件。现在它写入 `DM_PROF_TEX_BC_CPU=1`,游戏的框架保留 `dm/env.txt`,壳 App 在玩家自己的 env 文件之后加载它,所以 Documents 里的文件仍然优先。对不支持原生 BC 纹理的设备的检查读取同一个设置。由 @Sword-Wen 报告。作者 @thehobbit85(#719、#723)
- **多个启动器窗口之间的构建进度和日志**:另开或重开的启动器窗口会显示空闲的构建页,而构建仍在运行。现在所有窗口共用正在运行的构建、进度、日志和停止按钮。作者 @thehobbit85(#405、#724)。由 @sshuai001 报告
- **构建 Metal 归档时磁盘空间不足**:引擎因构建磁盘已满而停止时,两个启动器现在都显示失败提示,写明引擎要求的空闲空间,并建议腾出空间或选另一块磁盘上的构建文件夹。文字有六种语言。在 #463 里报告。作者 @thehobbit85(#725)
- **iPhone 和 iPad 上的 `DM_PSO_BUNDLE=off`**:游戏或框架有 `pso/` 文件夹时,壳 App 会忽略 `Documents/env.txt` 里的它。现在启动设置、游戏自己的 env 文件和共用 env 文件优先于壳 App 自己找到的归档。README 说明了如何为单个游戏关闭归档。这并没有修复 #640 报告的 iPhone Air(A19 Pro,iOS 27.0)上的 Metal 崩溃,只是让这个开关可用。作者 @thehobbit85(#726)。由 @sheepyd 报告(#640)
-- **测试和 CI**:Tool tests 任务在引擎测试文件失败时不再显示成功,并修复了因此暴露的测试(#690、#722)。壳 App 的一个测试接受德语、瑞典语、法语和意大利语里的 `16:9 (Switch)` 标签(#727)。Mac 和壳 App 的语言行测试现在会运行已同步的引擎并检查它自己的行,新的引擎版本不会再悄悄改变它。测试步骤的输出经过 `tee` 时也会保留失败(#698、#728)。三项都由 @thehobbit85 完成
+- **测试和 CI**:Tool tests 任务在引擎测试文件失败时不再显示成功,并修复了因此暴露的测试(#690、#722)。壳 App 的一个测试接受德语、瑞典语、法语和意大利语里的 `16:9 (Switch)` 标签(#727),以及德语、瑞典语和意大利语里的 `120 fps`(#786)。Mac 和壳 App 的语言行测试现在会运行已同步的引擎并检查它自己的行,新的引擎版本不会再悄悄改变它。测试步骤的输出经过 `tee` 时也会保留失败(#698、#728)。#722、#727 和 #728 由 @thehobbit85 完成
**已知问题**
-- **没有配置的游戏还不能运行**:启动器能构建它们,但像 Switch 2 上的 Ocarina of Time 这样的游戏还不能运行,需要上游的工作(seedds/nxnative#1299)。构建没有用真实游戏或真实引擎运行过(#748、#721、#783)
-- **用临时配置准备共用 App**:在 #757 里报告,对配置来自勘测的游戏,准备共用 iPhone App 的界面步骤可能以「no game profile」停止。本版本没有改变这一点(#757)
+- **没有配置的游戏还不能运行**:启动器能构建它们,但像 Switch 2 上的 Ocarina of Time 这样的游戏还不能运行,需要上游的工作(seedds/nxnative#1299)。构建没有用真实游戏或真实引擎运行过(#748、#783)
+- **Qt 启动器(Linux 和 Windows)仍然拒绝没有配置的游戏**:只有 Mac 启动器改了。Qt 启动器保留配置检查,在后续改动之前仍显示旧提示(#783)
+- **为配置来自勘测的游戏准备共用 iPhone App**:Mac 启动器没有告诉引擎的 `build_shell.sh` 这次构建的配置在哪里(`DM_GAMES_DIR`),所以这一步可能以「no game profile」停止。临时办法是把 `DM_GAMES_DIR` 设为构建的 `profile/` 文件夹。本版本没有修复(#757)
- **老 iPhone 和 iPad**:这个开关只用合成检查测试过,没有人在 A15 或 A16 设备上用真实游戏试过(#723)
- **磁盘空间不足的提示**:用引擎的真实消息和合成故障检查过,没有人真的写满磁盘去看它。Qt 启动器没有运行过(#725)
- **窗口之间的构建进度**:用合成构建测试过,没有人在真实游戏构建期间关闭并重开窗口(#724)
+- **Steam Controller(2026)**:只有作者测试过,在 Pokémon Legends: Z-A 和 The Legend of Zelda: Tears of the Kingdom 里用蓝牙、Puck 和 USB-C 连接。按住 Steam 中间键会打开退出提示,这个提示使用默认的 Steam A 和 B 布局,而不是自定义映射。新的帮助文字在法语、意大利语和瑞典语里是英文(#731)
- **iPhone Air 上的 Metal 归档崩溃**:关闭归档的开关可用,崩溃本身的原因还不清楚(#640)
**系统要求**