Sur cette page

qt_add_ios_ffmpeg_libraries

Fonction auxiliaire permettant d'intégrer les binaires FFmpeg dans le bundle d'une application iOS.

La commande est définie dans le composant « Multimedia » du paquet « Qt6 », qui peut être chargé comme suit :

find_package(Qt6 REQUIRED COMPONENTS Multimedia)

Cette commande a été introduite dans Qt 6.8.

Remarque : cette commande est en avant-première technologique et est susceptible d'évoluer dans les prochaines versions.

Syntaxe

qt_add_ios_ffmpeg_libraries(target)

Si les commandes sans version sont désactivées, utilisez plutôt qt6_add_ios_ffmpeg_libraries(). Elle prend en charge le même ensemble d’arguments que cette commande.

Description

Les binaires FFmpeg provenant du programme d'installation en ligne doivent être intégrés dans le bundle de l'application. Pour intégrer les binaires FFmpeg, vous pouvez ajouter la commande qt_add_ios_ffmpeg_libraries à une cible exécutable dans le fichier CMakeLists.txt du projet.

Cette fonction doit être appelée sur une cible exécutable. Elle ne peut pas être utilisée sur des cibles de bibliothèque ou d’interface. Si votre projet est une bibliothèque liée à Qt Multimedia, l’exécutable auquel elle est liée doit appeler cette fonction.

Cette commande définit plusieurs propriétés pour la cible d'application :

  • XCODE_EMBED_FRAMEWORKS, ajoute les informations destinées à XCode (quels binaires FFmpeg intégrer).
  • XCODE_EMBED_FRAMEWORKS_CODE_SIGN_ON_COPY est défini sur ON, afin que les binaires FFmpeg intégrés soient signés.
  • XCODE_ATTRIBUTE_LD_RUNPATH_SEARCH_PATHS : permet d’ajouter l’emplacement des bibliothèques FFmpeg intégrées au sein du bundle.

Si la signature de code n'est pas requise, vous pouvez utiliser la variable QT_NO_FFMPEG_XCODE_EMBED_FRAMEWORKS_CODE_SIGN_ON_COPY avant la commande « qt_add_ios_ffmpeg_libraries » :

set(QT_NO_FFMPEG_XCODE_EMBED_FRAMEWORKS_CODE_SIGN_ON_COPY ON)

Remarque : la commande « qt_add_ios_ffmpeg_libraries » nécessite CMake 3.28 ou une version ultérieure.

Remarque : cette commande n'a aucun effet si le backend FFmpeg n'a pas été compilé pour ce paquet Qt pour iOS.

© 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.