Skip to content

NX2Apple v0.4.8 — 启动器装到设备、手柄导航、Mods / the launcher: install to a device, a controller, mods

Choose a tag to compare

@github-actions github-actions released this 27 Oct 12:41
· 1779 commits to main since this release

What this release does

Almost everything here is the Mac launcher. It can now install an iPhone build straight onto a paired device, the library navigates with a controller (no keyboard from the couch), the launch options are split into basic and advanced with a Mods section, the render scale shows as real pixels, window or fullscreen is a choice, and keys and controller buttons can be remapped. It updates its own checkout when it opens (only on main, with no local changes, and no build running), and a new version now opens a sheet that says what changed instead of only naming a tag.

New

  • Install on a paired iPhone / iPad: pick the device and signing team in the launcher; the build is signed and installed with Xcode's automatic signing, and the game data is copied into the app's Documents — a reinstall sends only what changed.
  • A controller drives the whole launcher: D-pad or left stick moves, A activates, B goes back, X opens the selected game's launch options, L/R switch pages. It ignores the controller while a game is in front.
  • Launch options split into basic and advanced — frame rate, render scale, console mode, language and rumble first; the rest behind an "Advanced settings" row that says how many it holds.
  • Mods: each folder under <games folder>/mods/<title ID>/ gets a switch; enabled ones ride on DM_ROMFS_OVERLAY, and the one higher in the list wins when two replace the same file.
  • The render scale shows real pixels (1280×720), following the console mode; display mode is window or fullscreen.
  • Keys and controller buttons are remappable: Settings → Controls → Customize — click a field and press the new key; one key holds one function.
  • The build tools update themselves when the app opens: a fast-forward, only when the checkout is on main, has no local changes and no build is running.
  • A new-version sheet: it names both versions and what changed, with Update now or Later.

