Compilación de FFmpeg desde el código fuente para iOS en macOS
Esta página explica cómo configurar y compilar FFmpeg para iOS como marcos de trabajo. La compilación para iOS es una compilación cruzada y requiere utilizar macOS como sistema anfitrión. Los pasos necesarios son:
- Obtener el código fuente de FFmpeg.
- Instalar las dependencias necesarias.
- Configurar FFmpeg desde la línea de comandos.
- Compilar las bibliotecas de desarrollo.
- Crear marcos de trabajo para iOS a partir de las bibliotecas de FFmpeg.
- Crea XCFrameworks.
- Incorpora los frameworks en un paquete de aplicación.
Obtener el código fuente de FFmpeg
Puedes obtener el código fuente de FFmpeg de las siguientes formas:
- Descargándolo desde la página de descargas de FFmpeg.
- Clonarlo desde Git. Por ejemplo, este comando clona la versión 9.0.1 del código fuente de FFmpeg en
~/ffmpeg.git clone --branch n9.0.1 https://git.ffmpeg.org/ffmpeg.git ffmpeg
Se recomienda utilizar la misma versión de FFmpeg que la indicada en la página principal deQt Multimedia .
En los párrafos siguientes se da por hecho que has guardado el código fuente de FFmpeg en ~/ffmpeg.
Requisitos previos
Para compilar FFmpeg, se necesitan las siguientes herramientas y paquetes:
- Xcode, que proporciona el conjunto de herramientas (compilador, enlazador y otras herramientas) y el SDK de la plataforma iOS (cabeceras y bibliotecas) con las que se compila y se realiza el enlace.
Configuración y compilación de FFmpeg
Crea los directorios « build » y « installed » dentro del directorio « ~/ffmpeg » y accede a « build »:
mkdir ~/ffmpeg/build
mkdir ~/ffmpeg/installed
cd ~/ffmpeg/buildPara configurar FFmpeg, ejecuta:
../ffmpeg_src/configure --disable-programs --disable-doc --enable-network --enable-shared --disable-static \
--sysroot="$(xcrun --sdk iphoneos --show-sdk-path)" \
--enable-cross-compile \
--arch=arm64 \
--prefix=../installed \
--cc="xcrun --sdk iphoneos clang -arch arm64" \
--cxx="xcrun --sdk iphoneos clang++ -arch arm64" \
--extra-cflags="-miphoneos-version-min=16.0" \
--extra-cxxflags="-miphoneos-version-min=16.0" \
--extra-objcflags="-miphoneos-version-min=16.0" \
--extra-ldflags="-miphoneos-version-min=16.0" \
--install-name-dir='@rpath' \
--disable-audiotoolboxNo se necesitan los programas de línea de comandos ni la documentación; las funciones de red deben estar habilitadas. Compilamos bibliotecas compartidas y no necesitamos bibliotecas estáticas (omite --disable-static para compilar bibliotecas estáticas). --sysroot especifica la raíz del árbol de compilación cruzada. El argumento --prefix especifica la ruta donde se instalarán las bibliotecas de FFmpeg tras la compilación. Compilamos en un host macOS para el destino iOS, por lo que habilitamos la compilación cruzada. ` --extra-ldflags ` establece la versión mínima de iOS. ` --install-name-dir ` es una cadena que especifica la parte del directorio del campo «install_name» de las bibliotecas compartidas en plataformas de Apple para los destinos instalados. AudioToolBox está desactivado, ya que FFmpeg utiliza partes del marco AudioToolBox que no están disponibles en iOS.
Nota: En el ejemplo anterior, si se sustituye «iphoneos» por «iphonesimulator» y «miphoneos-version» por «mios-simulator-version-min», se configura FFmpeg para que se compile como bibliotecas adecuadas para el simulador de iOS.
Para obtener ayuda sobre otras opciones de configuración, ejecuta:
../ffmpeg_src/configure --helpUna vez completada la configuración, compila las bibliotecas de FFmpeg:
make -j installCreación de marcos de trabajo de iOS a partir de las bibliotecas de FFmpeg
Para que funcionen en aplicaciones de iOS, las bibliotecas dinámicas de FFmpeg deben convertirse en marcos de trabajo e integrarse en los paquetes de las aplicaciones. Un marco de trabajo es un directorio jerárquico que encapsula recursos como una biblioteca dinámica, archivos de imagen, cadenas localizadas, archivos de cabecera y documentación de referencia en un único paquete. En nuestro caso, los frameworks de FFmpeg solo contienen bibliotecas dinámicas y los correspondientes archivos Info.plist. Por ejemplo, libavcodec, una vez convertido en framework, se convierte en el directorio libavcodec.framework con el siguiente contenido:
- Info.plist (que contiene la descripción del marco)
- libavcodec (biblioteca dinámica)
A diferencia de las bibliotecas dinámicas que compilamos en el paso anterior, las bibliotecas dinámicas dentro de los marcos de trabajo de iOS no tienen versión y carecen de la extensión «dylib». Esto requiere corregir los nombres de identificación y las dependencias de nuestras bibliotecas dinámicas. La utilidad otool nos ayuda a encontrar dichos nombres. Por ejemplo:
otool -L ../installed/lib/libavcodec.dylibnos proporciona estos nombres (solo mostramos los relacionados con FFmpeg):
@rpath/libavcodec.61.dylib (compatibility version 61.0.0, current version 61.19.100)
@rpath/libswresample.5.dylib (compatibility version 5.0.0, current version 5.3.100)
@rpath/libavutil.59.dylib (compatibility version 59.0.0, current version 59.39.100)Para corregir estos nombres, utiliza la utilidad install_name_tool. Las opciones de la utilidad son:
-id- permite cambiar el nombre de identificación de la biblioteca compartida.-change- permite cambiar el nombre de instalación de la biblioteca compartida dependiente.
Este script convierte las bibliotecas dinámicas compiladas anteriormente en marcos. El código da por hecho que se ejecuta desde el directorio build y que los marcos se encuentran en ~/ffmpeg/installed/framework:
#!/usr/bin/env bash
# Creates an Info.plist file for a given framework:
build_info_plist() {
local file_path="$1"
local framework_name="$2"
local framework_id="$3"
# Minimum version must be the same we used when building FFmpeg.
local minimum_version_key="MinimumOSVersion"
local minimum_os_version="16.0"
local supported_platforms="iPhoneOS"
info_plist="<?xml version=\"1.0\" encoding=\"UTF-8\"?>
<!DOCTYPE plist PUBLIC \"-//Apple//DTD PLIST 1.0//EN\" \"http://www.apple.com/DTDs/PropertyList-1.0.dtd\">
<plist version=\"1.0\">
<dict>
<key>CFBundleDevelopmentRegion</key>
<string>en</string>
<key>CFBundleExecutable</key>
<string>${framework_name}</string>
<key>CFBundleIdentifier</key>
<string>${framework_id}</string>
<key>CFBundleInfoDictionaryVersion</key>
<string>6.0</string>
<key>CFBundleName</key>
<string>${framework_name}</string>
<key>CFBundlePackageType</key>
<string>FMWK</string>
<key>CFBundleShortVersionString</key>
<string>9.0.1</string>
<key>CFBundleVersion</key>
<string>9.0.1</string>
<key>CFBundleSignature</key>
<string>????</string>
<key>${minimum_version_key}</key>
<string>${minimum_os_version}</string>
<key>CFBundleSupportedPlatforms</key>
<array>
<string>${supported_platforms}</string>
</array>
<key>NSPrincipalClass</key>
<string></string>
</dict>
</plist>"
echo $info_plist | tee ${file_path} 1>/dev/null
}
dylib_regex="^@rpath/.*\.dylib$"
# Creates framework from a dylib file:
create_framework() {
local framework_name="$1"
local ffmpeg_library_path="../installed"
local framework_complete_path="${ffmpeg_library_path}/framework/${framework_name}.framework/${framework_name}"
# Create framework directory and copy dylib file to this directory:
mkdir -p "${ffmpeg_library_path}/framework/${framework_name}.framework"
cp "${ffmpeg_library_path}/lib/${framework_name}.dylib" "${ffmpeg_library_path}/framework/${framework_name}.framework/${framework_name}"
# Change the shared library identification name, removing version number and 'dylib' extension;
# \c Frameworks part of the name is needed since this is where frameworks will be installed in
# an application bundle:
install_name_tool -id @rpath/Frameworks/${framework_name}.framework/${framework_name} "${framework_complete_path}"
# Add Info.plist file into the framework directory:
build_info_plist "${ffmpeg_library_path}/framework/${framework_name}.framework/Info.plist" "${framework_name}" "io.qt.ffmpegkit."${framework_name}
otool -L "$framework_complete_path" | awk '/\t/ {print $1}' | egrep "$dylib_regex" | while read -r dependency_path; do
found_name=$(tmp=${dependency_path/*\/}; echo ${tmp/\.*})
if [ "$found_name" != "$framework_name" ]
then
# Change the dependent shared library install name to remove version number and 'dylib' extension:
install_name_tool -change "$dependency_path" @rpath/Frameworks/${found_name}.framework/${found_name} "${framework_complete_path}"
fi
done
}
ffmpeg_libs="libavcodec libavformat libavutil libswresample libswscale"
for name in $ffmpeg_libs; do
create_framework $name
doneCreación de un paquete de marcos binarios multiplataforma
Un paquete XCFramework es un paquete que incluye los marcos y las bibliotecas necesarios para compilar para múltiples plataformas, por ejemplo, iOS y el simulador de iOS. Para crear un marco de este tipo, utiliza la utilidad ` xcodebuild `. Por ejemplo, si tienes marcos para iOS y el simulador ubicados en los directorios ` ~/ffmpeg/installed/arm64 ` y ` ~/ffmpeg/installed/arm64-simulator `, los argumentos de la utilidad serían los siguientes:
xcodebuild -create-xcframework -framework ../installed/arm64/libavcodec.framework -framework ../installed/arm64-simulator/libavcodec.framework -output ../installed/framework/libavcodec.xcframeworkIncorporación de marcos
Incorpora los marcos de trabajo de FFmpeg en un paquete de aplicación. Para obtener información sobre cómo incorporar marcos de trabajo utilizando XCode, consulta
© 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.