jhaizhou-ops /S2Arm

Run your own Switch games natively on iPhone, iPad and Mac: game code rewritten to ARM64, graphics direct to Metal, one app for the whole library. Bring your own games and keys. 把你自己的 Switch 游戏原生带到 iPhone / iPad / Mac。

★ 3,474⑂ 598👁 8⑃ 652● 848▤ 43
C#Apache-2.0Created 2026-11-08s2arm.com
下载:v0.5.7v0.5.7 ↓0.5.72026-11-17
3,474
stars
598
forks
8
watchers
652
prs
848
issues
43
releases

README

s2arm.com

 [!NOTE]
 好消息:s2arm.com 已正式成为 S2Arm 官方网站。 S2Arm 免费开源,从不接受任何捐赠;请只从 s2arm.com 或本 GitHub 仓库获取 S2Arm。

把你自己的 Switch 游戏,原生带到 iPhone、iPad 和 Mac。 游戏代码改写成原生 ARM64,直接在设备的处理器上执行;图形直连 Metal。整座游戏库装进一个 App,在 Mac 或 Windows 的图形启动器里点几下就能出包、装机、开玩。

平台:iPhone / iPad(iOS / iPadOS 18 起)· Mac(Apple 芯片,macOS 15 起)· 在 Mac 或 Windows 上出包 · Android / 鸿蒙即将支持 · 许可:Apache-2.0 · 游戏原件自备

English · 下载启动器 · 全部版本 · 证据页



 原生移植,不是模拟

游戏自己的 ARM64 代码在出包时改写,然后直接在 iPhone、iPad 和 Mac 的处理器上运行,没有 CPU 模拟器夹在中间。图形调用直接翻译成 Metal,系统服务由原生宿主提供。快、凉、省电,都从这里来。证据

 一个 App,装下整个游戏库

所有游戏导入同一个 S2Arm App,打开后在游戏库里挑一款就玩。整座游戏库只占开发者账号的一个 App 名额:多加一款游戏,不多装一个 App,也不多占一个签名名额。证据

 图形启动器,几乎零配置

Mac 和 Windows 各有一个图形启动器。第一次打开,欢迎页把事情收成三步:准备这台电脑、放入密钥、添加游戏,任何时候只有一个主按钮。运行所需的组件要么已经内置,要么一键获取,全程不用打开命令行。

点「一键出包」之后,每个阶段的进度、用时、剩余时间和磁盘占用都看得见;多款游戏可以排队连续出包。证据


  
  



  
  


 AI 可以直接驾驶

Mac 和 Windows 启动器都开放了控制接口 s2armctl:AI 助手可以导入游戏、出包、装机、查进度、读错误,每一步都在启动器窗口里看得见。配套的自查、自修与反馈工具包让 AI 自己定位问题、按处方修复,修不好就整理出诊断包交给你提交。看 AI 诊断并修好一个真实问题的完整实录:证据

 让 AI 帮你操作

把这句话发给你的 AI 助手(需要它能在你的电脑上执行命令):

 请阅读 https://github.com/jhaizhou-ops/S2Arm/blob/main/launchers/macos/skill/s2arm-operator/SKILL.md ,然后帮我把我的 Switch 游戏装到 iPhone 上。

它会用这几条命令一步步推进,你在启动器窗口里看得到每一步:

bash
/Applications/S2Arm.app/Contents/Resources/s2armctl start         打开并连上启动器
/Applications/S2Arm.app/Contents/Resources/s2armctl next          现在该做什么、谁来做、为什么
/Applications/S2Arm.app/Contents/Resources/s2armctl diag export ~/Desktop/S2Arm-诊断.zip    修不好时导出诊断包


需要你本人做的事(系统授权、登录 Apple ID、在手机上点「信任」),AI 会停下来告诉你。Windows 上用启动器文件夹里的 s2armctl.cmd,命令相同。Windows 只出 iPhone / iPad 包,游戏里的问题请在手机上导诊断包:游戏画面上四指同时长按 1.5 秒,选「导出诊断包」。

