github LNPANDY/NX2Apple v1.5.0
v1.5.0: Multiple build engines, hot framework loading, and Dark Glass / 多构建引擎、游戏框架热加载与暗色液态玻璃

one hour ago

v1.5.0: Multiple build engines, hot framework loading, and Dark Glass / 多构建引擎、游戏框架热加载与暗色液态玻璃

English

Highlights

  1. Multi-engine workbench (#1368, #1370, #1372, #1374, #1405, #1455, #1473, #1474, #1498): Switch engines in one click from the top of Builds or Settings between nxnative, self-updating nxkit 0.10.3 (Beta) with Ed25519 signature verification, and turnkey MacNativeGames guarded to its 5 maintained titles (MNG badges) for first-party Mac play, with S2Arm behind NX2APPLE_ENABLE_S2ARM=1.
  2. Faster rebuilds and incremental refresh (#1296, #1299, #1322, #1323, #1483): Version 1.5.0 builds persist build-seeds caches so most updates run fast batch refreshes in minutes without the original game package or intermediate build directories, isolated from unstarted build drafts.
  3. Install new games without reinstalling the shared shell IPA (#1217, #1305, #1437, #1493, #1495): Export signed or unsigned DmGame.framework bundles into Documents/Frameworks, import a .p12 sideload certificate on iOS for on-device framework signing (#1493), or hot-push directly on iOS 27 (glueVersion: 2), with no shell IPA reinstall required.
  4. Slim shared shell IPA (#1216, #1229, #1270, #1295, #1439): DMMSLTR1 shader trailers and optional bundled payloads move into external .img archives so the shared NX2Apple.ipa stays a few tens of megabytes for easier sideload signing, paired with foreground kqueue .nxpart auto-joining (#1481).
  5. Full Shortcuts support (#1395, #1437): Built-in 6-step Add to Home Screen guide and an optional Picture-in-Picture walkthrough card support nx2apple://launch home screen icons and controller-connect auto-launch shortcuts.
  6. Major Windows build upgrades (#1249, #1253, #1255, #1315, #1317, #1355, #1414, #1447, #1485, #1492, #1499): Qt adds a general multi-game BuildQueue, expands the Oodle Unicorn emulated heap up to 2 GiB on demand for large shader blocks such as Pokemon Violet, fixes Windows seed adoption paths, .engine-id CRLF hashes, and exFAT zero-inode build seed loops (#1456, #1478, #1492, #1499), aligns iOS packager contracts, and improves CET, Defender, and Visual C++ diagnostics.
  7. Background audio mixing (#1300, #1438): DM_AUDIO_MIX lets music or podcasts keep playing into a game without stopping or lock-free callback crackling, alongside atomic audio teardown and AudRen thread draining (#1305, #1314, #1395).
  8. Per-game update version badges (#1296, #1457, #1458, #1486): Both Supported Games and hero cards surface the latest NX2Apple version that optimized each game (such as 1.5 across a 102-game catalog with 80 titles updated in 1.5.0) so players know when to rebuild.
  9. Redesigned launcher UI and artwork pipeline (#1392, #1443, #1457, #1458, #1459, #1467, #1468, #1474, #1484): Dark Glass design system backed by design tokens, Liquid Glass reserved for navigation layers, rebuilt two-column console mode, three-tier banner fallback with eShop Switch 2 covers across Mac, iOS, and Qt, and an interactive 16:9 iOS cover cropper.
  10. 574-commit engine leap from ccd834e0 to 99224562186a (#1226, #1312, #1361, #1448, #1486, #1494): Covers over 140 game profiles (208 in the engine tree), unlocks higher frame rates and rendering fixes across major titles, and adds Polish and Thai game language options.

New

  • Dark Glass design system and state gallery: the Mac launcher moves to a single dark palette backed by design-tokens/tokens.json, removes light mode branches, keeps Liquid Glass strictly in navigation surfaces, standardizes sheet layouts, and adds --gallery (NX_GALLERY=1) to inspect every view and failure state locally (#1458, #1459, #1474 by @v0lumehi)
  • Built-first library, single-screen Builds, and redesigned console mode: playable Mac and iOS builds sort ahead of muted unbuilt titles, Builds returns to a single screen without truncated stage ETAs, opening Builds matches pre-redesign speed, and console mode uses a one-row home screen and two-column detail pages (#1392 by @jonochocki, #1443 by @v0lumehi, #1457, #1474)
  • Multi-engine workbench (nxnative, nxkit, MacNativeGames, S2Arm): switch engines from the restored top BuildPage EngineSwitcherCard or Settings with short version badges, one-click updates, and an in-card MacNativeGames recommendation bar, try nxkit 0.10.3 (Beta) on Apple silicon Macs with signed Ed25519 self-updates, run MacNativeGames with rootless Python 3.14 and shared fonts guarded to its 5 officially maintained titles (MNG badges), keep S2Arm hidden behind NX2APPLE_ENABLE_S2ARM=1 by default, and omit --update and --dlc flags on unencrypted .nup and dump folder inputs (#1368, #1370, #1372, #1374, #1405, #1455, #1473, #1474, #1498)
  • Hot-loaded iOS frameworks, .p12 on-device signing, iOS 27 hot push, and live .nxpart joining: ShellHost and the launchers load signed DmGame frameworks from Documents/Frameworks, expire stale frameworks on newer shell builds (glueVersion: 2), support host-signed hot push on iOS 27, standalone .framework export with signing team or unsigned sideload selection (#1495), .p12 sideload certificate import with Keychain storage and on-device framework signing (#1493), and a foreground kqueue directory watcher that auto-joins streaming .nxpart parts once quiet (#1217, #1305, #1395, #1437, #1481)
  • 6-step Home Screen guide and PiP walkthrough: nx2apple://launch shortcuts gain a 6-step guided setup with an optional zero-extension AVPictureInPictureController floating walkthrough card (#1395, #1437)
  • Build seeds, draft isolation, USB link-speed modal, and .img recovery: persistent build seeds power fast incremental refreshes, Mac and Qt sync a 102-game update catalog (80 updated in 1.5.0) with release badges, refresh batches stay isolated from unstarted build drafts, Mac builds detect IOUSBHostDevice link speed (10 Gbps, 5 Gbps, USB 2.0 480 Mbps, or Wi-Fi) with a pre-build transfer mode picker and centered modal transfer sheet, and a three-way recovery flow finds missing .img files (#1296, #1299, #1322, #1323, #1439, #1483)
  • DMMSLTR1 trailers, APFS clones, shared IPA repacking, and loose .img claiming: DMROMFS1 images hold 16 KiB-aligned DMMSLTR1 shader trailers, framework-only builds strip msl into .msl-cache and remind players to replace outdated .img copies, framework copies use APFS clones (cp -c, #422, #832, #1449 by @Atomsk-debug and @v0lumehi), shared IPAs repack directly with batch transfers, any non-part .img name is accepted, iOS claims matching loose images in Documents on launch (#1216, #1229, #1270, #1295, #1439), and the iOS shell README documents script-only DMMSLTR1 image trailers (#1327, #1341 by @Haseenesss)
  • Artwork pipeline, eShop Switch 2 fallback, and iOS 16:9 cropper: desktop artwork uses a three-tier banner pipeline (KnownGameBanners, api.nlib.cc, chunked titledb), extracts offline NACP icons, backfills missing iOS covers with synthesized 512x512 square fallback icons (#1457, #1467), resolves official ec.nintendo.com/apps/<TID>/US|HK banners for Switch 2 and regional titles across Mac, iOS, and Qt (#1484), and adds an interactive 16:9 pinch-and-pan cover cropper on iPhone and iPad (#1468)
  • Windows batch queue, trash delete, and diagnostics: Qt adds a general multi-game BuildQueue with multi-game folder grouping (#1447), moves deleted games to the Trash while removing them from the shared iPhone app (#1253, #1255 by @Haseenesss), and lists each dependency status in Copy diagnostics (#1249 by @Haseenesss)
  • Audio mix, save portability, and console mode actions: DM_AUDIO_MIX mixes game audio with other iOS apps (#1300), single-game builds append the Team ID to default bundle IDs (#1302), connected controllers show a one-shot quit keycap hint with live in-game settings (#1305, #1395), Mac games carry full saves atomically when libraries move or sit on HFS+ drives (#1118, #1436 by @MartinMajewski and @v0lumehi), Settings adds target display choice (#1283 by @Haseenesss), failed builds alert again in front (#1100 by @Haseenesss), and console mode adds first-click tile selection, wheel row scrolling, and Build or Queue actions (#1289, #1292 by @Haseenesss)

Changed

  • Upstream engine and verified game records: the pin advances from ccd834e0 through 0c078130 (#1226), 5a4e23a2 (#1312), 94a09447 (#1361), 0b5fd602 (#1448), and ff2d3efea61a (#1486) to 99224562186a (#1494 by @v0lumehi) across 574 upstream commits on shader chain df1800562702, adding Polish and Thai game language options (#1486) and recording The Legend of Zelda: Ocarina of Time Switch 2 edition played on a Mac through the ending credits (#1308, #1373 by @ZhaowTao) and Fire Emblem Fortune's Weave verified at 60 fps on iPhone 18 Pro Max (#1278)
  • Patch queue slimmed from 91 to 58 patches: docs/env_switches.tsv is synthesized automatically, DmShell moves under frontend-ios/Shell, superseded patches and our custom Joy-Con driver (covered by upstream pad_jc1, #1367, #1454, reported by @paulcald90) are dropped, and bridge patches add Nintendo Switch Sports Resort (04008E001F098000) resplit shaders (#1480), zero-inode build seed guards (#1456, #1478, #1492), duplicate main shader label derivation guards, and refreshed Stardew Valley, Animal Crossing: New Horizons, and Captain Toad: Treasure Tracker shader maps (#1501)
  • iOS touch controls simplified: removed the per-key Hold and Toggle latching mode while keeping standalone DM_TOUCH_SIZE and DM_TOUCH_STICK settings (#1344)

Fixed

  • iOS Cover Flow tail-scroll hang: replaced LazyHStack and synchronous .scrollPosition feedback with a fixed-stride HStack, render-only .visualEffect, discrete .zIndex, and deferred selection commits to eliminate the AttributeGraph cycle on cold launch tail scrolling (#1349, #1488)
  • Windows Oodle emulated heap expansion: arm64_emu grows the Unicorn heap in 64 MiB steps up to 2 GiB on demand and scales timeouts for large blocks so large shader chunks no longer fail with emulated heap full (96 MB) (#1472, #1485)
  • Engine channel downgrade and experimental build sync: recorded .upstream-date, blocked experimental engine downgrades to older upstream pins, fixed same-version release-candidate upgrades, and refreshed built-in engine version badges (#1475, #1489)
  • Windows/exFAT zero-inode build seeds, win.shim adoption, .engine-id CRLF, and stale v0 profiles: fell back to realpath loop keys when st_ino == 0, rejected or cleaned mismatched work/profile folders in build_seed.py and build_ipa_from_nsp.py (#1456, #1478, #1492), injected nspb_qt.win.shim when adopting existing _build folders or packing shell shaders on Windows, and normalized CRLF line endings so Mac and Windows .engine-id hashes match (#1499)
  • Shader map duplicate main label derivation and refreshed tables: derived shader_map.tsv safely when only duplicate main shader deduplication order changed across 22+ titles and refreshed shader maps for Stardew Valley, Animal Crossing: New Horizons, and Captain Toad: Treasure Tracker (#1501)
  • Multi-core CPU BC texture decode and buffer copies: enabled parallel CPU BC texture decoding on A15 and A16 devices and handled CPU BC buffer-to-texture copies while rejecting unsupported BC readbacks (#446, #777, #1440, #1442 by @v0lumehi)
  • Adaptive iOS RT heaps, arena GPU base latching, and Super Mario Party NVN fixes: patch 0055 converges DM_NVN_RT_RECYCLE heap caps on iOS alongside upstream RH_SLACK (#1329, #1486), nvn_mtl latches arena GPU base addresses before nested allocations (#1378), and aliased virtual pool flags, sentinel sampler bounds, and dm_gfx_teardown state resets keep sessions stable (#1227, #1312, #1486)
  • iOS audio mix crackling, teardown, phone gyro fallback, and shortcut crash: added lock-free audio prebuffering for 1024-frame mixed callbacks and dropped experimental widescreen patch 0060 (#1438), made audio teardown atomic and drained AudRen threads before exit (#1305, #1314, #1395), kept the phone gyroscope active when a controller has no gyro (#971, #1365), moved PhotoKit saving off @MainActor (#1437), dropped duplicate vibration hooks in 0027 (#1324), and stabilized game settings transitions (#1325)
  • GL/VK build seeds, Re-sign receipts, and build space cleanup: preserved shared shell installedDevice receipts after IPA exports, inferred and self-healed GL and Vulkan build seeds (#1396, #1438), cleaned failed shader .part files on full drives (#1281 by @Haseenesss), avoided double-counting extracted files on rebuilds (#1257 by @Haseenesss), and localized build stage names (#1256 by @Haseenesss)
  • Mac multi-program host, Windows packager alignment, toolchain diagnostics, and l10n: added input_preferences_mac.h for multi-program Mac hosts (#1316 by @gxt43), aligned Qt's build_app.py and IOS_CPU with build_ipa.sh (#1414), ran CET-blocked .NET tools via dotnet with POSIX signal guards and dynamic metal-tt lookup (#1315 by @1804328), hardened elevated Defender scripts (#1317), skipped stripped Defender prompts and diagnosed missing Visual C++ 2015-2022 (x64) runtimes and NTSTATUS compiler crashes (#1355), and updated German localization checks (#1359)
  • Switch 2 Edition NUPs, Qt fast refresh, export signing, dropdown race, tests, and Git hooks: identified Switch 2 Edition NUPs by their highest program index (#1353, #1375 by @Haseenesss), switched Qt fast refresh builds from --progress json to --progress lines (#1496), passed --identifier <hostBundleID> when codesigning exported standalone frameworks (#1495), fixed a dropdown host race under concurrent focus updates (#1498), showed the Experimental badge only next to nxkit, dropped the Switch label from its engine row, and added a Send feedback button that opens an issue in v0lumehi/nxkit (#1505), read sRGB in pixel tests on P3 displays (#1464 by @1Bartosz), used overlay scroll bars in RowEdgeTests on Macs with mice (#1402 by @odonnellmatt), and stopped Git hooks when the patch queue check would read uncommitted files (#1078 by @Fbenhaddou)

Known issues

  • Tears of the Kingdom and Ocarina of Time shader split hang: dropping patch 0024 for the shader chain rule means zstd hangs during shader splitting on these two titles can return until seedds/nxnative#1463 lands upstream (#1448)
  • First rebuild of existing NVN games: because the shader chain moved to df1800562702, previously built NVN games rebuild once on their first Play (#449)
  • Hardware coverage on late fixes: after physical iPhone 17 Pro Max and Windows 11 checks passed, Cover Flow tail scrolling (#1488) awaits physical iPadOS 26 tablet verification and large-block Windows Oodle expansion (#1485) awaits a full physical rebuild on large Oodle titles

Requires

  • iOS or iPadOS 26 or later
  • To build NVN games on a Mac: Xcode 27.2 and macOS 26.6 or later

中文

重点

  1. 多构建引擎支持(#1368、#1370、#1372、#1374、#1405、#1455、#1473、#1474、#1498):恢复构建页顶部引擎选择器并与设置页同步,新增开箱即用且限定 5 款官方维护游戏(含 MNG 徽章)的 MacNativeGames 与内置 Ed25519 验签自更新的 nxkit 0.10.3 (Beta),一键切换构建引擎并强化第一方大作 Mac 端体验,默认通过 NX2APPLE_ENABLE_S2ARM=1 隐藏实验性 S2Arm。
  2. 重构大提速与快速刷新(#1296、#1299、#1322、#1323、#1483):1.5.0 构建持久化 build-seeds 种子缓存,大多数更新不再需要原始游戏包或中间构建目录,几分钟即可批量快刷,且刷新批处理与未开跑的草稿完全隔离。
  3. 装新游戏免重装壳 IPA(#1217、#1305、#1437、#1493、#1495):可导出已签名或未签名的 DmGame.framework 放入 Documents/Frameworks,在 iOS 壳导入 .p12 证书就地重签(#1493),或在 iOS 27 上直接宿主签名热推送(glueVersion: 2),无需反复重装壳 IPA。
  4. 共享壳 IPA 大瘦身(#1216、#1229、#1270、#1295、#1439):DMMSLTR1 着色器尾块与非必须内置文件合入外部 .img 镜像,共享壳 NX2Apple.ipa 仅数十 MB,大幅便于侧载签名,并配合前台 kqueue 监听与稳态 .nxpart 自动合片(#1481)。
  5. 全面支持快捷指令(#1395、#1437):内置 6 步添加到手机主屏幕向导与零扩展画中画(PiP)悬浮跟步教程,支持 nx2apple://launch 桌面图标直开游戏及连接手柄自动启动等快捷指令操作。
  6. Windows 构建大幅进化(#1249、#1253、#1255、#1315、#1317、#1355、#1414、#1447、#1485、#1492、#1499):新增通用多游戏批量构建队列 BuildQueue,模拟堆按需扩容至 2 GiB 解决《宝可梦 紫》等大块 Oodle 着色器解压报错,修复 Windows 种子领养路径、.engine-id CRLF 哈希一致化及 exFAT 零 inode 构建种子误报(#1456、#1478、#1492、#1499),对齐 iOS 打包契约并加强 CET、Defender 与 Visual C++ 诊断。
  7. 后台音频混音(#1300、#1438):DM_AUDIO_MIX 支持后台播放音乐或播客进入游戏不停止且无爆音,配套原子音频退出释放与 AudRen 线程排空(#1305、#1314、#1395)。
  8. 游戏专属更新版本标识(#1296、#1457、#1458、#1486):「支持的游戏」列表与主图卡片展示各款游戏最近优化的 NX2Apple 版本号(如 1.5,覆盖 102 款目录游戏中的 80 款本轮新增或优化游戏),方便判断是否需要重编。
  9. 启动器界面全面进化(#1392、#1443、#1457、#1458、#1459、#1467、#1468、#1474、#1484):全系升级为深邃暗色液态玻璃(Dark Glass)设计系统并重制双栏主机模式,配三级桌面横幅回退、三端任天堂商店 Switch 2 横幅兜底与 iOS 16:9 交互式封面裁剪。
  10. 跨越 574 次上游提交的引擎大跃迁(ccd834e0 至 99224562186a,#1226、#1312、#1361、#1448、#1486、#1494):支持超 140 款游戏配置(引擎仓实计 208 款),多款大作解锁高帧率与大量渲染修复,并新增波兰语与泰语支持。

新增

  • 暗色玻璃设计系统与状态画廊:Mac 启动器采用由 design-tokens/tokens.json 驱动的统一暗色设计语言,移除浅色外观分支并按 HIG 仅在导航层保留 Liquid Glass,统一弹窗布局,并新增 --gallery(NX_GALLERY=1)本地状态画廊以检查全部界面与故障态(#1458、#1459、#1474,@v0lumehi)
  • 内置优先游戏库、单屏构建页与主机模式重制:游戏库将可玩与已构建游戏排在未构建条目之前且未构建卡片改用柔和半透明色调,恢复单屏构建工作台并取消截断阶段耗时列的固定宽度、让构建页开启速度回到改版前水平,同时将主机模式重制为电视式单行主页与双栏详情页(#1392 由 @jonochocki 贡献,#1443 由 @v0lumehi 贡献,#1457、#1474)
  • 多构建引擎工作台(nxnative、nxkit、MacNativeGames、S2Arm):恢复构建页顶部 EngineSwitcherCard 引擎选择器并与设置页同步,支持紧凑版本角标、一键更新及卡片内 MacNativeGames 推荐提示条,Apple silicon Mac 可试用支持 Ed25519 签名自更新的 nxkit 0.10.3 (Beta),Mac 版 MacNativeGames 自动配齐免 root Python 3.14 与共享字体并锁定 5 款官方维护游戏白名单与 MNG 徽章,默认通过 NX2APPLE_ENABLE_S2ARM=1 隐藏实验性的 S2Arm,并修复未加密 .nup 与解包目录的 --update 和 --dlc 传参问题(#1368、#1370、#1372、#1374、#1405、#1455、#1473、#1474、#1498)
  • iOS 热加载框架、.p12 端侧重签、iOS 27 热推送与 .nxpart 实时合片:ShellHost 与启动器支持从 Documents/Frameworks 热加载已签名 DmGame 框架并在新版壳应用到达时自动淘汰旧框架(glueVersion: 2),支持 iOS 27 宿主签名热推送、可选签名团队或未签名侧载的独立 .framework 导出(#1495)、iOS 壳导入 .p12 证书至 Keychain 并设备端重签框架(#1493),以及通过前台 kqueue 目录监听在传输静默后自动合并 .nxpart 分片(#1217、#1305、#1395、#1437、#1481)
  • 6 步主屏幕快捷指令引导与画中画教程:nx2apple://launch 主屏幕快捷方式提供 6 步详细指引及可选零扩展 AVPictureInPictureController 画中画悬浮跟步卡片(#1395、#1437)
  • 持久化构建种子、草稿隔离、USB 传输弹窗与 .img 恢复:持久化构建种子实现快速增量刷新,Mac 与 Qt 同步 102 款游戏更新目录(含本版 1.5.0 更新的 80 款游戏)并展示版本角标,刷新队列与未开跑的单游戏构建草稿完全隔离,Mac 端通过 IOUSBHostDevice 识别 USB 10 Gbps、5 Gbps、USB 2.0 480 Mbps 或 Wi-Fi 链路速率并提供构建前传输策略选择器与居中模态传输确认弹窗,同时提供外置盘、Finder 或资源管理器及 iPhone Documents 的三向缺失 .img 恢复引导(#1296、#1299、#1322、#1323、#1439、#1483)
  • DMMSLTR1 着色器尾块、APFS 克隆加速与松散镜像认领:DMROMFS1 镜像支持尾部 16 KiB 对齐的 DMMSLTR1 着色器子镜像,仅框架构建剥离内嵌 msl 至 .msl-cache 并提醒用户替换旧 .img 副本,框架产物拷贝采用 cp -c APFS 克隆提速(#422、#832、#1449,@Atomsk-debug 与 @v0lumehi),共享 IPA 支持直接重打包与批量传输,允许任意非分片 .img 文件名并在 iOS 启动时自动认领 Documents 下的松散镜像(#1216、#1229、#1270、#1295、#1439),同时补充纯脚本构建壳应用时需将 DMMSLTR1 尾块写入游戏镜像的文档说明(#1327、#1341,@Haseenesss)
  • 三级桌面封面管线、Switch 2 商店兜底与 iOS 16:9 裁剪器:桌面端落地内置快表、api.nlib.cc 与流式 titledb 三级横幅查图管线并支持离线 NACP 图标提取及 iOS 打包时主动补图与 512x512 方形图标合成(#1457、#1467),三端统一接入 ec.nintendo.com/apps/<TID>/US|HK 官方商店 Switch 2 横幅兜底并补齐 7 款官方 Switch 2 横幅(#1484),iPhone 与 iPad 端新增三入口更换封面及 16:9 双指缩放拖拽交互式裁剪器(#1468)
  • Windows 通用批量构建队列、移入废纸篓与逐项诊断:Windows 与 Linux Qt 启动器新增通用多游戏批量构建队列 BuildQueue 与多游戏分组恢复(#1447),删除游戏移至废纸篓或回收站并同步从共享 iPhone 应用中移除(#1253、#1255,@Haseenesss),复制诊断信息会逐项列出依赖状态(#1249,@Haseenesss)
  • 后台混音、存档随行与主机模式细节:新增 DM_AUDIO_MIX 后台音频混音(#1300),单游戏默认 Bundle ID 追加团队 ID 后缀(#1302),连接手柄时显示一次性退出键位提示胶囊并支持游戏内实时设置(#1305、#1395),Mac 游戏库迁移或位于 HFS+ 磁盘时以全有或全无原子方式完整带走存档(#1118、#1436,@MartinMajewski 与 @v0lumehi),设置新增目标显示器选择(#1283,@Haseenesss),构建失败在前台再次弹窗提醒(#1100,@Haseenesss),主机模式支持首次点击选中磁贴、滚轮跨行与未构建页直接构建或入队(#1289、#1292,@Haseenesss)

变更

  • 上游引擎与实机验证记录:上游固定点从 ccd834e0 经由 0c078130(#1226)、5a4e23a2(#1312)、94a09447(#1361)、0b5fd602(#1448)与 ff2d3efea61a(#1486)推进至 99224562186a(#1494,@v0lumehi),累计推进 574 个上游提交(着色器链 df1800562702),新增波兰语与泰语游戏语言选项(#1486),并记录《塞尔达传说 时之笛》Switch 2 版在 Mac 上完整通关至演职员表(#1308、#1373,@ZhaowTao)以及《Fire Emblem Fortune's Weave》在 iPhone 18 Pro Max 上以 60 fps 实机验证通过(#1278)
  • 补丁队列从 91 个收敛至 58 个:自动合成 docs/env_switches.tsv,将 DmShell 迁入 frontend-ios/Shell,移除已被上游 pad_jc1 覆盖的自有 Joy-Con 驱动补丁(#1367、#1454,感谢 @paulcald90 反馈问题)与多项上游已吸收补丁,并补入 Nintendo Switch Sports Resort(04008E001F098000)着色器表重切分(#1480)、零 inode 构建种子修复(#1456、#1478、#1492),以及 main 重复着色器标签派生守卫与《星露谷物语》《集合啦!动物森友会》《前进!奇诺比奥队长》三款游戏着色器表刷新(#1501)
  • 精简 iOS 虚拟触控模式:移除单键按住与切换锁存模式,保留独立的 DM_TOUCH_SIZE 与 DM_TOUCH_STICK 设置(#1344)

修复

  • iOS 书架 CoverFlow 末卡挂死:用固定步长 HStack、纯渲染 .visualEffect、离散 .zIndex 与延迟选中提交替换 LazyHStack 与同步滚动位置回写,彻底消除冷启动滑至末卡时的 AttributeGraph 循环挂死(#1349、#1488)
  • Windows Oodle 解压模拟堆按需扩容:arm64_emu 支持以 64 MiB 步长按需扩容至最高 2 GiB 并按块大小动态放宽超时,消除大块着色器解压触发 emulated heap full (96 MB) 的问题(#1472、#1485)
  • 引擎通道切换与实验版防回退:记录 .upstream-date 提交日期以阻止实验版引擎回退至更旧的上游固定点,修复同版本候选包间切换升级与内置引擎版本角标刷新(#1475、#1489)
  • Windows 与 exFAT 零 inode 构建种子、win.shim 领养、.engine-id CRLF 与过期 v0 profile:在 st_ino == 0 路径改用 realpath 检测目录环路,在 build_seed.py 与 build_ipa_from_nsp.py 中拦截或清理不匹配的残留 work/profile 目录(#1456、#1478、#1492),在 Windows 领养已有 _build 目录及打包壳着色器时注入 nspb_qt.win.shim,并归一化 CRLF 换行使 Mac 与 Windows 的 .engine-id 哈希完全一致(#1499)
  • 重复 main 着色器标签派生与着色器表刷新:在仅因上游 main 重复着色器去重顺序变更导致键差异时安全派生 shader_map.tsv 覆盖 22+ 款游戏,并用完整切分刷新《星露谷物语》《集合啦!动物森友会》《前进!奇诺比奥队长》三款游戏着色器表(#1501)
  • A15 与 A16 多核 CPU BC 纹理解码与拷贝:在较旧设备上启用多核并行 CPU BC 纹理解码,支持 CPU BC 缓冲区到纹理拷贝并拒绝不支持的 BC 回读(#446、#777、#1440、#1442,@v0lumehi)
  • iOS 渲染目标堆收敛、Arena 基址锁存与《Super Mario Party》NVN 修复:补丁 0055 在低内存下自适应收敛 DM_NVN_RT_RECYCLE 放置堆上限并与上游 RH_SLACK 合流(#1329、#1486),nvn_mtl 在嵌套二次分配前锁存可扩容 Arena GPU 基址(#1378),并修复别名虚拟池标志、哨兵采样器越界误报与 dm_gfx_teardown 跨会话重置(#1227、#1312、#1486)
  • iOS 音频混音爆音、退出释放、机身陀螺仪回退与快捷指令闪退:为 1024 帧混合回调增加无锁预缓冲并撤回导致 3D 画面拉伸的宽屏补丁 0060(#1438),原子化音频退出释放在关闭前排空 AudRen 线程消除 SIGTRAP(#1305、#1314、#1395),手柄无陀螺仪时保留手机机身陀螺仪接管(#971、#1365),将 PhotoKit 存图移出 @MainActor 消除闪退(#1437),移除补丁 0027 重复震动钩子并稳定设置页面切换动画(#1324、#1325)
  • GL 与 Vulkan 构建种子自愈、续签回执与空间清理:保留共享 IPA 导出后的设备续签回执,自动推断并自愈 OpenGL 与 Vulkan 构建种子(#1396、#1438),着色器库写满磁盘后清理残缺 .part 文件(#1281,@Haseenesss),重编时不再重复统计已解包游戏体积(#1257,@Haseenesss),并使构建阶段名完整随启动器语言本地化(#1256,@Haseenesss)
  • Mac 多程序宿主、Windows 打包契约对齐、工具链诊断与本地化:补充多程序 Mac 宿主缺少的 input_preferences_mac.h 头文件(#1316,@gxt43),对齐 Windows iOS 打包器 build_app.py、IOS_CPU 与 build_ipa.sh 契约(#1414),在 CET 拦截环境下通过 dotnet 启动工具并补充信号保护与动态 metal-tt 查找(#1315,@1804328),加固 Defender 提权脚本(#1317),无 Defender 的精简版 Windows 自动跳过提示并直接诊断缺失 Visual C++ 2015-2022 (x64) 运行库及 NTSTATUS 编译器崩溃(#1355),并更新德语本地化校验(#1359)
  • Switch 2 Edition NUP 识别、Qt 快刷、导出签名、下拉竞态、测试与 Git 钩子:按最高程序号识别 Switch 2 Edition NUP(#1353、#1375,@Haseenesss),将 Qt 快刷构建参数从 --progress json 修正为 --progress lines(#1496),为导出独立 .framework 的签名命令补齐 --identifier <hostBundleID>(#1495),修复并发焦点更新时打开下拉框的宿主竞态(#1498),“实验性”徽章仅标在 nxkit 旁,其引擎行不再显示“切换”,并新增在 v0lumehi/nxkit 新建 issue 的“发送反馈”按钮(#1505),修复 P3 广色域屏幕像素测试读取 sRGB(#1464,@1Bartosz),在连接鼠标的 Mac 上为 RowEdgeTests 启用叠加滚动条(#1402,@odonnellmatt),以及在 Git 钩子检查补丁队列时拦截读取未提交工作区文件的情况(#1078,@Fbenhaddou)

已知问题

  • 《王国之泪》与《时之笛》着色器拆分偶发停顿:由于上游已将 dm/gfx/tools/shader_split.py 纳入 DMSH_CHAIN 输入,遵循着色器链规则移除补丁 0024 后,上述两款游戏的着色器拆分在 seedds/nxnative#1463 合入上游前可能再次出现 zstd 解压停顿(#1448)
  • 首次启动重建已构建的 NVN 游戏:由于着色器链已更新至 df1800562702,此前构建的 NVN 游戏在更新后首次启动需重新构建一次(#449)
  • 收官修复的真机覆盖范围:在完成 iPhone 17 Pro Max 与 Windows 11 实机验收后,CoverFlow 末卡挂死修复(#1488)尚待物理 iPadOS 26 平板复测,Windows 大块 Oodle 解压扩容(#1485)尚待大型 Oodle 游戏全量实机重编复核

系统要求

  • iOS 或 iPadOS 26 及以上版本
  • 在 Mac 上构建 NVN 游戏:Xcode 27.2 与 macOS 26.6 及以上版本

Install: download NX2Apple-macOS-arm64.zip, unzip, drag it to Applications. 中文:下载后解压,拖进「应用程序」。


What's Changed

Fixes

  • iOS: a controller with no gyroscope leaves the phone's gyro in charge (#971) by @LNPANDY in #1365
  • patches: keep game saves safe when the library moves, a copy fails, or the drive is HFS+ (#1118) by @v0lumehi in #1436
  • patches: decode CPU BC buffer-to-texture copies and reject unsupported BC readbacks (#446) by @v0lumehi in #1440
  • Mac launcher: the Builds tab opens as fast as before #1392 by @v0lumehi in #1443
  • patches: decode BC textures across the CPU's cores on older devices (#777) by @v0lumehi in #1442
  • patches: a game framework's copies are clones of the build's own outputs (#832) by @v0lumehi in #1449
  • patches: drop our Joy-Con driver, upstream's pad_jc1 covers it by @v0lumehi in #1454
  • Engine bump: move the pin to 99224562186a by @v0lumehi in #1494
  • launcher: Experimental badge only on nxkit, no Switch on its row, Send feedback to v0lumehi/nxkit by @v0lumehi in #1505

Patch queue and engine

  • patches: synthesize docs/env_switches.tsv and drop 14 obsolete patches by @LNPANDY in #1214
  • ShellHost & Launcher: hot-load signed game frameworks from Documents/Frameworks by @LNPANDY in #1217
  • chore(engine): sync upstream to 0c078130f6db by @LNPANDY in #1226
  • fix(engine): inherit aliased virtual pool flags and bound sampler pool IDs by @LNPANDY in #1227
  • feat(ios): allow mixing game audio with other apps via DM_AUDIO_MIX (#1269) by @LNPANDY in #1300
  • feat(ios): append developer Team ID to default single-game bundle ID (#1143) by @LNPANDY in #1302
  • fix(ios,launcher,qt): iOS 27 hot push, shell focus & teardown guards, pad quit hint, and queue/export UX by @LNPANDY in #1305
  • feat(engine,ios,launcher,qt): support DMMSLTR1 shader trailers and named .img files by @LNPANDY in #1270
  • feat(engine,ios,launcher,qt): strip framework msl and wire DMMSLTR1 trailer pipeline by @LNPANDY in #1295
  • feat(engine,launcher,qt): add persistent build seed cache for fast game refresh by @LNPANDY in #1296
  • chore(engine): sync upstream to 5a4e23a2e952 by @LNPANDY in #1312
  • patches: build the Mac host of a multi-program game (input_preferences_mac.h) by @gxt43 in #1316
  • fix(patches): drop duplicate forced vibration hooks in 0027 after upstream sync by @LNPANDY in #1324
  • ios: remove touch controls hold and toggle mode by @LNPANDY in #1344
  • Patch 0056: a failed shader library image leaves no .part on a full drive (#1265) by @Haseenesss in #1281
  • chore(engine): sync upstream to 94a0944755da by @LNPANDY in #1361
  • patches: save arena GPU address before nested allocations in nvn_mtl by @LNPANDY in #1378
  • feat(patches,launcher): support full-screen aspect ratios and game library badges by @LNPANDY in #1377
  • feat(ios,launcher,qt): Add to Home Screen guide, live settings, .framework export, and #1314 audio fix by @LNPANDY in #1395
  • fix(launcher,qt,patches): preserve Re-sign device receipt and infer GL/Vulkan build seeds by @LNPANDY in #1396
  • fix(patches,launcher): drop widescreen 0060 and fix seed RomFS guard, iOS audio mix crackling, and GL/VK seed validation by @LNPANDY in #1438
  • patches: resplit 04008E001F098000 shader_map.tsv by @LNPANDY in #1480
  • Engine bump: sync upstream nxnative to ff2d3efea61a by @LNPANDY in #1486
  • patches: fix zero-inode build seed loop and stale seed profile handling by @LNPANDY in #1492
  • iOS shell README: a shell built from the scripts alone puts the shaders on the game image (#1327) by @Haseenesss in #1341
  • patches: derive shader map on main duplicate label shifts and refresh 3 game maps by @LNPANDY in #1501

Documentation

  • chore(release): prepare v1.5.0 by @LNPANDY in #1228
  • docs: record Fire Emblem Fortune's Weave verified on iPhone 18 Pro Max (#1143) by @LNPANDY in #1278
  • fix(tests,docs): allow dep.vcredist in German l10n test and update v1.5.0 notes by @LNPANDY in #1359
  • docs: record Ocarina of Time on a Mac, up to inside Ganon's Castle by @ZhaowTao in #1308
  • Mac: unify desktop launcher and console workflows by @jonochocki in #1392
  • feat(mac): isolate refresh queues from drafts and add USB link-speed transfer modal by @LNPANDY in #1483
  • Update v1.5.0 release notes, changelog, and game update catalog by @LNPANDY in #1491
  • GAMES: Ocarina of Time now reaches the staff roll by @ZhaowTao in #1373
  • docs: supplement v1.5.0 release notes and changelogs through #1494 by @LNPANDY in #1497
  • feat(launcher): restore top Build engine switcher with nxkit (Beta) by @LNPANDY in #1498
  • docs: update v1.5.0 release notes and changelog for #1498 #1499 #1501 by @LNPANDY in #1504

Other changes

New Contributors

Full Changelog: v1.4.0...v1.5.0

Don't miss a new NX2Apple release

NewReleases is sending notifications on new releases.