Javernaut 2f85b4524c Checking for ANDROID_SDK_HOME and ANDROID_NDK_HOME variables before script execution		5 years ago
images	Updating the output layout image	5 years ago
scripts	Checking for ANDROID_SDK_HOME and ANDROID_NDK_HOME variables before script execution	5 years ago
.gitignore	Printing stats about text relocations presence	5 years ago
.travis.yml	Updating meson to 0.53.2 in .travis.iml	5 years ago
README.md	Specifying the version of meson to use	5 years ago
ffmpeg-android-maker.sh	Checking for ANDROID_SDK_HOME and ANDROID_NDK_HOME variables before script execution	5 years ago

README.md

ffmpeg-android-maker

Here is a script that downloads the source code of FFmpeg library and assembles it for Android. The script produces shared libraries as well as header files. The output structure looks like this:

The actual content of all this directories depends on how the FFmpeg was configured before assembling. For my purpose I enabled only libavcodec, libavformat, libavutil and libswscale, but you can set your own configuration to make the FFmpeg you need.

The version of FFmpeg here by default is 4.2.2 (but can be overridden). And the script expects to use at least Android NDK r19 (both r20 and r21 also work ok).

The details of how this script is implemented are described in this series of posts:

The WIKI contains a lot of useful information.

Actual Android app that uses the output of the script can be found here.

Supported Android ABIs

armeabi-v7a (with NEON)
arm64-v8a
x86
x86_64

Supported host OS

On macOS or Linux just execute the script in terminal.

It is also possible to execute this script on a Windows machine with MSYS2. You also need to install specific packages to it: make, git, diffutils and tar. The script supports both 32-bit and 64-bit versions of Windows. Also see Prerequisites section for necessary software.

Since v2.0.0 the Windows support is temporary absent.

Prerequisites

You have to define two environment variables:

ANDROID_SDK_HOME - path to your Android SDK
ANDROID_NDK_HOME - path to your Android NDK

Also, if you want to build libaom, then you have to install the cmake;3.10.2.4988404 package via Android SDK.

For libdav1d building you also need to install ninja and meson 0.52.1 tools.

Features

Add an arbitrary external library that FFMpeg supports to the building process. Just specify how the source code needs to be downloaded and how to perform the build operation. More about this is here.

Setting your own FFmpeg version and origin. You can actually override the version of FFmpeg used by the script. See details here.

Test your script in a cloud. This repository has CI integration and you can use it too for your own configurations. See details here.

Text relocations monitoring. After an assembling is finished you can look into stats/text-relocations.txt file. That file lists all *.so files that were built and reports if any of them have text relocations. If you don't see any mentioning of 'TEXTREL' in the file, you are good. Otherwise, you will see exact binaries that have this problem.