You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Franzo 46094c9110 initial commit 11 months ago
gradle/wrapper initial commit 11 months ago
src/main/java initial commit 11 months ago initial commit 11 months ago
AndroidManifest.xml initial commit 11 months ago
README.ANDROID initial commit 11 months ago
banner.png initial commit 11 months ago
build.gradle initial commit 11 months ago initial commit 11 months ago
gradlew initial commit 11 months ago
icon-dbg.png initial commit 11 months ago
icon.png initial commit 11 months ago
icon_adaptive_fg-dbg.png initial commit 11 months ago
icon_adaptive_fg.png initial commit 11 months ago initial commit 11 months ago initial commit 11 months ago






To run SuperTuxKart on Android, you need a device that meets following

- Android 4.1 or later
- Processor compatible with armv7 or x86
- GPU that supports OpenGL ES 2.0
- 1 GB RAM (STK uses ~150 MB in minimal configuration)
- 300 MB of free space on internal storage
- Touch screen or external keyboard


The build scripts are designed to run under linux. They may work under cygwin
after some tweaks, but atm. only linux is supported.

Dependencies list (may be incomplete):

autoconf, automake, make, python, gradle, imagemagick, cmake,
vorbis-tools, pngquant

Additionally some dependencies for optimize_data script:

advancecomp, libjpeg-progs, optipng

Before compilation you must download dependencies-android-src.tar.xz from:
Choose the corresponding STK version you are compiling, use "preview" for git.
It contains sources of libraries that are used in STK, but are not available
in stk-code repository (curl, freetype, openal...).

These libraries are compiled and then statically linked with STK by the Android
build script.

You need to extract that packed file to stk-code/lib directory, so that the
directory will have following structure:
> stk-code
> build
> data
> lib
> angelscript
> bullet
> curl
> enet
> freetype
> ...
> src
> ...

You also need Android SDK for android-26 platform or later (SDL2 requirement) and
Android NDK. Version r22 is recommended, because it's known that it works
without issues. r24 or later is not compatible because it removes Android 4.1
support (

You need to create proper "android-sdk" and "android-ndk" symlinks in the
directory with Android project, so that the compilation script will have access
to the SDK and NDK.

Before running the compilation, run the generate_assets script, so that
selected assets will be copied to "assets" directory, and then included in the
apk file.

You can select different karts and tracks by setting KARTS and TRACKS variables
in the script at the beginning of file.

When you are creating the assets directory manually, note that the
directories.txt file is urgently needed and it is used by the application for
extracting assets.

If the assets directory is already prepared, you can run "./" command to
build the project and create an apk file. Note that all arguments are passed to
the make command, so that you can run "./ -j5" for multi-threaded build.

Basically if all dependencies are installed in the system, it should be enough
to just run:

export SDK_PATH=/path/to/your/android/sdk
export NDK_PATH=/path/to/your/android/ndk


COMPILE_ARCH - Allows one to choose CPU architecture for which the package will
be compiled.
Possible values: all, armv7, aarch64, x86, x86_64.
Default is: all.

BUILD_TYPE - Allows one to set build type.
Possible values: debug, release, beta.
Default is: debug.

BUILD_TOOLS_VER - Allows to override the SDK build-tools version.

SDK_PATH - Path to SDK directory

NDK_PATH - Path to NDK directory

PROJECT_VERSION - Set Supertuxkart version number, for example "0.9.3" or
"git20170409" or whatever. The version must match with file
and that file must exist, because it is used for extracting
and loading game data.
Default is: git.

PROJECT_CODE - Set Supertuxkart version code that is used in the manifest
Default is: 1.


Making a release build is similar to typical compilation, but there are few
additional things to do.

You have to set PROJECT_VERSION variable. This is important, because assets
manager in STK checks that value and detects if already extracted data files are
up to date. So that when you will install new STK version, this will force new
data extraction automatically.

The PROJECT_CODE variable typically should be set to a value higher than for
previous release, so that users will receive the upgrade.

Before compilation you have to set:

export BUILD_TYPE=release

It's also needed to set STK_STOREPASS, STK_KEYSTORE and STK_ALIAS environment
variables, so that the apk files can be signed.

and then you make standard compilation with: