Sonic Runners Adventure - Switch Port

[besk]

Sonic Runners Adventure - Nintendo Switch Port

Hi everyone!

I'm back with another Sonic Android port for the Nintendo Switch.

This time it's Sonic Runners Adventure, the Gameloft mobile game originally released for Android and iOS.

This is not an emulation-based port. The Switch wrapper loads and runs the original ARM64 Android libGame.so natively, while providing the Android/JNI, filesystem, audio, input and OpenGL ES compatibility layers that the game expects.

After quite a bit of work on the Android runtime, save system, rendering and input, the game is now fully playable on Nintendo Switch hardware.

Turkish and English have been tested so far. Other languages included with the original game should also be available, but I haven't extensively tested all of them yet.

Required version

You need your own legally obtained copy of:

Sonic Runners Adventure 1.0.4a
Package: com.gameloft.android.ANMP.GloftICHM
Version Code: 10432
Architecture: ARM64 / arm64-v8a

Other APK versions are currently not supported.

Installation

Download sonic_runners_nx.nro from the GitHub release.

From your original APK, extract:

• lib/arm64-v8a/libGame.so
• The entire assets/ folder
• Keep a second untouched copy of the original APK

Create:

sdmc:/switch/sonic_runners_nx/

The final folder should look like:

sdmc:/switch/sonic_runners_nx/
├── sonic_runners_nx.nro
├── libGame.so
├── package/
│   └── libGame.so
└── assets/
    ├── data01.jet
    ├── base_sounds.voxpack
    ├── content.txt
    └── ...

The first libGame.so is the actual ARM64 native library extracted from:

lib/arm64-v8a/libGame.so

For:

package/libGame.so

copy the original APK itself into the package folder and rename that APK file to libGame.so.

Yes, that filename is intentional. The game expects access to its original APK/ZIP package during runtime.

Controls

• Touchscreen - Normal touchscreen controls
• Left Stick - Move the virtual touch cursor
• A / ZR / ZL - Touch/hold at the cursor position
• B - Android Back
• + - Android Menu

The virtual cursor automatically hides when it isn't needed.

Important

This port requires full title-mode homebrew memory.

Do not launch it through Album/applet mode.

Use Homebrew Menu with title override (hold R while launching a game) or use a compatible forwarder.

Download / Source

GitHub Repository & Releases

The repository does not contain the original APK, game assets or original game binaries. You must provide those files yourself from your own copy of the game.

Credits

Huge thanks to:

• fgsfdsfgs for the Android .so loader / Nintendo Switch homebrew work this project builds upon
• NaGaa95 for related Switch Android-wrapper projects and compatibility work
• TheOfficialFloW for pioneering Android native-library loading techniques in homebrew ports
• devkitPro / libnx contributors
• Mesa / nouveau contributors
• SDL2 contributors

Legal

This is an unofficial fan-made project and is not affiliated with SEGA or Gameloft.

Sonic the Hedgehog, Sonic Runners Adventure and all original game content belong to their respective owners.

No copyrighted game binaries or assets are distributed with this project.

Hope you enjoy playing it on Switch!