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
v1.0.2 notes: one IPA per game with its data inside (#542) and the cut-off framework delete fix (#539)
v0lumehi1c1f6406ff13
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 0c3505d1..6ea81169 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-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. 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. **Not tested end to end:** nobody has run it on a real device or with a sideloaded app yet, see Known issues. **The Italian interface** (#528) by @Dino0005. The 38 texts of the export card 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: 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. 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 |+| 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. 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 || 2026-11-01 | v1.0.1 | **The shell finds each game by its image** (#441, #443): the shared game-data folder on the iPhone or iPad no longer needs one folder per game. Each game is matched by the identity of its `romfs.img`, up to two levels below the chosen folder, whatever the folders are called. **Upstream moves to `cd859c38`** (#444): the engine alone can now do these things, by upstream's own notes and not checked in the launcher: Donkey Kong Bananza (Switch 2, tested through the first level, Mac only) and Hollow Knight play, Dead Cells has a profile, and a game builds from a folder of its files without `prod.keys`. The launcher does not build Switch 2 games or games from a folder of files yet, see #445. Shift plus an arrow key moves the right stick on the Mac. **NVN games need Xcode 27.2** (#447, #444): the new engine locks the Metal compiler of Xcode 27.2, and the launcher says so. On Xcode 27.1, update Xcode before building a game. Fixes: the several-games failure message of the new engine is still recognized (#444) || 2026-10-31 | v1.0.0 | **The engine comes from the release** (#267): the release app keeps its engine in its own store and builds from it. It no longer clones or pulls the repository. Settings shows the engine with a Check button, the Stable and Experimental channels and an automatic update switch. A channel switch asks first. The engine arrives with a signed `latest.json`, and the app installs nothing that fails the check. **One shell app for iPhone and iPad** (#226): the app holds all your games, with an art-led library, Cover Flow when the screen is on its side, settings for each game and controller or keyboard navigation. The iPhone / iPad target builds a game into the shell. Re-signs and reinstalls keep the game data and saves. **Launcher roundup** (#281): the library switches between Owned and Built, a slider that differs from its tested default gets a reset arrow, a new release shows as an icon at the end of the top bar, the Dock mirrors a running build, and console mode lists the games ready on this Mac first. Settings gets an uninstaller that removes the launcher's settings and engine trees. Games, saves and keys stay, and the app goes to the Trash. **The Mac icon uses Liquid Glass** (#290). **The Qt front end takes the Mac launcher's palette and Manrope font** (#222). **Upstream moves to `c5fe6b5d`** (#319): Metal 4 pipeline specialization, shared host shaders compiled during the build, parallel rewriter scans, and fixes for NVN buffer offsets, attachment capacity and depth/stencil pairing. Upstream's own fullscreen fix replaces ours. **Release candidates** (#332): a release is tested as a candidate first, so players get the exact build that was tested. Fixes: the iPhone cloud-save folder picker opens once per tap and Open stores the folder (#321), Tears of the Kingdom 1.4.2 no longer runs at double speed (#311, #312), Mario Tennis Aces gets past the rewrite step (#307) and past the crash after the shared fonts load (#314), iOS DLC in `Documents/aoc` is found (#319), the Windows toolchain checks name their fix for the link probe, SDK stubs, Metal and Git installs and pinned wheels (#206), console mode hides an idle pointer and asks again for full screen after a game (#339), a failed engine sync puts `engine/` back as it was (#338), a patch that does not apply is no longer taken for one that upstream already has (#323) || 2026-10-31 | v0.7.5 | **Xcode 27.2 no longer stops game builds**: Xcode's auto-update raised the Metal compiler to 32023.922 and NVN games stopped before the shader steps. A newer compiler of the recorded generation now builds on with a note in the log. Older or cross-generation compilers still warn. **On 0.7.3 or older? Update now.** Older apps cannot build games any more and show "Repository: not found". Install this version and building works again. Games and saves are kept (details in discussion #306) |diff --git a/CHANGELOG.zh-CN.md b/CHANGELOG.zh-CN.mdindex 51c378b4..bd014d41 100644--- a/CHANGELOG.zh-CN.md+++ b/CHANGELOG.zh-CN.md@@ -6,7 +6,7 @@ NX2Apple 的版本历史,最新在上,每个版本的完整说明见[发布| 日期 | 版本 | 变更 ||---|---|---|-| 2026-11-02 | v1.0.2 | **导出为 IPA,并把游戏数据发送到设备或磁盘**(#531、#416):Mac 启动器的安装卡片有一个开关,可选「安装到设备」或「导出为 IPA」。导出不需要设备,也不需要签名团队。它用壳 App 游戏库中各游戏的框架构建共用 App,并在壳目录里写出未签名的 `NX2Apple.ipa`,供 AltStore、SideStore 或你自己签名用的其他工具使用。游戏数据不在 IPA 里。第 3 步把数据发送到已配对设备上的 App,或复制到磁盘或文件夹,带进度和停止按钮。**尚未端到端测试:** 还没有人在真机上或用侧载的 App 运行过,见已知问题。**意大利语界面**(#528),作者 @Dino0005。导出卡片的 38 条文字是机器翻译,等待审校。**一种语言就是一个 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)。修复:Xcode 27.2 上的设备能再次被找到,它的 `devicectl` 改了设备列表的布局(#496、#488)。exFAT 卷上的 `._` 文件不再让 Mac 应用打包失败,补丁 0057,作者 @lucaszhongsj(#521、#486)。缺少文件名表结尾终止符的旧版 PFS0 包可以读取,补丁 0058,重写器能识别零填充之前的指针尾调用,补丁 0059,两者作者均为 @BadAppleD(#520、#519)。构建页的「保存到」对话框可以新建文件夹,作者 @SifatTaj(#522)。**已知问题:** 「导出为 IPA」和「发送游戏数据」尚未在真机上或用侧载的 App 测试。更新后第一次点 Play 会重新构建游戏,因为着色器链变了。着色器拆分在最后可能在 99% 停留几分钟(#489)。《旷野之息》会占满磁盘(#413),M1 上用 Xcode 27.2 时《超级马力欧 奥德赛》的一个着色器步骤失败(#361),两者仍未解决 |+| 2026-11-02 | v1.0.2 | **导出为 IPA,并把游戏数据发送到设备或磁盘**(#531、#416):Mac 启动器的安装卡片有一个开关,可选「安装到设备」或「导出为 IPA」。导出不需要设备,也不需要签名团队。它用壳 App 游戏库中各游戏的框架构建共用 App,并在壳目录里写出未签名的 `NX2Apple.ipa`,供 AltStore、SideStore 或你自己签名用的其他工具使用。游戏数据不在 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),两者仍未解决 || 2026-11-01 | v1.0.1 | **壳 App 按镜像本身找到每个游戏**(#441、#443):iPhone 或 iPad 上共用的游戏数据文件夹不再要求每个游戏一个文件夹。每个游戏按它的 `romfs.img` 的标识匹配,在所选文件夹下两层以内查找,文件夹叫什么都可以。**同步上游到 `cd859c38`**(#444):仅引擎本身现在能做到下面这些,出自上游的说明,我们没有在启动器里验证过:Donkey Kong Bananza(Switch 2,只测试到第一关,仅 Mac)和 Hollow Knight 可以运行,Dead Cells 有了配置,游戏可从装有其文件的文件夹构建,不再需要 `prod.keys`。启动器目前还不能构建 Switch 2 游戏,也不能从文件夹构建,见 #445。Mac 上按 Shift 加方向键可操作右摇杆。**NVN 游戏需要 Xcode 27.2**(#447、#444):新引擎锁定了 Xcode 27.2 的 Metal 编译器,启动器会提示这一点。使用 Xcode 27.1 的玩家,构建游戏前请先更新 Xcode。修复:新引擎的「文件夹里有多个游戏」失败提示仍能被识别(#444) || 2026-10-31 | v1.0.0 | **引擎随发布版提供**(#267):发布版 App 把引擎放在自己的引擎仓里,并从中构建,不再克隆或拉取仓库。设置里显示引擎,有「检查」按钮、稳定版和实验版两个通道和自动更新开关。切换通道前会先询问。引擎附带签名的 `latest.json`,校验不通过就什么也不安装。**iPhone 和 iPad 共用一个壳 App**(#226):一个 App 装下你所有的游戏,有以图为主的游戏库、横屏时的 Cover Flow、每个游戏自己的设置,以及手柄和键盘操作。iPhone / iPad 目标把游戏构建进壳 App,重签和重装都保留游戏数据和存档。**启动器综合更新**(#281):游戏库可在「已拥有」和「已构建」之间切换,滑块偏离测试过的默认值时出现重置箭头,新版本以顶栏末尾的一个图标显示,Dock 图标显示正在运行的构建进度,主机模式先列出这台 Mac 能玩的游戏。设置里新增卸载功能,删除启动器的设置和引擎副本。游戏、存档和密钥保留,App 移到废纸篓。**Mac 图标改用 Liquid Glass**(#290)。**Qt 前端采用 Mac 启动器的配色和 Manrope 字体**(#222)。**同步上游到 `c5fe6b5d`**(#319):Metal 4 管线特化、共享主机着色器在构建时编译、rewriter 扫描并行,并修复 NVN 缓冲区偏移与大小、附件容量和深度/模板配对。上游自己的全屏修复取代了我们的补丁。**发布候选版**(#332):每个版本先作为候选版测试,玩家拿到的就是测试过的那个构建。修复:iPhone 云存档文件夹选择器每次点击只弹一次,点「打开」会保存文件夹(#321)、《塞尔达传说 王国之泪》1.4.2 不再两倍速运行(#311、#312)、《马力欧网球 ACE》通过 rewrite 步骤(#307),并修复共享字体加载后的崩溃(#314)、能找到 `Documents/aoc` 里的 iOS DLC(#319)、Windows 工具链检查写明修复办法,涉及链接探针、SDK 存根、Metal 与 Git 安装和锁定版本的 wheel(#206)、主机模式在鼠标静止时隐藏指针,并在游戏结束后再次请求全屏(#339)、引擎同步失败后 `engine/` 恢复原状(#338)、未能应用的补丁不再被误认为上游已有(#323) || 2026-10-31 | v0.7.5 | **Xcode 27.2 不再拦住游戏构建**:Xcode 自动更新把 Metal 编译器升到 32023.922 后,NVN 游戏会在着色器步骤前停下。现在同一代里更新的编译器会放行,构建正常完成,日志里留一条说明。更旧或跨代的编译器仍会提示。**App 版本是 0.7.3 或更早?请立即更新。** 旧版 App 已经无法构建游戏,会提示 "Repository: not found"。安装这个版本后就能正常构建,游戏和存档都会保留(详见讨论 #306) |diff --git a/release-notes/v1.0.2.md b/release-notes/v1.0.2.mdindex 97ce6940..b430e6f3 100644--- a/release-notes/v1.0.2.md+++ b/release-notes/v1.0.2.md@@ -10,10 +10,11 @@- The Install card of the Mac launcher has a switch: Install on device or Export as IPA- Export needs no device and no signing team. It writes an unsigned `NX2Apple.ipa` into the shell folder, for AltStore, SideStore or another tool you sign with- 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-- Not tested end to end yet, see Known issues (#531, #416)+- **What the IPA holds**: Export as IPA has a choice. Shared app is 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 (#542, #540)+- Not tested end to end yet, see Known issues (#531, #416, #542)**New**-- **Italian interface**: the launcher and the iPhone shell speak Italian, by @Dino0005. The 38 texts of the export card are a machine translation and wait for review (#528, #536)+- **Italian interface**: the launcher and the iPhone shell speak Italian, by @Dino0005. The 38 texts of the export card, the texts of the new IPA choice and the two new texts `shell.frameworkIncomplete` and `shell.gameLeftOut` are a machine translation and wait for review (#528, #536, #539, #542)- **A language is one JSON file**: the Mac and the Windows launcher read the same language files, the language list comes from them, and a test per front end checks every file (#478, #479, #480, #481)- **The iPhone shell speaks your language**: its texts are lines of these files, and a game's settings rows show in your language (#482, #485, #429)- **Recently played starts the game**: a tap on a game under Recently played starts it, and the rows get more space (#457, #425)@@ -22,6 +23,7 @@- **Behind the scenes**: the launcher's code moved into stores, with no visible change (#456, #458, #460, #462, #466, #467, #469, #471, #473, #476, #530). `tools/bump_candidates.py` lists the upstream commits of a pin bump that the front ends depend on (#465)**Fixed**+- **A cut-off framework delete**: quitting while the launcher removed a stale game framework, about a minute on an external drive, left half a framework in the shared app folder. The next build of another game then failed at Prepare the shared app with "no readable game.manifest.json". The delete is now 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 (#539)- **Devices on Xcode 27.2**: the device list is read again, after `devicectl` changed its layout (#496, #488)- **exFAT volumes**: the Finder `._` files no longer break the Mac app pack, patch 0057 by @lucaszhongsj (#521, #486)- **Older game packages**: 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 are by @BadAppleD (#520, #519)@@ -29,6 +31,7 @@**Known issues**- **Export as IPA and Send game data are not tested end to end**: nobody has run them on a real device or with a sideloaded app yet. The maintainers test them with this release candidate (#531)+- **One game, all inside is not verified with a sideloading tool**: a very large IPA can fail to install, and we do not know the size limit (#542)- **First Play after the update**: built games are rebuilt, because the shader chain moved (#536)- **Shader split at 99%**: it can sit there for several minutes at its end while one worker finishes. It is not a hang (#489)- **Open**: Breath of the Wild fills the disk (#413). A Super Mario Odyssey shader step fails on an M1 with Xcode 27.2 (#361)@@ -47,10 +50,11 @@- Mac 启动器的安装卡片有一个开关:「安装到设备」或「导出为 IPA」- 导出不需要设备,也不需要签名团队。它在壳目录里写出未签名的 `NX2Apple.ipa`,供 AltStore、SideStore 或你自己签名用的其他工具使用- 游戏数据不在 IPA 里。第 3 步把数据发送到已配对设备上的 App,或复制到磁盘或文件夹,带进度和停止按钮-- 尚未端到端测试,见已知问题(#531、#416)+- **IPA 里放什么**:「导出为 IPA」多了一个选项。默认是「共用 App」。「一个游戏,全部在内」为每个游戏生成一个 IPA,游戏数据在里面,适用于无法向 App 复制数据的工具。它有自己的 Bundle ID `org.nxnative.<title ID>`,所以存档是独立的(#542、#540)+- 尚未端到端测试,见已知问题(#531、#416、#542)**新增**-- **意大利语界面**:启动器和 iPhone 壳 App 支持意大利语,作者 @Dino0005。导出卡片的 38 条文字是机器翻译,等待审校(#528、#536)+- **意大利语界面**:启动器和 iPhone 壳 App 支持意大利语,作者 @Dino0005。导出卡片的 38 条文字、新 IPA 选项的文字以及两条新文字 `shell.frameworkIncomplete` 和 `shell.gameLeftOut` 是机器翻译,等待审校(#528、#536、#539、#542)- **一种语言就是一个 JSON 文件**:Mac 和 Windows 启动器读取同一批语言文件,语言列表来自这些文件,每个前端各有一项测试检查每个文件(#478、#479、#480、#481)- **iPhone 壳 App 使用你的语言**:它的文字是这些文件里的行,游戏的设置行也以你的语言显示(#482、#485、#429)- **「最近玩过」直接启动游戏**:点按「最近玩过」里的游戏会启动它,行距也更宽松(#457、#425)@@ -59,6 +63,7 @@- **幕后工作**:启动器的代码改为按 store 划分,外观无变化(#456、#458、#460、#462、#466、#467、#469、#471、#473、#476、#530)。`tools/bump_candidates.py` 列出升级固定点时上游提交中前端所依赖的部分(#465)**修复**+- **中途中断的框架删除**:启动器正在删除过期的游戏框架时退出(外置磁盘上约一分钟),会在共用 App 目录里留下半个框架。之后构建另一个游戏时,会在「准备共用 App」一步失败,提示「no readable game.manifest.json」。现在删除改为重命名加后台删除,镜像副本完整后才落位,另一个游戏的不完整框架会被排除在外,并给出说明,写明游戏名和缺少的文件(#539)- **Xcode 27.2 上的设备**:`devicectl` 改了布局之后,设备列表可以再次读取(#496、#488)- **exFAT 卷**:Finder 的 `._` 文件不再让 Mac 应用打包失败,补丁 0057,作者 @lucaszhongsj(#521、#486)- **旧版游戏包**:缺少文件名表结尾终止符的旧版 PFS0 包可以读取,补丁 0058,重写器能识别零填充之前的指针尾调用,补丁 0059。两者作者均为 @BadAppleD(#520、#519)@@ -66,6 +71,7 @@**已知问题**- **「导出为 IPA」和「发送游戏数据」尚未端到端测试**:还没有人在真机上或用侧载的 App 运行过。维护者会用这个候选版本测试(#531)+- **「一个游戏,全部在内」没有用侧载工具验证过**:过大的 IPA 可能安装失败,大小上限未知(#542)- **更新后第一次点 Play**:已构建的游戏会重新构建,因为着色器链变了(#536)- **着色器拆分停在 99%**:结尾时可能停留几分钟,因为有一个工作进程还在处理。这不是卡死(#489)- **仍未解决**:《旷野之息》会占满磁盘(#413)。M1 上用 Xcode 27.2 时,《超级马力欧 奥德赛》的一个着色器步骤失败(#361)