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:
Code:
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:
Code:
sdmc:/switch/sonic_runners_nx/
The final folder should look like:
Code:
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:
Code:
lib/arm64-v8a/libGame.so
For:
Code:
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!







