Skip to content

Build instructions for Android

Jump to bottom
ameci-iis edited this page Apr 5, 2024 · 1 revision

You need to have CMake and the Android NDK installed.

  1. Clone the project and make a build folder. 
    $ git clone [email protected]:Fraunhofer-IIS/mpeghdec.git
$ mkdir -p build_android
  2. Configure the project using CMake. 
    $ cmake -S mpeghdec -B build_android -DCMAKE_TOOLCHAIN_FILE=<ndk_path>/build/cmake/android.toolchain.cmake -DANDROID_FORCE_ARM_BUILD=ON -DCMAKE_BUILD_TYPE=Release
    Use a toolchain file and set the path to it correctly.
  3. Build the project. 
    $ cmake --build build_android
    The build/ folder should, dependent on the set configuration, now contain:
    • lib/ subfolder with the built project libraries
    • bin/ subfolder with the built project binaries (e.g. example programs)
    • doc/ subfolder with the generated Doxygen documentation

Toolchain files

The parameter CMAKE_TOOLCHAIN_FILE is added in step 2 of the build instructions above and should point to a file containing a toolchain description. You can find more information on that topic here.

We do not provide any toolchain files for Android builds, as the Android NDK ships with its own cross-compilation toolchain and toolchain file. It is located in <ndk_path>/build/cmake/android.toolchain.cmake, where <ndk_path> is the install location of the Android NDK. The build configuration can be further controlled by setting the cache variables ANDROID_PLATFORM, ANDROID_ABI and ANDROID_STL using the -D option.

Clone this wiki locally