Repository navigation
v1.5.0: Multiple build engines, hot framework loading, and Dark Glass / 多构建引擎、游戏框架热加载与暗色液态玻璃
Latestv1.5.0: Multiple build engines, hot framework loading, and Dark Glass / 多构建引擎、游戏框架热加载与暗色液态玻璃
English
Highlights
- Multi-engine workbench (#1368, #1370, #1372, #1374, #1405, #1455, #1473, #1474, #1498): Switch engines in one click from the top of
BuildsorSettingsbetweennxnative, self-updatingnxkit 0.10.3 (Beta)with Ed25519 signature verification, and turnkeyMacNativeGamesguarded to its 5 maintained titles (MNGbadges) for first-party Mac play, withS2ArmbehindNX2APPLE_ENABLE_S2ARM=1. - Faster rebuilds and incremental refresh (#1296, #1299, #1322, #1323, #1483): Version 1.5.0 builds persist
build-seedscaches so most updates run fast batch refreshes in minutes without the original game package or intermediate build directories, isolated from unstarted build drafts. - Install new games without reinstalling the shared shell IPA (#1217, #1305, #1437, #1493, #1495): Export signed or unsigned
DmGame.frameworkbundles intoDocuments/Frameworks, import a.p12sideload certificate on iOS for on-device framework signing (#1493), or hot-push directly on iOS 27 (glueVersion: 2), with no shell IPA reinstall required. - Slim shared shell IPA (#1216, #1229, #1270, #1295, #1439):
DMMSLTR1shader trailers and optional bundled payloads move into external.imgarchives so the sharedNX2Apple.ipastays a few tens of megabytes for easier sideload signing, paired with foregroundkqueue.nxpartauto-joining (#1481). - Full Shortcuts support (#1395, #1437): Built-in 6-step Add to Home Screen guide and an optional Picture-in-Picture walkthrough card support
nx2apple://launchhome screen icons and controller-connect auto-launch shortcuts. - 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-idCRLF hashes, and exFAT zero-inode build seed loops (#1456, #1478, #1492, #1499), aligns iOS packager contracts, and improves CET, Defender, and Visual C++ diagnostics. - Background audio mixing (#1300, #1438):
DM_AUDIO_MIXlets music or podcasts keep playing into a game without stopping or lock-free callback crackling, alongside atomic audio teardown andAudRenthread draining (#1305, #1314, #1395). - 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.5across a 102-game catalog with 80 titles updated in1.5.0) so players know when to rebuild. - 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.
- 574-commit engine leap from
ccd834e0to99224562186a(#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 topBuildPageEngineSwitcherCardorSettingswith short version badges, one-click updates, and an in-cardMacNativeGamesrecommendation bar, trynxkit 0.10.3 (Beta)on Apple silicon Macs with signed Ed25519 self-updates, runMacNativeGameswith rootless Python 3.14 and shared fonts guarded to its 5 officially maintained titles (MNGbadges), keepS2Armhidden behindNX2APPLE_ENABLE_S2ARM=1by default, and omit--updateand--dlcflags on unencrypted.nupand dump folder inputs (#1368, #1370, #1372, #1374, #1405, #1455, #1473, #1474, #1498) - Hot-loaded iOS frameworks,
.p12on-device signing, iOS 27 hot push, and live.nxpartjoining:ShellHostand the launchers load signedDmGameframeworks fromDocuments/Frameworks, expire stale frameworks on newer shell builds (glueVersion: 2), support host-signed hot push on iOS 27, standalone.frameworkexport with signing team or unsigned sideload selection (#1495),.p12sideload certificate import with Keychain storage and on-device framework signing (#1493), and a foregroundkqueuedirectory watcher that auto-joins streaming.nxpartparts once quiet (#1217, #1305, #1395, #1437, #1481) - 6-step Home Screen guide and PiP walkthrough:
nx2apple://launchshortcuts gain a 6-step guided setup with an optional zero-extensionAVPictureInPictureControllerfloating walkthrough card (#1395, #1437) - Build seeds, draft isolation, USB link-speed modal, and
.imgrecovery: persistent build seeds power fast incremental refreshes, Mac and Qt sync a 102-game update catalog (80 updated in1.5.0) with release badges, refresh batches stay isolated from unstarted build drafts, Mac builds detectIOUSBHostDevicelink 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.imgfiles (#1296, #1299, #1322, #1323, #1439, #1483) DMMSLTR1trailers, APFS clones, shared IPA repacking, and loose.imgclaiming:DMROMFS1images hold 16 KiB-alignedDMMSLTR1shader trailers, framework-only builds stripmslinto.msl-cacheand remind players to replace outdated.imgcopies, 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.imgname is accepted, iOS claims matching loose images inDocumentson launch (#1216, #1229, #1270, #1295, #1439), and the iOS shell README documents script-onlyDMMSLTR1image 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, chunkedtitledb), extracts offline NACP icons, backfills missing iOS covers with synthesized512x512square fallback icons (#1457, #1467), resolves officialec.nintendo.com/apps/<TID>/US|HKbanners 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
BuildQueuewith 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_MIXmixes 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
ccd834e0through0c078130(#1226),5a4e23a2(#1312),94a09447(#1361),0b5fd602(#1448), andff2d3efea61a(#1486) to99224562186a(#1494 by @v0lumehi) across 574 upstream commits on shader chaindf1800562702, 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.tsvis synthesized automatically,DmShellmoves underfrontend-ios/Shell, superseded patches and our custom Joy-Con driver (covered by upstreampad_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), duplicatemainshader 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_SIZEandDM_TOUCH_STICKsettings (#1344)
Fixed
- iOS Cover Flow tail-scroll hang: replaced
LazyHStackand synchronous.scrollPositionfeedback with a fixed-strideHStack, 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_emugrows 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 withemulated 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.shimadoption,.engine-idCRLF, and stalev0profiles: fell back torealpathloop keys whenst_ino == 0, rejected or cleaned mismatchedwork/profilefolders inbuild_seed.pyandbuild_ipa_from_nsp.py(#1456, #1478, #1492), injectednspb_qt.win.shimwhen adopting existing_buildfolders or packing shell shaders on Windows, and normalized CRLF line endings so Mac and Windows.engine-idhashes match (#1499) - Shader map duplicate
mainlabel derivation and refreshed tables: derivedshader_map.tsvsafely when only duplicatemainshader 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
0055convergesDM_NVN_RT_RECYCLEheap caps on iOS alongside upstreamRH_SLACK(#1329, #1486),nvn_mtllatches arena GPU base addresses before nested allocations (#1378), and aliased virtual pool flags, sentinel sampler bounds, anddm_gfx_teardownstate 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 drainedAudRenthreads 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 in0027(#1324), and stabilized game settings transitions (#1325) - GL/VK build seeds, Re-sign receipts, and build space cleanup: preserved shared shell
installedDevicereceipts after IPA exports, inferred and self-healed GL and Vulkan build seeds (#1396, #1438), cleaned failed shader.partfiles 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.hfor multi-program Mac hosts (#1316 by @gxt43), aligned Qt'sbuild_app.pyandIOS_CPUwithbuild_ipa.sh(#1414), ran CET-blocked .NET tools viadotnetwith POSIX signal guards and dynamicmetal-ttlookup (#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 jsonto--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 tonxkit, 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 inRowEdgeTestson 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
0024for the shader chain rule means zstd hangs during shader splitting on these two titles can return untilseedds/nxnative#1463lands 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
中文
重点
- 多构建引擎支持(#1368、#1370、#1372、#1374、#1405、#1455、#1473、#1474、#1498):恢复构建页顶部引擎选择器并与设置页同步,新增开箱即用且限定 5 款官方维护游戏(含
MNG徽章)的MacNativeGames与内置 Ed25519 验签自更新的nxkit 0.10.3 (Beta),一键切换构建引擎并强化第一方大作 Mac 端体验,默认通过NX2APPLE_ENABLE_S2ARM=1隐藏实验性S2Arm。 - 重构大提速与快速刷新(#1296、#1299、#1322、#1323、#1483):
1.5.0构建持久化build-seeds种子缓存,大多数更新不再需要原始游戏包或中间构建目录,几分钟即可批量快刷,且刷新批处理与未开跑的草稿完全隔离。 - 装新游戏免重装壳 IPA(#1217、#1305、#1437、#1493、#1495):可导出已签名或未签名的
DmGame.framework放入Documents/Frameworks,在 iOS 壳导入.p12证书就地重签(#1493),或在 iOS 27 上直接宿主签名热推送(glueVersion: 2),无需反复重装壳 IPA。 - 共享壳 IPA 大瘦身(#1216、#1229、#1270、#1295、#1439):
DMMSLTR1着色器尾块与非必须内置文件合入外部.img镜像,共享壳NX2Apple.ipa仅数十 MB,大幅便于侧载签名,并配合前台kqueue监听与稳态.nxpart自动合片(#1481)。 - 全面支持快捷指令(#1395、#1437):内置 6 步添加到手机主屏幕向导与零扩展画中画(PiP)悬浮跟步教程,支持
nx2apple://launch桌面图标直开游戏及连接手柄自动启动等快捷指令操作。 - Windows 构建大幅进化(#1249、#1253、#1255、#1315、#1317、#1355、#1414、#1447、#1485、#1492、#1499):新增通用多游戏批量构建队列
BuildQueue,模拟堆按需扩容至 2 GiB 解决《宝可梦 紫》等大块 Oodle 着色器解压报错,修复 Windows 种子领养路径、.engine-idCRLF 哈希一致化及 exFAT 零 inode 构建种子误报(#1456、#1478、#1492、#1499),对齐 iOS 打包契约并加强 CET、Defender 与 Visual C++ 诊断。 - 后台音频混音(#1300、#1438):
DM_AUDIO_MIX支持后台播放音乐或播客进入游戏不停止且无爆音,配套原子音频退出释放与AudRen线程排空(#1305、#1314、#1395)。 - 游戏专属更新版本标识(#1296、#1457、#1458、#1486):「支持的游戏」列表与主图卡片展示各款游戏最近优化的 NX2Apple 版本号(如
1.5,覆盖 102 款目录游戏中的 80 款本轮新增或优化游戏),方便判断是否需要重编。 - 启动器界面全面进化(#1392、#1443、#1457、#1458、#1459、#1467、#1468、#1474、#1484):全系升级为深邃暗色液态玻璃(Dark Glass)设计系统并重制双栏主机模式,配三级桌面横幅回退、三端任天堂商店 Switch 2 横幅兜底与 iOS 16:9 交互式封面裁剪。
- 跨越 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 或资源管理器及 iPhoneDocuments的三向缺失.img恢复引导(#1296、#1299、#1322、#1323、#1439、#1483) DMMSLTR1着色器尾块、APFS 克隆加速与松散镜像认领:DMROMFS1镜像支持尾部 16 KiB 对齐的DMMSLTR1着色器子镜像,仅框架构建剥离内嵌msl至.msl-cache并提醒用户替换旧.img副本,框架产物拷贝采用cp -cAPFS 克隆提速(#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-idCRLF 与过期v0profile:在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
- Launcher & ShellHost: externalize oversized msl shaders, repack shared IPA, and batch-transfer games by @LNPANDY in #1216
- feat(ios): claim loose RomFS images in Documents by identity by @LNPANDY in #1229
- feat(launcher,qt): add game update catalog, batch refresh queue and missing img recovery by @LNPANDY in #1299
- Qt: Copy diagnostics names each dependency (#1183) by @Haseenesss in #1249
- Launcher: a failed build notifies again, and in front too by @Haseenesss in #1100
- Qt: deleting a game takes it out of the shared iPhone app (#1221) by @Haseenesss in #1253
- Settings: choose the display a game opens on (#1092) by @Haseenesss in #1283
- Console mode: a click selects a tile first, and the wheel moves between rows (#1104) by @Haseenesss in #1289
- Console mode: Build or Add to queue on the page of a game that is not built (#1111) by @Haseenesss in #1292
- fix(qt): run Windows Defender elevation via BOM script and strip CLIXML progress by @LNPANDY in #1317
- fix(ios): stabilize game settings segmented and switch transitions by @LNPANDY in #1325
- fix(win): run CET-blocked .NET tools through dotnet, stand in for SIGHUP, look up metal-tt by @1804328 in #1315
- fix(launcher,qt): sync 56-game update catalog and detect older iOS builds by @LNPANDY in #1323
- fix(launcher,qt): show catalog update versions, refresh actions, and .img guidance by @LNPANDY in #1322
- Windows: diagnose stripped Defender and missing VC++ / shader prereqs by @LNPANDY in #1355
- Builds page: stage names follow the launcher's language, and "check files" has one (#1115) by @Haseenesss in #1256
- Build space check: a build again does not count the game files it extracted before (#1243) by @Haseenesss in #1257
- Qt: deleting a game moves its files to the Trash, as the dialog says (#1254) by @Haseenesss in #1255
- feat(core,qt): add multi-upstream registry and external Mac bundle recognition by @LNPANDY in #1368
- feat(core,model,launcher): integrate Mac-only MacNativeGames builder by @LNPANDY in #1370
- feat(core,model,qt): add S2Arm external builder integration by @LNPANDY in #1372
- feat(launcher): add top builder engine switcher with on-demand download by @LNPANDY in #1374
- launcher: replace engine cards with dropdown switcher and simplify top bar by @LNPANDY in #1405
- fix(ios): avoid PhotoKit main-actor trap, add 6-step Home Screen PiP guide, and bump host beacon by @LNPANDY in #1437
- fix(launcher,qt): add updated .img replacement reminder, upstream preflights, and export polish by @LNPANDY in #1439
- feat(qt): add general multi-game BuildQueue to Windows/Linux launcher by @LNPANDY in #1447
- fix(mng): omit --update and --dlc for unencrypted .nup and dump folder inputs by @LNPANDY in #1455
- Launcher: built-first library, single-screen Builds, and offline NACP artwork by @LNPANDY in #1457
- Align Windows iOS packager contracts with build_ipa.sh by @LNPANDY in #1414
- feat(ios): interactive 16:9 cover picker, cropper, and missing banner backfill by @LNPANDY in #1468
- fix(artwork): 3-tier banner lookup, on-demand iOS backfill, and fallback square icons by @LNPANDY in #1467
- feat(launcher): upstream engine version badges, turnkey MNG setup, and 5-title guardrails by @LNPANDY in #1473
- fix(ios): auto-join .nxpart split files in foreground and on reload by @LNPANDY in #1481
- feat(artwork): add Nintendo eShop Switch 2 banner fallback across Mac, iOS, and Qt by @LNPANDY in #1484
- Fix Windows Oodle emulated heap full on large blocks by @LNPANDY in https://github.com/LNPANDY/NX2Apple/pull/1485
- fix(ios): break CoverFlow AttributeGraph cycle on tail scroll by @LNPANDY in https://github.com/LNPANDY/NX2Apple/pull/1488
- feat(ios): add .p12 sideload certificate import and on-device framework signer by @LNPANDY in https://github.com/LNPANDY/NX2Apple/pull/1493
- fix(qt): pass --progress lines for fast refresh builds by @LNPANDY in https://github.com/LNPANDY/NX2Apple/pull/1496
- fix(export): align framework codesign identifier and add unsigned sideload option by @LNPANDY in https://github.com/LNPANDY/NX2Apple/pull/1495
- Library: a Switch 2 Edition NUP is the game of its highest program (#1353) by @Haseenesss in https://github.com/LNPANDY/NX2Apple/pull/1375
- Tests: the two pixel tests read sRGB on a P3 display by @1Bartosz in https://github.com/LNPANDY/NX2Apple/pull/1464
- iOS shell tests: RowEdgeTests passes on a Mac with a mouse by @odonnellmatt in https://github.com/LNPANDY/NX2Apple/pull/1402
- Git hooks: stop when the patch queue check would read other files by @Fbenhaddou in https://github.com/LNPANDY/NX2Apple/pull/1078
New Contributors
- @1804328 made their first contribution in #1315
- @gxt43 made their first contribution in #1316
- @ZhaowTao made their first contribution in #1308
- @dependabot[bot] made their first contribution in https://github.com/LNPANDY/NX2Apple/pull/1102
- @1Bartosz made their first contribution in https://github.com/LNPANDY/NX2Apple/pull/1464
- @odonnellmatt made their first contribution in https://github.com/LNPANDY/NX2Apple/pull/1402
Full Changelog: v1.4.0...v1.5.0