Repository navigation
NX2Apple v0.4.8 — 启动器装到设备、手柄导航、Mods / the launcher: install to a device, a controller, mods
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 onDM_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.pyusedTEXT_LObefore defining it). Fixed, and the NRO header skip now usescode_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-x64has 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.zipandNS-Port-Builder-macOS-arm64.zipcarry 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_LOcrash 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:本页不提供。