mirror of
https://github.com/kichikuou/system3-sdl2.git
synced 2026-09-25 08:08:05 +03:00
System3 for Android
Download
Prebuilt APKs are here.
Build
Prerequisites:
- CMake >=3.20
- Android SDK >=28
- Android NDK >=r15c
Using Android Studio
Clone this repository and its submodules:
git clone --recurse-submodules https://github.com/kichikuou/system3-sdl2.git
Then open system3-sdl2/android directory as an Android Studio project.
Command line build
Configure environment variables and run the gradlew script in this folder.
Example build instructions (for Debian bullseye):
# Install necessary packages
sudo apt install git wget unzip default-jdk-headless ninja-build
sudo apt install -t bullseye-backports cmake
# Install Android SDK / NDK
export ANDROID_SDK_ROOT=$HOME/android-sdk
mkdir -p $ANDROID_SDK_ROOT/cmdline-tools
wget https://dl.google.com/android/repository/commandlinetools-linux-7583922_latest.zip
unzip commandlinetools-linux-7583922_latest.zip -d $ANDROID_SDK_ROOT/cmdline-tools
mv $ANDROID_SDK_ROOT/cmdline-tools/cmdline-tools $ANDROID_SDK_ROOT/cmdline-tools/tools
yes |$ANDROID_SDK_ROOT/cmdline-tools/tools/bin/sdkmanager --licenses
$ANDROID_SDK_ROOT/cmdline-tools/tools/bin/sdkmanager ndk-bundle
export ANDROID_NDK_HOME=$ANDROID_SDK_ROOT/ndk-bundle
# Check out and build system3-sdl2
git clone --recurse-submodules https://github.com/kichikuou/system3-sdl2.git
cd system3-sdl2/android
./gradlew build # or ./gradlew installDebug if you have a connected device
Use
Basic Usage
- Create a ZIP file containing all the game files and BGM files (see below for details), and transfer it to your device.
- Open the app. A list of installed games is displayed. Since nothing has been installed yet, only the "Install from ZIP" button is displayed. Tap it.
- Select the ZIP file you created in 1.
- The game starts. Two-finger touch is treated as a right click.
Preparing a ZIP
- Include all
.DATfiles. - Music files (
.mp3,.oggor.wav) whose file names end with a number are recognized as BGM files. For example:Track2.mp315.oggrance41_03.wav(This shouldn't berance4103.wav, because it would be treated as the 4103rd track)
Note: This form of ZIP can be used in Kichikuou on Web as well.
Miscellaneous
- You can export / import saved files using the option menu of the game list.
- To uninstall a game, long-tap the title in the game list.
- System menu pops up with 3-finger touch during game play.
Known Issues
- Installation from a ZIP containing multiple games (e.g. DPS series) does not work well.