游戏里出了问题(画面、帧率、卡顿、闪退)?把这句话发给 AI:

 请阅读 https://github.com/jhaizhou-ops/S2Arm/blob/main/skills/player-game-triage/SKILL.md 。我在 S2Arm 里玩的游戏出了这个问题:。先帮我查设置、收诊断;你能改代码就按里面的方法根修并提 PR,修不了就帮我整理成 Issue。

 经过大规模真机检验

211 款游戏完成普查,一次出包成功率 95%。4700+ 局 iOS 真机测试,1000+ 局 macOS 测试。证据

 快、顺、省电

在一台 16 GB 内存的 MacBook Air(M3)上,从导入游戏到出好 iPhone 包,全程冷启动:

| 游戏 | 原件 | 着色器 | 出包用时 |
|---|---|---|---|
| 一款 23.5 GB 的动作角色扮演游戏 | 23.5 GB | 1,222 | 6.4 分钟 |
| 一款 12.0 GB 的生活模拟游戏 | 12.0 GB | 9,315 | 8.6 分钟 |
| 一款 17.5 GB 的开放世界游戏 | 17.5 GB | 26,999 | 34 分钟 |

一款 Switch 2 游戏在 iPhone 17 Pro Max 上真机实测,手机未发热时满 60 帧,持续高负载发热后 37~43 帧,每帧耗电约 0.15 焦耳。证据

 覆盖面

| 平台 | 支持 |
|---|---|
| iPhone / iPad | iOS / iPadOS 18 起,所有游戏在同一个 App 里选 |
| Mac | Apple 芯片,macOS 15 起;本机出包,也能直接在 Mac 上玩 |
| Windows | 图形启动器,为 iPhone / iPad 出包并装机 |
| Android / 鸿蒙 | 即将支持 |

证据

 下游深度方案

有的游戏有社区专门做的深度移植。S2Arm 认得出这些游戏:导出时弹一页说明,你可以改用下游项目的方案(导入、出包、装机仍在 S2Arm 里点按钮完成,底层换成下游项目的实现),也可以照常用原版方案。登记表在 pack/downstream/schemes.json,两边的约定以下游项目的说明为准。

| 方案 | 项目 | 终端 | 约定 |
|---|---|---|---|
| D2R-Mobile | jhaizhou-ops/d2r-mobile | iPhone / iPad(iOS 26 起;安卓、鸿蒙接入中) | docs/S2ARM.zh-CN.md |

 开始使用

1. 从下载页下载 Mac 或 Windows 启动器,打开即用。在 Mac 上出 iPhone 包需要 App Store 免费的 Xcode,并在里面登录你的 Apple ID,启动器会一步步带你完成。
2. 导入你自己的密钥和游戏;本体、更新和 DLC 放在同一个文件夹里一次导入。
3. 选 iPhone / iPad 或这台 Mac,点「出包」。
4. 按启动器提示用你自己的 Apple ID 签名装机(Windows 版已附带签名工具 Impactor),打开 S2Arm,在游戏库里选游戏开玩。

更新 App 前

Top issues

Discussions

Latest release

v0.5.7 v0.5.7 2026-11-17
S2Arm v0.5.7

 修复
- 打社区帧率补丁、开 60 帧会闪退的 14 款游戏:之前已经出过包的,更新后会自动重新生成补丁,不用再手动重出一次包。
  The 14 games that crashed at 60 fps with community frame-rate patches: packages you already built now regenerate their patches automatically after updating, so you no longer need to rebuild them by hand.
- iPhone(iOS 26):推游戏时新建的目录归 S2Arm 自己,之后不会再写不进去。
  iPhone (iOS 26): folders created while pushing games now belong to S2Arm, so they can't become unwritable later.

Snapshot: 2026-11-17T21:58:29Z · Data license Apache-2.0 · JSON