Fixes

  • Every rewrite of every game crashed (patch_nso.py used TEXT_LO before defining it). Fixed, and the NRO header skip now uses code_start().
  • The Mac app refused every build with "requires Python 3.12": the interpreter floor was set to 3.9, and a build could start before the dependency check finished and fall back to Apple's 3.9. Both fixed.
  • A folder holding several games could not build any of them: the picked game is now staged on its own, with its update and add-on content.
  • A failed build said "exit code 1 — see the log below" with the log off screen: the note now names the last real line, and the log sits under the Mac/iPhone choice and scrolls into view.
  • A Chinese Windows showed an English interface: locale.getlocale() returns a locale name on Windows, and the branch that asked the Windows API was unreachable.
  • A newer release with no download for this build reported "up to date" instead of saying it could not find its own asset — an install could sit on an old version for ever without knowing.
  • The iOS build is fixed (two undefined macros in main.m); a RomFS directory opened with a trailing slash is found (Bayonetta 3's opening movie plays); rebuilding on an external exFAT work folder no longer crashes.
  • .NET's first-run configure failed (.NET 10 needs TMPDIR); an Intel Python under Rosetta now says so before the build starts instead of failing at the shader step with an empty message.

Known issues

  • The launcher (several games in one app) is not built yet; the runtime profile that it stands on is merged.
  • Mods have not been played with a real mod yet: the four folder layouts and the environment string are verified; the actual overlay is not.
  • The Windows build is not provided on this page: these changes are waiting for verification on real hardware. The Actions artifact NS-Port-Builder-qt-windows-x64 has a preview build.

Install

  • macOS: download NX2Apple-macOS-arm64.zip, unzip, then right-click → Open on first launch. If you are on 0.4.7 or earlier, download this one by hand — the app was renamed from nxnative to NX2Apple and the old updater looks for the old asset name; in-app updates work from this version on.
  • The previous asset names nxnative-macOS-arm64.zip and NS-Port-Builder-macOS-arm64.zip carry the same build.
  • Windows: not provided on this page.

Credits

  • v0lumehi — install on a paired device (#28), CI and tests (#48, #51), the four launch-option PRs (#54–#57), the TEXT_LO crash I shipped (#59), and the build-tools update (#60).
  • QID-Rob — .NET's first-run configure needs TMPDIR (#50).
  • ufooer — the Rosetta check and the multi-game folder idea (#31, partly adopted).

这一版做了什么

这一版几乎全在 Mac 启动器上。现在能直接把 iPhone 版装到配对的设备上,游戏库支持手柄导航(躺在沙发上不用键盘),启动选项分成了基础与高级两组并加了 Mods 区,Render scale 显示成真实分辨率,窗口/全屏可选,键位和手柄按钮也能自己改。启动时会自动把仓库更新到最新(只在你没有本地改动、也没在构建时),并且发现新版本时会弹窗说明这一版改了什么,而不是只给你一个版本号。

新增

  • 装到配对的 iPhone / iPad:在启动器里选设备和签名团队,构建完直接签名并安装(走 Xcode 的自动签名),游戏数据单独拷进 App 的 Documents,重装只传改动过的文件。
  • 手柄导航整个启动器:十字键/左摇杆移动,A 确认,B 返回,X 打开该游戏的启动选项,L/R 翻页。游戏在前台时启动器不响应手柄。
  • 启动选项分基础/高级:基础是帧率、渲染比例、主机/掌机模式、语言、震动;其余收在「高级设置」里并显示条数。
  • Mods:<游戏目录>/mods/<title ID>/ 下的文件夹各有一个开关,开启后通过 DM_ROMFS_OVERLAY 叠加到游戏数据上,列表靠前的优先。
  • Render scale 显示真实分辨率(如 1280×720),随主机/掌机模式变化;显示模式可选窗口或全屏。
  • 键位与手柄按钮自定义:设置 → 操作 → 自定义,点击后按新键,一个键只承载一个功能。
  • 启动时自动更新构建工具:只在自己的 checkout 位于 main、无本地改动、且没有构建在跑时才 fast-forward。
  • 新版本弹窗:说明当前版本、新版本、这一版改了什么,可以「现在更新」或「稍后」。

修复

  • 每一款游戏的每一次重写都会崩(patch_nso.py 的 TEXT_LO 先用后定义)。已修,并改用 code_start() 正确跳过 NRO 头部。
  • Mac 版建不了任何东西,报「需要 Python 3.12」:解释器版本下限写成了 3.9,且构建可能在依赖检查完成前就开始、回退到系统的 3.9。两处都修了。
  • 一个文件夹里有多款游戏时一款都建不了:现在只把选中的游戏(连同它的更新和 DLC)临时复制出去构建。
  • 构建失败只说「退出码 1,见下方日志」,而日志在窗口外:现在消息带上最后一行真实日志,日志面板移到 Mac/iPhone 选择下方并自动滚入视野。
  • Windows 中文系统显示英文界面:locale.getlocale() 在 Windows 返回的是语言名而不是 zh 代码,那段问 Windows API 的分支还因为一个条件永远不执行。
  • 有新版本但找不到对应安装包时报「已是最新」,而不是说明取不到——旧版本可能永远停在老版本上而不自知。
  • iOS 构建修好了(main.m 两处宏未定义);RomFS 带尾斜杠的目录现在能找到(《猎天使魔女 3》的过场动画因此能播);外置 exFAT 工作目录重建不再崩溃。
  • 依赖面板里 .NET 首次运行失败(.NET 10 需要 TMPDIR);Rosetta 下的 Intel Python 会在构建开始时就明确报错,而不是在 shader 步骤给出空错误。

已知问题

  • 启动器(一个 App 里放多个游戏)还没做;运行时 profile 是它的地基,已合入。
  • Mods 还没有用真实 mod 玩过:四种目录布局和环境变量都验证了,实际叠加效果待确认。
  • Windows 版本页不提供:这批改动在等真机验证。想提前试可从 Actions 的 NS-Port-Builder-qt-windows-x64 构建产物取。

安装

  • macOS:下载 NX2Apple-macOS-arm64.zip,解压后首次启动右键 → 打开。0.4.7 及更早的版本请手动下载这一次——应用名从 nxnative 改成 NX2Apple,旧版的自更新找不到新名字的包;从这一版起应用内更新正常。
  • 旧文件名 nxnative-macOS-arm64.zip 和 NS-Port-Builder-macOS-arm64.zip 指向同一个包。
  • Windows:本页不提供。

致谢

  • v0lumehi — 装到配对设备(#28)、CI 与测试(#48、#51)、启动选项四项(#54–#57)、修掉我引入的 TEXT_LO 崩溃(#59)、启动时更新构建工具(#60)。
  • QID-Rob — .NET 首次运行需要 TMPDIR(#50)。
  • ufooer — Rosetta 检测、多游戏文件夹的思路(#31,部分采纳)。