Repository navigation

Releases

S2Arm v0.1.2 Latest

Latest

jhaizhou-ops released this 08 Nov 23:21

v0.1.2

e11a44b

中文

S2Arm v0.1.2 —— 修复 Windows 出包后装不上、Mac 启动崩溃等问题。 建议所有用户更新；已经在 Windows 上打过 iPhone 包的玩家，升级后需要重新打一次包（旧的产物已被清理）。

这一版修了什么

Windows：出包成功后装机不再报 container_stale（#32）：此前清理中间产物时把装机要用的 work/ 整个删了，装机时找不到产物；现在 Windows 上保留需要的部分，且识别软链和 junction、只删链接本身。
iPhone：起局自检的内存门槛不再误拦（#29）：手机已签上「提高内存上限」权限时，4500 MB 门槛只提示、不再拦截（权限没签的仍会拦）。大游戏在小内存机型上仍可能被系统结束，这是真实限制。
《密特罗德生存恐惧》启动崩溃（#25）：nvnBufferFinalize 先核魔数再读池指针；报告者在 Mac 上复测能进到开场剧情，我们的 iOS 真机局也过了原崩溃点。
Mac 局的程序号不再恒为 0（#28 附带）：着色器库的游戏号戳对上了，日志里「was built for game … not 0000…」那条红字消失。
出包：抽取缺口的合法空直连库不再被判成「直连库不全」，这类游戏不再因此出不了包；「打 ipa」失败时会带出真正的原因（#13）。
从源码构建：services/opus/build.sh 兼容 macOS 自带的 bash 3.2（#31）。

下载哪个

你的电脑	下载	安装
Apple 芯片 Mac	`S2Arm-mac-arm64.dmg`	打开 dmg，把 S2Arm 拖进「应用程序」。已装旧版直接替换，游戏库、密钥、存档不受影响。经过苹果公证。
Windows 10 / 11（64 位）	`S2Arm-windows-x64.zip`	解压到任意文件夹（路径别太深），双击 `S2Arm.exe`。整个文件夹都要留着。

需要什么：见 v0.1.0 说明。

已知问题

Windows 的 S2Arm.exe 还没有代码签名：第一次打开可能弹「已保护你的电脑」，点「更多信息 → 仍要运行」。
Diablo II: Resurrected 启动黑屏（#28）原因仍未找到，我们已在自己的 iPhone 上复现，还在查。
个别游戏仍可能出不了包或进不了局（例如《勇者斗恶龙创世小玩家2》目前出包失败）；遇到请「导出诊断包」后开 Issue。
Windows 上「出包 → 装机」：我们验证到出包后产物还在（天眼实测），但装机本身需要接 iPhone，我们没有端到端验证；如果你仍然装不上，请把错误摘要贴到 Issue。
这一版还没有自动更新，请手动下载安装。

致谢

感谢报告问题和提交修复的 @Aoldbald、@cszwdy、@neexuan、@Catnip202X。

SHA-256

d51b0bf2da3d81da3f6338736208c8d609d6c8b8d835c3ccda1c6bbf64c65c31  S2Arm-mac-arm64.dmg
6d914e27d2a1023d367c9d33cc7b27da2553df338d8c0783cf391a059fa9dbec  S2Arm-windows-x64.zip

源码提交 e11a44b

English

S2Arm v0.1.2 — fixes Windows installs failing after export, a Mac launch crash and more. Recommended for everyone; Windows players who already exported an iPhone package must export again after upgrading (the old products were cleaned up).

What's fixed

