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
Changelog: add v0.5.0 to v0.7.2 in both languages
v0lumehi6aabb5f345d0
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 1fd9e9bc..4b1eb54c 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -1,11 +1,16 @@# Changelog-The release history of NX2Apple, newest first. The text of the latest release is in [docs/RELEASE_NOTES.md](docs/RELEASE_NOTES.md) and every release is on the [releases page](https://github.com/LNPANDY/NX2Apple/releases). 中文:[CHANGELOG.zh-CN.md](CHANGELOG.zh-CN.md).+The release history of NX2Apple, newest first. Every release, with its full text, is on the [releases page](https://github.com/LNPANDY/NX2Apple/releases). 中文:[CHANGELOG.zh-CN.md](CHANGELOG.zh-CN.md).Newest first. The fork follows upstream daily, so its game list and host fixes arrive automatically.| Date | Version | What changed ||---|---|---|+| 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 |+| 2026-10-28 | v0.6.0 | **Guided first-run setup**: welcome, platform, Xcode, keys, games, with one administrator prompt for the toolchain and the Metal Toolchain and iOS platform downloaded with progress. **The build tools and a Python live inside the app** (zstd, glslangValidator, spirv-cross, xcodegen, CPython 3.13 from pinned, checksummed sources), so nobody installs Homebrew. **Reinstall without rebuilding** through `devicectl`, and **Save IPA…** for a sideloader. **Signature expiry and renewal**: the game card shows the days left on a free Apple ID and Renew re-signs in place. **Device detection** knows whether a game is installed on the connected device. A player's README (1,900 words instead of 8,000), issue triage and log first aid in report mode. The upstream sync becomes a patch queue with real three-way merges. Fixes: Xcode installed but not selected 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 |+| 2026-10-27 | v0.5.0 | **The Mac launcher arrives**: launch options live in the game's own saved-choices store (`launcher.<VAR>`, the one upstream reads), the library's Manage menu opens with a controller, and **a bare Apple ID can install** because Xcode creates the certificate at the first install. **The iPhone's game data finally sticks** (the bookmark is written while the Files app's security scope is held) and **an app with no data boots into the launcher** instead of a dead end. **The installer asks before copying game files** over USB. **The build tools update themselves**, even from an old ZIP copy (#87). Issue forms and a PR template ask for what a report needs. Fixes: the signing retry keeps its stage row, every extracted game version is kept as a build resource, the next upstream sync runs and every patcher is tested against real upstream in CI. Known issues: Mods not yet played with a real mod, Windows not provided on the releases page || 2026-10-27 | v0.4.9 | **The library follows the folder**: a Mac game's saves and log live beside the .app and migrate from `~/Library` on first run. **The iPhone's game data can live anywhere** (Files-app picker, remembered). **All eight tracker features landed** (#77–#84: key pre-check, drag & drop, build notifications, older-tools flag, free space, saves between Mac and device, copy diagnostics, controller layouts). Windows: Chinese UI fixed, the Metal probe works under a Chinese user name, the failed-install crash is gone, the Vulkan SDK is found by itself || 2026-10-27 | v0.4.8 | **The Mac launcher becomes usable**: install an iPhone build on a paired device (#28), a controller drives the whole launcher (#56), launch options split into basic and advanced (#54) with Display mode and the render scale in real pixels (#55) and a Mods section through `DM_ROMFS_OVERLAY` (#57), keys and controller buttons remappable (#39). **The build tools update when the app opens** (#60) and **a new version says what it changes** before installing. Fixes: every rewrite of every game crashed (`patch_nso.py`'s `TEXT_LO` used before assignment, #59), the Mac app refused every build with "requires Python 3.12" (#53), a ROMs folder holding several games could not build any of them (#58), a failed build pointed at a log that was off screen (#52), a Chinese Windows showed an English interface, CI could not open issues || 2026-10-27 | v0.4.7 | **94 game profiles** (+7: Octopath Traveler, Donkey Kong Country Returns HD, Donkey Kong Country: Tropical Freeze, Mario + Rabbids Sparks of Hope, Kirby and the Forgotten Land, Yoshi's Crafted World, Xenoblade Chronicles 3) from the daily sync. **One host binary, any game's memory layout** (runtime profiles — the foundation for the universal launcher, which has not been built yet). **The language toggle translates the whole interface**. **Xcode betas count** (the check asks xcode-select). A loud notice when an upstream update invalidates cached shaders. The output folder documented as the build cache's home. Windows front end: in-app Python 3.12, SDK clone past Windows' path-length limit, LLVM verified by compiling rather than --version, no more black console windows. Rebuilding on an external exFAT work folder no longer crashes |diff --git a/CHANGELOG.zh-CN.md b/CHANGELOG.zh-CN.mdindex 7c07ea70..ff6af8e2 100644--- a/CHANGELOG.zh-CN.md+++ b/CHANGELOG.zh-CN.md@@ -1,11 +1,16 @@# 更新日志-NX2Apple 的版本历史,最新在上,最新版本的完整说明见 [docs/RELEASE_NOTES.md](docs/RELEASE_NOTES.md)(英文),所有版本见[发布页](https://github.com/LNPANDY/NX2Apple/releases)。English: [CHANGELOG.md](CHANGELOG.md).+NX2Apple 的版本历史,最新在上,每个版本的完整说明见[发布页](https://github.com/LNPANDY/NX2Apple/releases)。English: [CHANGELOG.md](CHANGELOG.md).最新在上。本 fork 每天跟随上游,标「同步上游」的条目是自动来的。| 日期 | 版本 | 变更 ||---|---|---|+| 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 完整构建流水线未在真机验证 |+| 2026-10-28 | v0.6.0 | **引导式首次启动**:欢迎、平台、Xcode、密钥、游戏,一次管理员密码切换工具链,Metal Toolchain 和 iOS 平台带进度下载。**构建工具和 Python 装在 App 里**(zstd、glslangValidator、spirv-cross、xcodegen、CPython 3.13,来自 sha256 锁定的源码),没人需要装 Homebrew。**不重构建就能重装**(`devicectl`),**保存 IPA…** 导出给侧载器。**签名到期与续签**:游戏卡片显示免费 Apple ID 的剩余天数,续签按钮原地重签。**设备检测**知道游戏是否真的装在连接的设备上。玩家版 README(1900 词而不是 8000)、报告模式的 Issue triage 和日志急救。上游同步换成补丁队列,真正的三方合并。修复:Xcode 装了但未选中成为独立状态并带一键修复、依赖安装失败说出原因和命令、bundle-ID 检查不再崩在别的用户的项目上、诊断块不再打印 `(null)`、更新器找到 `uv` 安装的 Python |+| 2026-10-27 | v0.5.0 | **Mac 启动器来了**:启动选项存进游戏自己的选择存储(`launcher.<VAR>`,上游读的同一处),游戏库的 Manage 菜单用手柄就能打开,**只有普通 Apple ID 也能安装**,因为 Xcode 在第一次安装时自动创建证书。**iPhone 的游戏数据终于稳了**(书签在 Files App 的安全作用域被持有期间写入),**没有数据的 App 直接进启动器**而不是死页面。**安装器在通过 USB 拷贝游戏文件前先询问**。**构建工具自己更新**,连旧版 ZIP 拷贝也能接上(#87)。Issue 表单和 PR 模板要求报告所需的信息。修复:签名重试复用同一行、每个解包的游戏版本都作为构建资源保留、下一次上游同步能跑通且每个补丁器都在 CI 里对着真实上游测试。已知问题:Mods 还没有用真正的 mod 实测过,发布页不提供 Windows || 2026-10-27 | v0.4.9 | **游戏库跟着文件夹走**:Mac 游戏的存档和日志放在 .app 旁边,首次运行自动从 `~/Library` 迁移。**iPhone 的游戏数据可以放任何位置**(Files 应用选择器,自动记住)。**追踪器八项需求全部落地**(#77–#84:密钥预检、文件拖拽、构建通知、旧工具标记、空间回收、Mac 与设备存档互拷、复制诊断报告、手柄布局)。Windows:中文界面修复、中文用户名下 Metal 探针正常、依赖安装失败闪退修复、Vulkan SDK 自动识别 || 2026-10-27 | v0.4.8 | **Mac 启动器真正可用了**:把 iPhone 版装到配对设备(#28)、手柄导航整个启动器(#56)、启动选项分基础/高级(#54)并加上显示模式与真实像素的 Render scale(#55)、Mods 区走 `DM_ROMFS_OVERLAY`(#57)、键位与手柄按钮可自定义(#39)。**启动时自动更新构建工具**(#60),**新版本会先说明改了什么**再让你决定。修复:每一款游戏的每一次重写都会崩(`patch_nso.py` 的 `TEXT_LO` 先用后定义,#59)、Mac 版建什么都报「需要 Python 3.12」(#53)、一个文件夹多款游戏时一款都建不了(#58)、构建失败指向窗口外的日志(#52)、Windows 中文系统显示英文界面、CI 建不了 issue || 2026-10-27 | v0.4.7 | **79 个游戏 profile**(+7:歧路旅人、大金刚国度 归乡 HD、大金刚国度 热带冻结)来自每日同步。**一个宿主二进制适配任意游戏的内存布局**(运行时 profile——为通用启动器打下的地基,启动器本身尚未开始)。**语言切换现在翻译整个界面**。**Xcode Beta 也算数**(检测改问 xcode-select)。上游更新导致 shader 缓存失效时会醒目提示。「输出目录」同时是构建缓存的位置已写明。Windows 前端:App 内装 Python 3.12、SDK 克隆突破 Windows 路径长度限制、LLVM 用试编译而不是 --version 验证、不再弹黑色命令行窗口。外置 exFAT 工作目录重建不再崩溃 |