Construire FFmpeg à partir des sources sous Windows

Cette page explique comment configurer et construire FFmpeg sous Windows. 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 C:\FFmpeg\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 C:\FFmpeg\ffmpeg.

Conditions préalables

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

• Compilateur Microsoft Visual Studio (MSVC) ou MinGW-w64.
• MSYS2.
• Paquets MSYS (make, yasm).

Voir Qt for Windows - Building from Source pour les compilateurs recommandés qui sont également pris en charge par Qt. Vous pouvez installer un compilateur MinGW-w64 supporté en utilisant le site Qt Online Installer.

Installation de MSYS2

Pour installer MSYS2, vous pouvez

• utiliser le programme d'installation de MSYS2
• Utiliser le gestionnaire de paquets winget.

  winget install msys2.msys2

Les instructions de ce document s'appuient sur l'installation de MSYS2 sur C:\msys64\, qui est le chemin par défaut lors de l'utilisation de winget.

Une fois installé, lancez le shell MSYS2 MINGW64 à partir du menu de démarrage de Windows, et utilisez-le pour installer les bibliothèques nécessaires.

pacman -S --noconfirm make yasm diffutils

Avant de construire FFmpeg, MSYS2 doit avoir un compilateur sur son site PATH. Cela se fait différemment pour MSVC et MinGW-w64. Préparez l'environnement MSYS2 pour le compilateur que vous utilisez.

Préparation de l'environnement MSYS pour la construction avec Mingw-w64

Pour MinGW-w64 installé sous C:\Qt\Tools\mingw1310_64\bin, vous pouvez l'ajouter à PATH en exportant la variable d'environnement PATH.

export PATH=/c/Qt/Tools/mingw1310_64/bin:$PATH

Notez qu'il est également possible d'installer MinGW-w64 à l'aide de pacman.

pacman -S mingw-w64-x86_64-toolchain

Préparation de l'environnement MSYS2 pour le MSVC

Construire FFmpeg avec le compilateur MSVC sous MSYS2 nécessite que MSYS2 soit démarré avec le compilateur C et C++ approprié dans le chemin. Pour une compilation en 64 bits, vous pouvez

• Lancer Visual Studio x64 Native Tools Command Prompt à partir du menu de démarrage de Windows.
• Activer le compilateur MSVC à partir d'une invite de commande existante en exécutant :

  "C:\Program Files\Microsoft Visual Studio\2022\BuildTools\VC\Auxiliary\Build\vcvarsall.bat" amd64

À partir de cette invite de commande, lancez l'interpréteur de commandes MSYS2 en sélectionnant l'environnement MINGW64 et en activant l'héritage du chemin d'accès.

C:\msys64\msys2_shell.cmd -mingw64 -full-path

Ceci lance une nouvelle fenêtre de l'interpréteur de commandes dans laquelle vous pouvez vérifier que le compilateur MSVC est disponible.

which cl.exe

Configurer et compiler FFmpeg

À partir de l'interpréteur de commandes MSYS2 préparé, naviguez jusqu'au répertoire /c/FFmpeg. Dans ce répertoire, créez un répertoire build qui contiendra les artefacts de construction de FFmpeg, et naviguez-y.

cd /c/FFmpeg/build

Pour configurer FFmpeg, exécutez :

../configure --prefix=../install --disable-doc --enable-network --enable-shared

L'argument --prefix spécifie un chemin où les bibliothèques de développement de FFmpeg sont installées après la construction. 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.

Pour configurer FFmpeg afin qu'il soit construit avec MSVC, spécifiez la chaîne d'outils en plus des autres options de la ligne de commande :

../configure --prefix=../install --disable-doc --enable-network --enable-shared --toolchain=msvc

Une fois la commande configure terminée, construisez et installez FFmpeg en utilisant 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 C:\FFmpeg\install. Si vous compilez Qt Multimedia, ce chemin est stocké dans la variable FFMPEG_DIR utilisée lors de la configuration de Qt Multimedia.