MAMEDEV Wiki - User contributions [en-gb]

Android

2023-02-26T19:05:56Z

Micko:

== Android build ==

First, download and install Android NDK r25c or later by unpacking release
taken from the Android developer site [https://developer.android.com/ndk/downloads].

To be used, only enviroment variables need to be properly set, as in example:

export PATH="$PATH:/opt/android-ndk"
export ANDROID_NDK=/opt/android-ndk
export ANDROID_NDK_HOME=/opt/android-ndk

Since there is no precompiled SDL2 for Android we need to prepare that as well.
First is to download latest from SDL github [https://github.com/libsdl-org/SDL/releases/latest].
In time of writing version was SDL2-2.26.3, but later version should work fine as well.

Next step is to build SDL2 with Android NDK:

tar xvfz SDL2-2.26.3.tar.gz
cd SDL2-2.26.3

To compile for ARM64 (arm64-v8a):

cmake -S . -B build_arm64 \
-DANDROID_PLATFORM=android-24 \
-DANDROID_ABI=arm64-v8a \
-DCMAKE_INSTALL_PREFIX=~/SDL_Android_arm64 \
-DCMAKE_TOOLCHAIN_FILE="$ANDROID_NDK_HOME/build/cmake/android.toolchain.cmake" \
-DSDL_SHARED=ON -DSDL_STATIC=ON -DSDL_STATIC_PIC=ON -DSDL_TEST=ON \
-DSDL2_DISABLE_SDL2MAIN=OFF -DSDL2_DISABLE_INSTALL=OFF \
-DCMAKE_INSTALL_INCLUDEDIR=include -DCMAKE_INSTALL_LIBDIR=lib -DCMAKE_BUILD_TYPE=Release

make -C build_arm64 install

To compile for Intel x86:

cmake -S . -B build_x86 \
-DANDROID_PLATFORM=android-24 \
-DANDROID_ABI=x86 \
-DCMAKE_INSTALL_PREFIX=~/SDL_Android_x86 \
-DCMAKE_TOOLCHAIN_FILE="$ANDROID_NDK_HOME/build/cmake/android.toolchain.cmake" \
-DSDL_SHARED=ON -DSDL_STATIC=ON -DSDL_STATIC_PIC=ON -DSDL_TEST=ON \
-DSDL2_DISABLE_SDL2MAIN=OFF -DSDL2_DISABLE_INSTALL=OFF \
-DCMAKE_INSTALL_INCLUDEDIR=include -DCMAKE_INSTALL_LIBDIR=lib -DCMAKE_BUILD_TYPE=Release

make -C build_x86 install

To compile for Intel x86_64:

cmake -S . -B build_x86_64 \
-DANDROID_PLATFORM=android-24 \
-DANDROID_ABI=armeabi-v7a \
-DCMAKE_INSTALL_PREFIX=~/SDL_Android_x86_64 \
-DCMAKE_TOOLCHAIN_FILE="$ANDROID_NDK_HOME/build/cmake/android.toolchain.cmake" \
-DSDL_SHARED=ON -DSDL_STATIC=ON -DSDL_STATIC_PIC=ON -DSDL_TEST=ON \
-DSDL2_DISABLE_SDL2MAIN=OFF -DSDL2_DISABLE_INSTALL=OFF \
-DCMAKE_INSTALL_INCLUDEDIR=include -DCMAKE_INSTALL_LIBDIR=lib -DCMAKE_BUILD_TYPE=Release

make -C build_x86_64 install

To compile for ARM (armeabi-v7a):

cmake -S . -B build_arm \
-DANDROID_PLATFORM=android-24 \
-DANDROID_ABI=armeabi-v7a \
-DCMAKE_INSTALL_PREFIX=~/SDL_Android_arm \
-DCMAKE_TOOLCHAIN_FILE="$ANDROID_NDK_HOME/build/cmake/android.toolchain.cmake" \
-DSDL_SHARED=ON -DSDL_STATIC=ON -DSDL_STATIC_PIC=ON -DSDL_TEST=ON \
-DSDL2_DISABLE_SDL2MAIN=OFF -DSDL2_DISABLE_INSTALL=OFF \
-DCMAKE_INSTALL_INCLUDEDIR=include -DCMAKE_INSTALL_LIBDIR=lib -DCMAKE_BUILD_TYPE=Release

make -C build_arm install

After this all is ready for MAME to be built. Note that it can be built for android-arm,
android-arm64, android-x86 and android-x64. If you are testing with emulator you only need
android-x86 build, but for real device nowdays android-arm64 will only be needed, and there
are less and less android-arm.

make SUBTARGET=tiny SDL_INSTALL_ROOT=~/SDL_Android_x86 android-x86 -j9

This prepared binaries, but still we need to deploy application to device.
Easiest way is to use Android Studio [https://developer.android.com/studio].

All build features are also available using gradle, next set of commands will
create debug build and deploy it on connected Android device.

gradlew assembleDebug
gradlew installDebug

Android

2023-02-26T19:01:30Z

Micko: Created page with " == Android build == First, download and install Android NDK r25c or later by unpacking release taken from the Android developer site [https://developer.android.com/ndk/down..."

== Android build ==

First, download and install Android NDK r25c or later by unpacking release
taken from the Android developer site [https://developer.android.com/ndk/downloads].

To be used, only enviroment variables need to be properly set, as in example:

export PATH="$PATH:/opt/android-ndk"
export ANDROID_NDK=/opt/android-ndk
export ANDROID_NDK_HOME=/opt/android-ndk

Since there is no precompiled SDL2 for Android we need to prepare that as well.
First is to download latest from SDL github [https://github.com/libsdl-org/SDL/releases/latest].
In time of writing version was SDL2-2.26.3, but later version should work fine as well.

Next step is to build SDL2 with Android NDK and prepare include files in required form.

tar xvfz SDL2-2.26.3.tar.gz
cd SDL2-2.26.3

To compile for ARM64 (arm64-v8a):

cmake -S . -B build_arm64 \
-DANDROID_PLATFORM=android-24 \
-DANDROID_ABI=arm64-v8a \
-DCMAKE_INSTALL_PREFIX=~/SDL_Android_arm64 \
-DCMAKE_TOOLCHAIN_FILE="$ANDROID_NDK_HOME/build/cmake/android.toolchain.cmake" \
-DSDL_SHARED=ON -DSDL_STATIC=ON -DSDL_STATIC_PIC=ON -DSDL_TEST=ON \
-DSDL2_DISABLE_SDL2MAIN=OFF -DSDL2_DISABLE_INSTALL=OFF \
-DCMAKE_INSTALL_INCLUDEDIR=include -DCMAKE_INSTALL_LIBDIR=lib -DCMAKE_BUILD_TYPE=Release

make -C build_arm64 install

To compile for Intel x86:

cmake -S . -B build_x86 \
-DANDROID_PLATFORM=android-24 \
-DANDROID_ABI=x86 \
-DCMAKE_INSTALL_PREFIX=~/SDL_Android_x86 \
-DCMAKE_TOOLCHAIN_FILE="$ANDROID_NDK_HOME/build/cmake/android.toolchain.cmake" \
-DSDL_SHARED=ON -DSDL_STATIC=ON -DSDL_STATIC_PIC=ON -DSDL_TEST=ON \
-DSDL2_DISABLE_SDL2MAIN=OFF -DSDL2_DISABLE_INSTALL=OFF \
-DCMAKE_INSTALL_INCLUDEDIR=include -DCMAKE_INSTALL_LIBDIR=lib -DCMAKE_BUILD_TYPE=Release

make -C build_x86 install

To compile for Intel x86_64:

cmake -S . -B build_x86_64 \
-DANDROID_PLATFORM=android-24 \
-DANDROID_ABI=armeabi-v7a \
-DCMAKE_INSTALL_PREFIX=~/SDL_Android_x86_64 \
-DCMAKE_TOOLCHAIN_FILE="$ANDROID_NDK_HOME/build/cmake/android.toolchain.cmake" \
-DSDL_SHARED=ON -DSDL_STATIC=ON -DSDL_STATIC_PIC=ON -DSDL_TEST=ON \
-DSDL2_DISABLE_SDL2MAIN=OFF -DSDL2_DISABLE_INSTALL=OFF \
-DCMAKE_INSTALL_INCLUDEDIR=include -DCMAKE_INSTALL_LIBDIR=lib -DCMAKE_BUILD_TYPE=Release

make -C build_x86_64 install

To compile for ARM (armeabi-v7a):

cmake -S . -B build_arm \
-DANDROID_PLATFORM=android-24 \
-DANDROID_ABI=armeabi-v7a \
-DCMAKE_INSTALL_PREFIX=~/SDL_Android_arm \
-DCMAKE_TOOLCHAIN_FILE="$ANDROID_NDK_HOME/build/cmake/android.toolchain.cmake" \
-DSDL_SHARED=ON -DSDL_STATIC=ON -DSDL_STATIC_PIC=ON -DSDL_TEST=ON \
-DSDL2_DISABLE_SDL2MAIN=OFF -DSDL2_DISABLE_INSTALL=OFF \
-DCMAKE_INSTALL_INCLUDEDIR=include -DCMAKE_INSTALL_LIBDIR=lib -DCMAKE_BUILD_TYPE=Release

make -C build_arm install

After this all is ready for MAME to be built. Note that it can be built for android-arm,
android-arm64, android-x86 and android-x64. If you are testing with emulator you only need
android-x86 build, but for real device nowdays android-arm64 will only be needed, and there
are less and less android-arm.

make SUBTARGET=tiny SDL_INSTALL_ROOT=~/SDL_Android_x86 android-x86 -j9

This prepared binaries, but still we need to deploy application to device.
Easiest way is to use Android Studio [https://developer.android.com/studio].

All build features are also available using gradle, next set of commands will
create debug build and deploy it on connected Android device.

gradlew assembleDebug
gradlew installDebug

Building MAME using Microsoft Visual Studio compilers

2016-03-29T16:08:14Z

Micko:

By default, MAME is configured via the makefile to build using the MinGW gcc compiler. Although this is a nice cross-platform solution, debugging binaries built this way leaves a lot to be desired.

If you own a copy of Visual Studio, you can configure MAME to build using those tools instead. Once you have done that, you can debug problems in MAME using the Visual Studio debugger, which is a huge step up from gdb.

Here's how to make it work:

# You must already have an environment that can build MAME using the MinGW tools. Although you won't be using gcc to compile, you will be using several of the other tools included in the standard MAME [http://mamedev.org/tools/ MinGW Development Environment]
# Switch to the directory where the root MAME makefile lives.
# Once you've done that, simply run: <code>make vs2015 PYTHON_EXECUTABLE=c:/buildtools/usr/bin/python.exe</code> and wait for it to create projects
# In order not to specify PYTHON_EXECUTABLE all the time, just placed it in system variables
# For Visual Studio 2013 use: <code>make vs2013 </code>
# If you are building with XP compatibility enabled run <code>make vs2015_xp</code> or <code>make vs2013_xp</code>
# Browse to folder containing solution file and open it with Visual Studio
# Inside Visual Studio you can change to Debug/Release x86 or x64 builds
# While doing development please note that you need to update LUA files in scripts folders in order to add new sources and regenerate projects
# Note that all parameters for partial compilation works so you can do <code>make SUBTARGET=tiny vs2015</code> or <code>make vs2015 SUBTARGET=drivername SOURCES=src\mame\drivers\drivername.cpp</code>
Back to [[How MAME Works]]