Compilation de FFmpeg à partir du code source pour Android sous Linux

Cette page explique comment configurer et compiler 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 requises sont les suivantes :

• Procurez-vous le code source de FFmpeg.
• Installez les dépendances requises.
• Configurer FFmpeg depuis la ligne de commande.
• Compiler les bibliothèques de développement.

Obtenir le code source de FFmpeg

Vous pouvez obtenir le code source de FFmpeg de différentes manières :

• Téléchargez-le depuis la page de téléchargement de FFmpeg.
• Cloner depuis Git. Par exemple, cette commande clone la version 9.0.1 des sources de FFmpeg vers ~/ffmpeg.

  git clone --branch n9.0.1 https://git.ffmpeg.org/ffmpeg.git ffmpeg

Il est recommandé d’utiliser la même version de FFmpeg que celle indiquée sur la page d’accueil deQt Multimedia .

Les paragraphes suivants partent du principe que vous stockez le code source de FFmpeg dans le répertoire ~/ffmpeg.

Prérequis

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

• Yasm.
• Les paquets de développement pour le backend de sécurité de votre choix (voir ci-dessous).

Vous devrez également disposer de l’NDK, du SDK et du JDK Android, installés et configurés. Vous trouverez plus d’informations sur leur configuration ici : « 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 aurez besoin du paquet de développement 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 étape n'est pas strictement nécessaire, mais elle permettra de rendre la commande `configure` un peu plus claire et plus concise.

La commande suivante part du principe que le SDK Android est installé dans le répertoire ~/Android/sdk et que la version du NDK Android est la 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 indiquée dans le guide « Getting Started with Qt for Android ».

L'architecture pour laquelle vous devez effectuer la compilation dépend des appareils cibles :

• 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

Configuration et compilation de FFmpeg

Créez un répertoire « build-android » à l'intérieur du répertoire « ~/ffmpeg » et accédez-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 le chemin d'accès où les bibliothèques de développement de FFmpeg seront 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 sous forme de 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 lors de la compilation pour Linux), mais seul OpenSSL a été testé par les responsables d'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 d’accès 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 charger vous-même de sa mise en œuvre, en vous assurant que les bibliothèques appropriées sont installées sur la plateforme cible ou en utilisant des stubs. Les bibliothèques OpenSSL liées doivent être nommées libssl.so et libcrypto.so, sans aucun 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 lesquelles FFmpeg a été compilé. Pour plus d’informations, consultez la section « Ajout de la prise en charge d’OpenSSL pour Android ».

Google Play impose une taille de page de 16 Ko ; pour créer des binaires FFmpeg compatibles, ajoutez les options de configuration suivantes à FFmpeg.

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

Pour connaître les exigences de Google Play, consultez la section « Exigence de compatibilité avec une taille de page de 16 Ko sur 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 s’effectue sans erreur, les bibliothèques de développement 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`.