Windows: install no longer fails with container_stale after a successful export (#32): the cleanup used to delete the whole work/ folder that install needs; on Windows the needed parts are now kept, symlinks and junctions are recognised and only the link itself is removed.
iPhone: the start-up memory threshold no longer blocks wrongly (#29): when the phone already has the increased-memory-limit entitlement, the 4500 MB threshold only warns (without the entitlement it still blocks). Big games may still be killed on low-memory phones — a real limit.
Metroid Dread launch crash (#25): nvnBufferFinalize now checks the magic before reading the pool pointer; the reporter retested on Mac and reached the intro, and our iOS device run passed the original crash point.
The program id on Mac runs is no longer always 0 (#28, side fix): the shader-library stamp matches and the "was built for game … not 0000…" red line is gone.
Export: a legitimately empty direct library from the extraction gap is no longer judged "direct library incomplete", so such games can export; when the "build IPA" step fails it now reports the real reason (#13).
Building from source: services/opus/build.sh works with macOS's bash 3.2 (#31).

Which file

Your computer	Download	Install
Apple silicon Mac	`S2Arm-mac-arm64.dmg`	Open the dmg and drag S2Arm into Applications (replace the old one; library, keys and saves are kept). Notarized by Apple.
Windows 10 / 11 (64-bit)	`S2Arm-windows-x64.zip`	Unzip anywhere (short path) and run `S2Arm.exe`. Keep the whole folder.

Requirements: see the v0.1.0 notes.

Known issues

The Windows S2Arm.exe is not code-signed yet (SmartScreen: More info → Run anyway).
Diablo II: Resurrected black screen (#28): cause not found yet; we have reproduced it on our own iPhone and are investigating.
Some games may still fail to export or start (e.g. DRAGON QUEST BUILDERS 2 currently fails to export); please export the diagnostics package and open an Issue.
Windows export → install: we verified the products remain after export (tested on our Windows machine), but install itself needs an iPhone and was not verified end-to-end; if you still can't install, paste the error summary in an Issue.
There is no auto-update yet; please install manually.

Thanks

Thank you to everyone who reported issues and contributed fixes: @Aoldbald, @cszwdy, @neexuan, @Catnip202X.

Contributors

cszwdy, neexuan, and 2 other contributors

Assets 5

S2Arm v0.1.1

jhaizhou-ops released this 08 Nov 21:39

v0.1.1

891f16e

中文

S2Arm v0.1.1 —— 修复 v0.1.0 发布后用户反馈的出包与环境检查问题。 建议所有 v0.1.0 用户更新。

这一版修了什么

Windows：环境检查不再挡住导入和出包。 检测不出来 / 状态未知的项（Impactor、iCloud 等）只提示，不再让你卡在第 1 步。
Windows：出包不再误用 WSL 的 bash 存根（#26，embedded null character）。
Windows：诊断包可以通过控制口导出（s2armctl diag export）。
Mac：已解包目录 / Switch 2 dump 导入的游戏出包不再在解包阶段报 NameError: tempfile（#9）。
Mac：发版 App 出包时用自带的 Mac 宿主，不再现场编译（#8）：此前这类游戏会因为发版 App 里没有 .NET SDK 而失败，并被误报成「着色器抽取失败」。
Mac 启动器：顶栏按钮真实点击无效、Windows 设置页误报、几处走不下去的死路等上线缺陷（#7）。
错误摘要更具体：带上失败阶段、退出码和脱敏后的错误原文（#21）。
文档提示更安全：修 .NET 的补救提示不再让你 curl | bash，统一指向 python3 pack/jobs/applenv.py --install dotnet（#4）。

下载哪个

你的电脑	下载	安装
Apple 芯片 Mac	`S2Arm-mac-arm64.dmg`	打开 dmg，把 S2Arm 拖进「应用程序」。已装旧版直接替换，游戏库、密钥、存档不受影响。经过苹果公证。
Windows 10 / 11（64 位）	`S2Arm-windows-x64.zip`	解压到任意文件夹（路径别太深），双击 `S2Arm.exe`。整个文件夹都要留着。

需要什么：见 v0.1.0 说明（硬件、系统、Xcode / iTunes、自己的 prod.keys 和游戏文件，S2Arm 不提供任何游戏或密钥）。

已知问题

Windows 的 S2Arm.exe 还没有代码签名：第一次打开可能弹「已保护你的电脑」，点「更多信息 → 仍要运行」。
这一版不含对 Metroid Dread 启动崩溃（#25）的修复，它会在后续版本发布；Diablo II: Resurrected 黑屏（#28）原因还没找到。
个别游戏仍可能出不了包或进不了局（例如《勇者斗恶龙创世小玩家2》目前出包失败）；遇到请「导出诊断包」后开 Issue。
这一版还没有自动更新：请手动下载安装；自动更新会在以后的版本加入，到时 v0.1.0 / v0.1.1 用户需要手动装一次。
Windows 的 #26 修复我们没能在装了 WSL 启动器存根且没有发行版的机器上端到端复现，依据是单元测试；如果你仍在「八个轻阶段」失败，请把 ipa.log 贴到 Issue。

致谢

感谢报告问题和提交修复的 @lson-lee、@Darcelsan、@Aoldbald、@cszwdy、@neexuan、@kmmao、@Catnip202X。

SHA-256

92a3ec9db25508412298eab642818f39b49dcf3b4d398fb12ce0d9457aead740  S2Arm-mac-arm64.dmg
044da3c1b7d6a5492a169c4f518a3f06d5caa21587e37a682429f9002905c349  S2Arm-windows-x64.zip

源码提交 891f16e

English

S2Arm v0.1.1 — fixes for the export and environment-check problems reported after v0.1.0. Recommended for all v0.1.0 users.

What's fixed

Windows: the environment check no longer blocks import and export. Items that can't be detected or are unknown (Impactor, iCloud, …) now only warn instead of stopping you at step 1.
Windows: export no longer picks up the WSL bash stub (#26, embedded null character).
Windows: the diagnostics package can be exported through the control port (s2armctl diag export).
Mac: exporting a game imported as an unpacked folder / Switch 2 dump no longer fails with NameError: tempfile in the unpack stage (#9).
Mac: the release app now uses its bundled Mac host instead of compiling one during export (#8): such games used to fail because the release app has no .NET SDK, and the failure was misreported as a shader-extraction error.
Mac launcher: toolbar buttons that ignored real clicks, Windows setup false alarms and several dead ends (#7).
More specific error summaries: failing stage, exit code and the redacted original error text (#21).
Safer doc hints: the .NET remedy no longer tells you to curl | bash; it points to python3 pack/jobs/applenv.py --install dotnet (#4).

Which file

Your computer	Download	Install
Apple silicon Mac	`S2Arm-mac-arm64.dmg`	Open the dmg and drag S2Arm into Applications (replace the old one; library, keys and saves are kept). Notarized by Apple.
Windows 10 / 11 (64-bit)	`S2Arm-windows-x64.zip`	Unzip anywhere (short path) and run `S2Arm.exe`. Keep the whole folder.

Requirements: see the v0.1.0 notes (hardware, OS, Xcode / iTunes, your own prod.keys and games; S2Arm provides no games or keys).

Known issues

The Windows S2Arm.exe is not code-signed yet (SmartScreen: More info → Run anyway).
This version does not include the fix for the Metroid Dread launch crash (#25), which ships later; the Diablo II: Resurrected black screen (#28) has no known cause yet.
Some games may still fail to export or start (e.g. DRAGON QUEST BUILDERS 2 currently fails to export); please export the diagnostics package and open an Issue.
There is no auto-update yet: please install manually; auto-update arrives in a later release, and v0.1.0 / v0.1.1 users will need one manual install for it.
We could not reproduce the #26 fix end-to-end on a machine with a WSL launcher stub and no distro; it is covered by unit tests. If the light stages still fail for you, please paste your ipa.log in an Issue.

Thanks

Thank you to everyone who reported issues and contributed fixes: @lson-lee, @Darcelsan, @Aoldbald, @cszwdy, @neexuan, @kmmao, @Catnip202X.

Contributors

cszwdy, Darcelsan, and 5 other contributors

Assets 5

S2Arm v0.1.0

jhaizhou-ops released this 08 Nov 18:12

v0.1.0

3925321

中文

S2Arm v0.1.0：把你自己的 Switch 游戏，原生带到 iPhone、iPad 和 Mac。 游戏代码改写成原生 ARM64，直接在设备处理器上执行，图形直连 Metal；所有游戏装进同一个 App。Mac 和 Windows 各有一个图形启动器，点按钮就能出包、装机。

下载哪个

你的电脑	下载	安装
Apple 芯片 Mac	`S2Arm-mac-arm64.dmg`	打开 dmg，把 S2Arm 拖进「应用程序」。经过苹果公证，打开不用再放行。
Windows 10 / 11（64 位）	`S2Arm-windows-x64.zip`	解压到任意文件夹（路径别太深），双击 `S2Arm.exe`。整个文件夹都要留着。

下载后可用 SHA256SUMS.txt 核对。

需要什么

Mac：Apple 芯片，macOS 15 或更新；Xcode（App Store 免费装，装好打开一次）；用 Xcode 登录 Apple ID（免费的就行）来签名。
Windows：64 位 Windows 10 / 11；装 iTunes 或「Apple 设备」（让电脑认得 iPhone）。不用 Xcode：签名装机用随包附带的 Impactor（MIT，原版未改）。
你自己的 Switch 导出的 prod.keys 和游戏文件。S2Arm 不提供、也不下载任何游戏或密钥。
iPhone / iPad：A14 / M1 或更新芯片，iOS / iPadOS 18 或更新。

这一版有什么

一个 App 装整座游戏库；Mac 与 Windows 图形启动器：自检 → 游戏库 → 出包（每一步、总用时、预计剩余都看得见）→ 装到 iPhone，全程点按钮。
只走直连（已去掉通用 / 兼容模式）；出不了直连库的游戏会直接报明确原因。
普查结果（Mac 局，一次成功率）：196 / 205 = 95.6%（11-08 复算；分母 205 = 211 款减去 6 款不计入：原件损坏 4、要求 32 位架构 2）。

已知问题

Windows 的 S2Arm.exe 还没有代码签名：第一次打开可能弹「已保护你的电脑」，点「更多信息 → 仍要运行」。
Windows 版是解压即用的文件夹，还没有安装程序。
安卓、鸿蒙即将上线，现在还不能选。
暂不支持 32 位的游戏。
个别游戏出不了包或进不了局（例如《勇者斗恶龙创世小玩家2》目前出包失败，Mac 卡在改写主程序的一处跳转表，Windows 缺 GLSLC 工具模式）；遇到时请「导出诊断包」后开 Issue。
免费 Apple ID 签的 App 7 天过期，同时最多 3 个；到期在启动器里再点一次「装到 iPhone」，存档和资源都还在。

致谢

感谢 30 位联合开发者在内测期间的提交、复测和定位：@biglawine @yyan160 @DanielZhangyc @vickwv @Xc1Ym @fjack @ha7rock @yourmoonlight @qidian99 @n06ody @YTwsy @wdjwxh @realskyrin @wwmogu @quancunlau @moongrant @imyinyx @s-leeq @Zhangbu @retX0 @zh0ngtian @fengbird @zsakvo @1500256797 @BossaMelon @GayoZhao @sovaly @ruterfu @fyn1320068837-source @InTheManXG。

反馈

遇到问题请开 Issue，附上启动器里「导出诊断包」的文件。想参与：见 CONTRIBUTING.md 和带「可领取」标签的 Issue。

SHA-256

407c908cf43fb90d9f22a05ae46d113cfd2b77bcdad79be6d21aaa262460ab61  S2Arm-mac-arm64.dmg
42d19dd7ecd0e91211b452145e41c9f47a7a0677a98c71435651a83acfb67cbc  S2Arm-windows-x64.zip

源码提交 3925321b（公开仓首个提交）

English

S2Arm v0.1.0: run your own Switch games natively on iPhone, iPad and Mac. Game code is rewritten to native ARM64 and runs directly on the device's processor; graphics go straight to Metal; your whole library lives in one app. Graphical launchers for Mac and Windows take a game from import to install in a few clicks.

Which file

Your computer	Download	Install
Apple silicon Mac	`S2Arm-mac-arm64.dmg`	Open the dmg and drag S2Arm into Applications. Signed and notarized by Apple.
Windows 10 / 11 (64-bit)	`S2Arm-windows-x64.zip`	Unzip anywhere (keep the path short) and run `S2Arm.exe`. Keep the whole folder.

Verify with SHA256SUMS.txt.

Requirements

Mac: Apple silicon, macOS 15+; Xcode (free from the App Store, open it once); sign in to Xcode with an Apple ID (a free one works).
Windows: 64-bit Windows 10 / 11; iTunes or "Apple Devices" so the PC can see your iPhone. No Xcode needed: Impactor (MIT, unmodified) is bundled for signing and installing.
Your own prod.keys and game dumps from your own Switch. S2Arm does not provide or download games or keys.
iPhone / iPad with A14 / M1 or newer, iOS / iPadOS 18+.

What's in this release

One app for the whole library; graphical launchers on Mac and Windows: self-check → library → export (per-step progress, elapsed and remaining time) → install to iPhone.
Direct mode only (the generic/compat mode is removed); games that cannot build a direct library fail with a clear reason.
Census result (Mac runs, first-pass success rate): 196 / 205 = 95.6% (recomputed 11-08; denominator 205 = 211 titles minus 6 excluded: 4 corrupt dumps, 2 requiring a 32-bit architecture).

Known issues

The Windows S2Arm.exe is not code-signed yet: SmartScreen may warn; choose "More info → Run anyway".
The Windows build is an unzip-and-run folder; no installer yet.
Android and HarmonyOS are coming; not selectable yet.
32-bit games are not supported.
Some games cannot be exported or entered yet (e.g. DRAGON QUEST BUILDERS 2 currently fails to export: on Mac the main-binary rewrite stops at an unrecognized jump table; on Windows the GLSLC tool mode is missing). Please export the diagnostics package and open an Issue.
Apps signed with a free Apple ID expire after 7 days, max 3 at a time; tap "Install to iPhone" again — saves and resources stay.