NaGaa95/subwaysurfers_nx

AI 仓库情报摘要

FR-AI / ANALYSIS

为什么值得关注

它展示了如何将未修改的移动端 Unity IL2CPP 游戏适配到 Switch：解析原始 so 文件的导入、修补二进制并提供最小 Android 运行时，同时不分发任何受版权保护的游戏资源或代码。

适合谁使用

想在 Switch 上玩《地铁跑酷》的自制系统用户
对 Android 游戏移植到 Switch 感兴趣的开发者
研究 Unity IL2CPP 二进制加载与修补的逆向工程人员
拥有合法 APK 且使用可运行自制软件的 Switch 的玩家

典型使用场景

在 Switch 上运行用户自己提供的《地铁跑酷》3.66.1 APK
研究如何把 Android 游戏二进制加载、解析并修补到 Switch
构建或测试用于完整应用内存启动的 forwarder/game override 方案
学习如何将移动端游戏资源转换为更适合目标平台的优化格式

项目优势

仓库不包含原版游戏资源或代码，用户必须自行从合法获得的 APK 中提取文件
会自动清理无用的 Android 文件并将零散资源转换为优化包，从而减少加载时间
提供了基于 devkitA64 和常见 Switch portlibs 的清晰安装与构建说明
基于知名的 so-loader 基础工作，技术路线有可靠依据

使用前须知

仅针对《地铁跑酷》3.66.1 arm64 版本，其他版本可能无法运行
必须通过游戏 override 或 forwarder 获得完整应用内存，相册 applet 模式不受支持
首次启动可能需要几分钟，且需要一台可运行自制软件的 Switch

README 快速开始

Subway Surfers — Nintendo Switch port

A wrapper/port of the Android release of Subway Surfers (v3.66.1). It loads the original game binaries (libmain.so, libunity.so and libil2cpp.so, Unity 2022.3 IL2CPP, arm64), resolves their imports against native Switch implementations and patches them so the game runs inside a minimal Android environment.

How to install

Create a folder for the game on your SD card, /switch/subwaysurfers_nx/, and place:

subwaysurfers_nx.nro.
The complete contents of a Subway Surfers 3.66.1 arm64 APK. Open the APK with 7-Zip or another ZIP extractor and extract it directly into the folder.

/switch/subwaysurfers_nx/
  subwaysurfers_nx.nro
  lib/
    arm64-v8a/
      libmain.so
      libunity.so
      libil2cpp.so
  assets/
    bin/Data/ ...

The first launch can take several minutes. The port validates the extracted game, removes unused Android files and converts the loose assets into an optimized pack to avoid long loading time.

Launch with a game override (hold R while starting a title) or a forwarder with full application memory. Album applet mode does not provide enough memory or the required code-memory permissions.

Build

devkitA64 plus these portlibs:

pacman -S switch-mesa switch-libdrm_nouveau switch-sdl2 switch-zlib

Then make from a devkitPro shell.

Credits

TheOfficialFloW & Andy Nguyen — the original Android so-loader.
fgsfds — the Switch so-loader groundwork reused here.

Support

If you enjoy my work and want to support me :

Legal

No affiliation with SYBO Games or Kiloo. "Subway Surfers" is a trademark of its owner. This repository contains no assets or program code from the original game, and none may be distributed with builds. Users must extract the required files from their own legally obtained copy.

Source code is provided under the MIT License (see LICENSE).

项目描述

Port of Subway Surfers for Switch.

subwaysurfers_nx