Sonic Mania Decompilation: Android Build Guide

This is a guide to building your own Sonic Mania APK for Android. This guide is currently intended for Linux users, and may also run on macOS.

Instructions (Linux/macOS)

1. Install dependencies using your package manager if you don't already have it.
   Debian, Ubuntu and derivatives: sudo apt install git curl unzip bash
   Fedora, RHEL, CentOS and derivatives: sudo dnf install git curl unzip bash
   Arch Linux and derivatives (Make sure to enable the extra repo): sudo pacman -S git curl unzip bash
   macOS (currently untested) (requires homebrew): brew install git unzip bash

2. Install Android Studio from here if you don't already have it.

3. Download the Sonic Mania Android Build Helper script using the terminal: curl https://raw.githubusercontent.com/Eggmanplant/Sonic-Mania-Android-Build-Guide-Linux/main/ManiaAndroidBuildHelper_2.0.sh | bash

4. Once the script says SETUP COMPLETE, open Android Studio. Click File in the navigation bar at the top, click Open, navigate to /home/username/Sonic-Mania-Android-Sheeple/Sonic-Mania-Decompilation/dependencies/RSDKv5/android (replacing 'username' with whatever your user folder is called) and click OK. Android Studio will then run some automatic actions in the background to import the project.

5. Ensure that the latest SDK tools are installed. This can be checked by going to "Tools --> SDK Manager". Go to the SDK Tools tab. If the latest versions of Android SDK Build-Tools 33, NDK (Side-by-Side), CMake, and Android SDK Platform-Tools are not installed, check the boxes for them and click Apply. It will then download the latest versions of these tools onto your computer. Once finished downloading, press the Finish button, and the project will sync with the new tools.

6. Eventually, Android Studio will prompt you, in the bottom right-hand corner, to upgrade "Gradle". This is required for successful compilation, so you need to upgrade it.

7. If you just want to play the game, and are not interested in bug-reporting, you can go to Build --> Build Project. Android Studio will then automatically start compiling your APK file, and after completion, will be stored in the directory /home/username/Sonic-Mania-Android-Sheeple/Sonic-Mania-Decompilation/dependencies/RSDKv5/android/app/build/outputs/apk/debug.

8. This next step is for ONLY for users wanting to play on the RELEASE build. If you are using a Debug build, skip to Step 9.

8. Before compilation, go to "Build --> Generate Signed Bundle/APK". This will then prompt you with many fields to fill out, the required ones listed below:

• 8a. Select "APK" on the first page, it being the bottom option. Hit "Next".

• 8b. There are four fields next. They are, as follows: Key store path, Key store password, Key alias, and Key password.

• 8c. For Key store path, click the folder icon and go to the directory /home/username/Sonic-Mania-Android-Sheeple/Sonic-Mania-Decompilation/dependencies/RSDKv5/android. There should be a file named release-key.jks. Choose that file as the Key store path.

• 8d. For the next three fields, the passwords for each field are:

• Key store password: retroengine

• Key alias: key0

• Key password: retroengine

• 8e. Choose "Next", and then chose the release option. Android Studio will then automatically start compiling your APK file, and after completion, will be stored in the directory /home/username/Sonic-Mania-Android-Sheeple/Sonic-Mania-Decompilation/dependencies/RSDKv5/android/app/release.

9. Required mods setup

• 9a. Install your Mania APK on your phone and run it once. It will not show anything, but we can fix that.

• 9b. Download the required mods.zip folder from here.

• 9c. Extract the mods.zip folder from Dropbox into the directory [root]/RSDK/v5/mods on your phone. You should now be able to play Sonic Mania on Android!

Support

If you need any support, please feel free to reach out to the Retro Engine Modding Server on Discord.