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
TA的项目
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
#749一个游戏打不开,无反应之后会闪退,其他游戏能正常打开42 comments · 2026-11-12#372NSUN3 arena rendering error & control button layout can't be saved37 comments · 2026-11-10#798[问题] 勇者斗恶龙 VII Reimagined:开场下楼母亲炉台旁红绿光持续闪烁(0.2.3 iPad / 0.3.0 iPhone 17 Pro Max 均复现)33 comments · 2026-11-12#502[功能] Optional standalone .ipa + resource folder per game32 comments · 2026-11-10#48[安卓 / 总表] 安卓直连追平 iOS:缺陷重提、性能分批与认领32 comments · 2026-11-09#427[问题] 空之轨迹 the 1st:开场视频和声音正常,进入游戏后 3D 画面全黑(iPad,无报错)31 comments · 2026-11-10#1198D-9RX930 comments · 2026-11-15#141[问题] 伊苏 8:游戏闪退28 comments · 2026-11-09
Discussions
#929关于探索 S2Arm 原生支持 Windows on ARM64 的建议0 comments · 2026-11-13#644[功能建议] 增加 Apple TV(tvOS)出包目标0 comments · 2026-11-11#454Private job root inherits permissions.报错该怎么办啊0 comments · 2026-11-10#423Iphone 11 pro max+ M11 comments · 2026-11-10#253合入流程与架构:验证怎么跟上 agent 的开发速度2 comments · 2026-11-09
Latest release
v0.5.7 v0.5.7 2026-11-17S2Arm 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.