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
v0.8.0: version bump and changelog
v0lumehiedf7597e7bef
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 4b1eb54c..c6802008 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -6,6 +6,10 @@ Newest first. The fork follows upstream daily, so its game list and host fixes a| Date | Version | What changed ||---|---|---|+| 2026-10-31 | v0.8.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) |+| 2026-10-31 | v0.7.4 | **The engine is fetched on its own** (#273): the update no longer bundles the engine source. Upstream fixes sync online inside the launcher, so they do not wait for a release. This needs GitHub access, and the launcher shows the progress and the reason for a failure. **Game language is a menu** like the iOS shell, set to System by default (#283). **A faster launcher**: tab switches (#297), Options and Manage sheets (#294), font and button rendering. Fixes: console mode starts a game from a window that just left full screen, a game folder inside iCloud Drive stops the build with an explanation because iCloud moves build caches away (#279), console mode hides the pointer after a few idle seconds (#280), *Restart now* opens the new copy from a helper once the old process has exited (#277). On 0.7.3 or older, `Repository: not found` means the old app's repository check no longer matches the new layout. Update to 0.7.4 and set it up again |+| 2026-10-30 | v0.7.3 | **German interface** (#225), with thanks to @kidziiii. **Saves**: find the game's save on the device itself, then pick the iPhone or iPad to sync with (#260). **zbic is bundled** (#258): it reads Nintendo's zstd-variant modules, and the dependency probe checks it. Fixes: a game whose base NSP sits in a subfolder (`nsp本体`) finds the update and DLC beside it (#240, #246), the Choose file dialog accepts NSZ and XCZ (#243), installing on a device no longer passes `--remove-existing-content`, which deleted the game data there (#266), a Chinese Windows no longer falls back to English in the Qt app (#256), cheats are marked unavailable on iPhone and iPad (#257), the bundled Python packages are hash-pinned (#259) || 2026-10-30 | v0.7.2 | **Games that opened to a black screen load again** (e.g. Super Mario Bros. Wonder): the Mac pipeline archive is stamped for this Mac's OS version instead of the SDK's, so pipelines load instead of recompiling at first start (upstream #673). 26 upstream commits: emulated sampler border colours, NVN logic operations, automatic same-pass feedback snapshots || 2026-10-29 | v0.7.1 | **Console mode starts games fullscreen** (#220, #219): Play forces `DM_FULLSCREEN` and the window enters fullscreen once it is on the active Space, so a game rebuild picks the fix up. **The game opens on the launcher's display** (#221, `DM_SCREEN`, written and reviewed with two displays but not yet validated end to end on one). **A per-game cheats sheet** (#218). **Build failures say what to do** (#215): rows for keys, game files, drive, disk space, signing and the device install, each with the cause and the button that fixes it. **Slim iOS builds carry the DLC you pick** (#212). **The update page reads Markdown** (#216) and **an NSP with no ticket gives its title ID from the package** (#217). Fixes: the launcher goes idle after a build (#208), a folder with several games stages cleanly (#209), a venv below 3.12 is not ready and Pythons from mise and asdf are found (#211), the Qt front end no longer crashes on shutdown (#224), the daily upstream sync (#223) || 2026-10-29 | v0.7.0 | **Console mode** (#169): with a controller, Select or View → Console Mode takes the library full screen, controller-first, with covers, launch options, battery chips and a Controllers list (also Option-Command-K). **Cloud saves** (#185): a game's Mac app and iPhone app share one save through an iCloud Drive folder, with SHA-256 checks and per-date backups, verified with Tears of the Kingdom on both platforms. **Guided first-run setup** (#119, #120) and **build tools and Python inside the app** (#154), so nobody installs Homebrew. **Reinstall without rebuilding and Save IPA…** (#155). **Signature expiry and in-place renewal** for a free Apple ID (#156). **Build failures become rows that name the reason and the next step** (#166, #205). Swedish localization (#168), a player's README, issue triage in report mode (#143), and on Windows a guided dependency panel for the two Apple downloads plus a link-probe crash fix (#192, #196). Fixes: Xcode installed but never opened is its own state with a one-click Fix, a failed dependency install names the reason and the command, a bundle-ID check no longer crashes on another user's project, the diagnostics block no longer prints `(null)`, the updater finds the Pythons `uv` installs and its strings survive CI. Known issues: Mods not yet played with a real mod, the Windows build pipeline not verified on hardware |diff --git a/CHANGELOG.zh-CN.md b/CHANGELOG.zh-CN.mdindex ff6af8e2..f76c609b 100644--- a/CHANGELOG.zh-CN.md+++ b/CHANGELOG.zh-CN.md@@ -6,6 +6,10 @@ NX2Apple 的版本历史,最新在上,每个版本的完整说明见[发布| 日期 | 版本 | 变更 ||---|---|---|+| 2026-10-31 | v0.8.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) |+| 2026-10-31 | v0.7.4 | **引擎改为独立获取**(#273):更新包不再打包引擎源码,上游修复在启动器里自动在线同步,不必等新版本发布。这需要能访问 GitHub,同步进度和失败原因都显示在启动器里。**游戏语言改为菜单选择**(#283),与 iOS 相同,默认「跟随系统」。**启动器提速**:页面切换(#297)、Options 和 Manage 弹窗(#294)、字体与按钮渲染。修复:主机模式从刚退出全屏的窗口启动游戏不再异常、游戏文件夹在 iCloud Drive 里时构建会被拦下并说明原因,因为 iCloud 会挪走构建缓存(#279)、主机模式下鼠标静止几秒后自动隐藏(#280)、「立即重启」改为由助手进程在旧进程退出后拉起新版本(#277)。如果你在 0.7.3 或更早版本上看到 `Repository: not found`,是旧版 App 的仓库校验与新的仓库布局不匹配。请更新到 0.7.4 并重新设置 |+| 2026-10-30 | v0.7.3 | **德语界面**(#225),感谢 @kidziiii。**存档**:先在设备上找到游戏存档,再选择要同步的 iPhone 或 iPad(#260)。**内置 zbic**(#258):读取 Nintendo zstd 变体模块所需,依赖检查也会确认它可用。修复:游戏本体在 `nsp本体` 之类子目录时能找到同级的更新包和 DLC(#240、#246)、「选择文件」对话框能选 NSZ / XCZ(#243)、安装到设备时不再传 `--remove-existing-content`,它会删掉设备上的游戏数据(#266)、Qt 版在中文 Windows 上不再显示成英文(#256)、金手指在 iPhone / iPad 上标明不可用(#257)、内置 Python 依赖改为哈希锁定(#259) || 2026-10-30 | v0.7.2 | **部分游戏打开后黑屏的问题修复**(如《超级马里奥兄弟 惊奇》):Mac 管线存档改为按本机系统版本生成,不再在首次启动时重新编译全部管线(上游 #673)。同步上游 26 个提交:sampler 边框颜色模拟、NVN 逻辑运算、同 pass 反馈快照自动识别等 || 2026-10-29 | v0.7.1 | **主机模式游戏直接全屏**(#220、#219):Play 强制 `DM_FULLSCREEN`,游戏窗口落到活动 Space 后即进入全屏,重新构建一次游戏即获得修复。**游戏开在启动器所在显示器**(#221,`DM_SCREEN`,在双显示器下编写并评审,但未做端到端实测)。**按游戏打开的金手指面板**(#218)。**构建失败告诉你怎么做**(#215):keys、游戏文件、磁盘/卷、磁盘空间、签名和设备安装各自一行,写明原因并给出修复按钮。**瘦身 iOS 构建带上你选的 DLC**(#212)。**更新页支持 Markdown**(#216),**无 ticket 的 NSP 从包内读标题 ID**(#217)。修复:构建结束后启动器恢复空闲(#208)、多游戏文件夹稳定暂存(#209)、低于 3.12 的 venv 视为未就绪并能找到 mise 和 asdf 安装的 Python(#211)、Qt 前端退出崩溃(#224)、每日上游同步(#223) || 2026-10-29 | v0.7.0 | **主机模式**(#169):连接手柄后按 Select 或视图 → 主机模式,游戏库变全屏、手柄优先,有封面、启动选项、电量徽章和手柄列表(也可用 Option-Command-K)。**云存档**(#185):游戏的 Mac 版和 iPhone 版通过一个 iCloud Drive 文件夹接力同一个存档,带 SHA-256 校验和按日期备份,双平台用王国之泪验证。**引导式首次启动**(#119、#120)与**构建工具和 Python 内置在 App 里**(#154),没人需要装 Homebrew。**不重构建就能重装和保存 IPA…**(#155)。**免费 Apple ID 的签名到期提示与原地续签**(#156)。**构建失败变成行提示,写明原因和下一步**(#166、#205)。瑞典语本地化(#168)、玩家版 README、Issue triage 报告模式(#143),Windows 依赖面板引导两个 Apple 下载并修复链接探针崩溃(#192、#196)。修复:Xcode 装了但没打开过成为独立状态并带一键修复、依赖安装失败说出原因和命令、bundle-ID 检查不再崩在别的用户的项目上、诊断块不再打印 `(null)`、更新器找到 `uv` 安装的 Python 且字符串在 CI 中不再丢失。已知问题:Mods 还没有用真正的 mod 实测过,Windows 完整构建流水线未在真机验证 |diff --git a/frontend/Sources/NSPortBuilder/ContentView.swift b/frontend/Sources/NSPortBuilder/ContentView.swiftindex fed375d5..e4720a8b 100644--- a/frontend/Sources/NSPortBuilder/ContentView.swift+++ b/frontend/Sources/NSPortBuilder/ContentView.swift@@ -675,7 +675,7 @@ final class BuildModel: ObservableObject {// The rules (what is verified, which copies replace themselves, never during a build) are in AppUpdate.swift./// Bump together with each release tag; the update check compares it with the latest release.- static let appVersion = "0.7.5"+ static let appVersion = "0.8.0"/// The update checkAppUpdate found: the tag, the asset to download, its digest, and the release/// notes the sheet shows. The notes are why the sheet exists — "update available" alone told a/// user nothing about what they would get.