Construire FFmpeg à partir des sources pour Android sous Linux

Cette page explique comment configurer et construire FFmpeg pour Android. La compilation pour Android est une compilation croisée et suppose l'utilisation de Linux comme système hôte. Les étapes nécessaires sont les suivantes :

• Obtenir le code source de FFmpeg.
• Installer les dépendances nécessaires.
• Configurer FFmpeg à partir de la ligne de commande.
• Construire les bibliothèques de développement.

Obtenir le code source de FFmpeg

Vous pouvez obtenir le code source de FFmpeg de ces manières :

• Télécharger depuis la page de téléchargement de FFmpeg.
• Cloner à partir de git. Par exemple, cette commande clone la version 7.1.3 des sources de FFmpeg sur ~/ffmpeg.

  git clone --branch n7.1.3 https://git.ffmpeg.org/ffmpeg.git ffmpeg

Il est recommandé d'utiliser la même version de FFmpeg que celle documentée dans la page principale deQt Multimedia .

Les paragraphes suivants supposent que vous stockez le code source de FFmpeg sous ~/ffmpeg.

Conditions préalables

Pour construire FFmpeg, les outils et paquets suivants sont nécessaires :

• Yasm.
• Les paquets du développeur pour le backend de sécurité que vous avez choisi (voir ci-dessous).

Vous aurez également besoin des NDK, SDK et JDK Android installés et configurés. Vous pouvez trouver plus d'informations sur la configuration de ces outils en cliquant sur Getting Started with Qt for Android.

Installation des paquets

Pour installer les paquets requis (y compris Yasm pour FFmpeg), exécutez :

apt-get install yasm

De plus, si vous activez un backend de sécurité, vous avez besoin du package développeur correspondant, par exemple :

apt-get install libssl-dev

Pour les autres backends, installez les paquets appropriés :

• Pour OpenSSL : libssl-dev.
• Pour GnuTLS : libgnutls-dev.
• Pour LibreSSL (libtls) : libtls-dev.
• Pour MbedTLS : libmbedtls-dev.

Définir les variables d'environnement

Cette partie n'est pas strictement nécessaire mais elle aidera à rendre la commande configure un peu plus propre et plus courte.

La commande suivante suppose que le SDK Andorid est installé sur ~/Android/sdk et que la version du NDK Android est 26.1.10909125.

export ANDROID_NDK_ROOT=~/Android/sdk/ndk/26.1.10909125

Il est recommandé d'utiliser la même version du NDK que celle documentée dans le document Getting Started with Qt for Android.

L'architecture pour laquelle vous devez construire dépend des appareils ciblés :

• aarch64 (ARM64-v8a) : Utilisée par la plupart des appareils Android modernes (64 bits).
• armv7 (armeabi-v7a) : Pour les anciens appareils ARM 32 bits.
• x86 : Principalement pour les émulateurs Android fonctionnant sur des processeurs Intel.
• x86_64 : Pour les émulateurs 64 bits basés sur Intel ou les appareils spécialisés.

Configurer les variables spécifiques à l'architecture

• aarch64

  export ARCH=aarch64
  export TOOLCHAIN_ARCH=aarch64-linux-android
  export CPU=armv8-a

• armv7

  export ARCH=armv7
  export TOOLCHAIN_ARCH=armv7a-linux-androideabi
  export CPU=armv7-a

• x86

  export ARCH=x86
  export TOOLCHAIN_ARCH=i686-linux-android
  export CPU=i686

• x86_64

  export ARCH=x86_64
  export TOOLCHAIN_ARCH=x86_64-linux-android
  export CPU=x86-64

Configurer et compiler FFmpeg

Créez un répertoire build-android à l'intérieur du répertoire ~/ffmpeg et naviguez-y :

mkdir ~/ffmpeg/build-android
cd ~/ffmpeg/build-android

Pour configurer FFmpeg, exécutez :

../configure --prefix=../install-android --disable-doc --enable-network --enable-shared \
    --host-os=linux-x86_64 --target-os=android \
    --enable-cross-compile --arch=${ARCH} --cpu=${CPU} \
    --enable-jni --enable-mediacodec \
    --sysroot=${ANDROID_NDK_ROOT}/toolchains/llvm/prebuilt/linux-x86_64/sysroot \
    --sysinclude=${ANDROID_NDK_ROOT}/toolchains/llvm/prebuilt/linux-x86_64/sysroot/usr/include/ \
    --cc=${ANDROID_NDK_ROOT}/toolchains/llvm/prebuilt/linux-x86_64/bin/${TOOLCHAIN_ARCH}24-clang \
    --cxx=${ANDROID_NDK_ROOT}/toolchains/llvm/prebuilt/linux-x86_64/bin/${TOOLCHAIN_ARCH}24-clang++ \
    --strip=${ANDROID_NDK_ROOT}/toolchains/llvm/prebuilt/linux-x86_64/bin/llvm-strip

L'argument --prefix spécifie un chemin où les bibliothèques de développement de FFmpeg sont installées après la compilation. La documentation n'est pas nécessaire, mais les fonctionnalités réseau doivent être activées. Pour compiler FFmpeg en tant que bibliothèques statiques, omettez l'option --enable-shared.

Si vous compilez FFmpeg avec un backend de sécurité, vous avez le choix entre 4 options (les mêmes que lorsque vous compilez pour Linux) mais seul OpenSSL est testé par les mainteneurs de QtMultimedia pour l'instant. Choisissez l'option appropriée et ajoutez-la lors de la configuration de FFmpeg :

--enable-openssl # For OpenSSL
--enable-gnutls # For GnuTLS
--enable-libtls # For LibreSSL (libtls)
--enable-mbedtls # For MbedTLS

Si vous utilisez OpenSSL, vous devez également ajouter les options suivantes lors de la configuration de FFmpeg. N'oubliez pas de remplacer <ANDROID_OPENSSL_INCLUDE_DIR> et <ANDROID_OPENSSL_LIBS_DIR> par les chemins réels.

--extra-cflags=-I<ANDROID_OPENSSL_INCLUDE_DIR> --extra-ldflags=-L<ANDROID_OPENSSL_LIBS_DIR>

Si le backend de sécurité est inclus, vous devez vous occuper de sa livraison vous-même, en vous assurant que les bibliothèques correctes sont installées sur la plateforme cible ou en utilisant des stubs. Les bibliothèques OpenSSL qui sont liées doivent être appelées libssl.so et libcrypto.so, sans suffixe de version. L'utilisateur doit s'assurer que les bibliothèques sont de la même version ABI que les en-têtes OpenSSL avec lesquels FFmpeg a été compilé. Pour plus d'informations, voir Ajouter le support OpenSSL pour Android.

Google Play exige des tailles de page de 16 Ko, pour construire des binaires FFmpeg compatibles, ajoutez les options de configuration suivantes à FFmpeg.

--extra-ldflags=-Wl,-z,max-page-size=16384

Pour les exigences de Google Play, voir l'exigence de compatibilité avec la taille de page de 16 Ko de Google Play.

Une fois la commande configure terminée, compilez et installez FFmpeg à l'aide de la commande make.

make -j install

Si la compilation se termine sans erreur, les bibliothèques de développement de FFmpeg sont installées dans le répertoire ../install-android. Si vous compilez Qt Multimedia, ce chemin est stocké dans la variable FFMPEG_DIR utilisée lors de la configuration de Qt Multimedia.