Construire FFmpeg à partir des sources sur macOS
Cette page explique comment configurer et construire FFmpeg sur macOS. 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 :
- Homebrew.
- Paquets Homebrew (yasm).
Installation de Homebrew
Pour installer Homebrew, exécutez :
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Installer les paquets Homebrew
Pour installer le paquetage Homebrew Yasm, exécutez :
brew install yasm
Configuration et construction de FFmpeg
Créez un répertoire build à l'intérieur du répertoire ~/ffmpeg et naviguez-y :
mkdir ~/ffmpeg/build cd ~/ffmpeg/build
Pour configurer FFmpeg, exécutez :
../configure --prefix=/usr/local/ffmpeg --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.
Dans l'extrait de code précédent, un chemin absolu a été utilisé intentionnellement pour l'argument --prefix. Si vous spécifiez un chemin relatif (par exemple, ../install), les dépendances seront référencées en utilisant ce chemin relatif et non le chemin correct en utilisant @rpath. L'utilisation de chemins absolus rend la compilation de FFmpeg non portable. Pour utiliser des chemins relatifs et rendre la compilation de FFmpeg portable, vous devez corriger manuellement les dépendances en utilisant otool.
Une fois la commande configure terminée, compilez 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 /usr/local/ffmpeg. Si vous compilez Qt Multimedia, ce chemin est stocké dans la variable FFMPEG_DIR utilisée lors de la configuration de Qt Multimedia.
Configuration et construction des binaires universels de FFmpeg
Pour créer des binaires universels sur macOS (par exemple, pour les architectures x86_64 et arm64), suivez les étapes suivantes :
- Configurez et compilez FFmpeg pour l'architecture arm64 :
../configure --prefix=/usr/local/ffmpeg/arm64 --disable-doc --enable-network \ --enable-shared --enable-cross-compile --arch=arm64 --cc="clang -arch arm64" make -j install - Configurez et construisez FFmpeg pour l'architecture x86_64 :
../configure --prefix=/usr/local/ffmpeg/x86_64 --disable-doc --enable-network \ --enable-shared --enable-cross-compile --arch=x86_64 --cc="clang -arch x86_64" make -j install - Combinez les builds en un binaire universel en utilisant lipo.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.