Compilación de FFmpeg desde el código fuente para Android en macOS
En esta página se explica cómo configurar y compilar FFmpeg para Android. La compilación para Android es una compilación cruzada y se da por hecho que se utiliza macOS como sistema host. 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.
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 guardas el código fuente de FFmpeg en ~/ffmpeg.
Requisitos previos
Para compilar FFmpeg, se requieren estas herramientas y paquetes:
- Homebrew.
- Paquetes de Homebrew (yasm).
También necesitarás tener instalados y configurados el NDK, el SDK y el JDK de Android. Puedes encontrar más información sobre cómo configurarlos aquí : Introducción a Qt para Android.
Instalación de Homebrew
Para instalar Homebrew, ejecuta:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"Instalación de paquetes de Homebrew
Para instalar el paquete de Homebrew Yasm, ejecuta:
brew install yasmConfigurar las variables de entorno
Esta parte no es estrictamente necesaria, pero ayudará a que el comando `configure` sea un poco más limpio y breve.
El siguiente comando da por hecho que el SDK de Android está instalado en ~/Library/Android/sdk y que la versión del NDK de Android es la 26.1.10909125.
export ANDROID_NDK_ROOT=~/Library/Android/sdk/ndk/26.1.10909125Se recomienda utilizar la misma versión del NDK que la indicada en la guía «Introducción a Qt para Android».
La arquitectura para la que debes compilar depende de los dispositivos de destino:
- aarch64 (ARM64-v8a): utilizada por la mayoría de los dispositivos Android modernos (64 bits).
- armv7 (armeabi-v7a): para dispositivos ARM más antiguos de 32 bits.
- x86: Principalmente para emuladores de Android que se ejecutan en procesadores Intel.
- x86_64: para emuladores basados en Intel de 64 bits o dispositivos especializados.
Configuración de variables específicas de la arquitectura
- 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
Configuración y compilación de FFmpeg
Crea un directorio « build-android » dentro del directorio « ~/ffmpeg » y accede a él:
mkdir ~/ffmpeg/build-android
cd ~/ffmpeg/build-androidPara configurar FFmpeg, ejecuta:
../configure --prefix=../install-android --disable-doc --enable-network --enable-shared \
--host-os=darwin-x86_64 --target-os=android \
--enable-cross-compile --arch=${ARCH} --cpu=${CPU} \
--enable-jni --enable-mediacodec \
--sysroot=${ANDROID_NDK_ROOT}/toolchains/llvm/prebuilt/darwin-x86_64/sysroot \
--sysinclude=${ANDROID_NDK_ROOT}/toolchains/llvm/prebuilt/darwin-x86_64/sysroot/usr/include/ \
--cc=${ANDROID_NDK_ROOT}/toolchains/llvm/prebuilt/darwin-x86_64/bin/${TOOLCHAIN_ARCH}24-clang \
--cxx=${ANDROID_NDK_ROOT}/toolchains/llvm/prebuilt/darwin-x86_64/bin/${TOOLCHAIN_ARCH}24-clang++ \
--strip=${ANDROID_NDK_ROOT}/toolchains/llvm/prebuilt/darwin-x86_64/bin/llvm-stripEl argumento --prefix especifica la ruta donde se instalarán las bibliotecas de desarrollo de FFmpeg tras la compilación. La documentación no es necesaria, pero deben habilitarse las funciones de red. Para compilar FFmpeg como bibliotecas estáticas, omite la opción --enable-shared.
Si estás compilando FFmpeg con un backend de seguridad, tienes 4 opciones entre las que elegir (las mismas que al compilar para Linux), pero, por ahora, los mantenedores de QtMultimedia solo han probado OpenSSL. Elige la opción adecuada y añádela durante la configuración de FFmpeg:
--enable-openssl # For OpenSSL
--enable-gnutls # For GnuTLS
--enable-libtls # For LibreSSL (libtls)
--enable-mbedtls # For MbedTLSSi utilizas OpenSSL, también debes añadir las siguientes opciones durante la configuración de FFmpeg. No olvides sustituir <ANDROID_OPENSSL_INCLUDE_DIR> y <ANDROID_OPENSSL_LIBS_DIR> por las rutas reales.
--extra-cflags=-I<ANDROID_OPENSSL_INCLUDE_DIR> --extra-ldflags=-L<ANDROID_OPENSSL_LIBS_DIR>Si se incluye el backend de seguridad, debes encargarte tú mismo de su implementación, asegurándote de que las bibliotecas correctas estén instaladas en la plataforma de destino o utilizando stubs. Las bibliotecas de OpenSSL que se enlazan deben llamarse libssl.so y libcrypto.so, sin ningún sufijo de versión. El usuario debe garantizar que las bibliotecas tengan la misma versión de ABI que los encabezados de OpenSSL con los que se compiló FFmpeg. Para obtener más información, consulta «Añadir compatibilidad con OpenSSL para Android».
Google Play exige un tamaño de página de 16 KB; para compilar binarios de FFmpeg compatibles, añade las siguientes opciones de configuración a FFmpeg.
--extra-ldflags=-Wl,-z,max-page-size=16384Para conocer los requisitos de Google Play, consulta «Requisito de compatibilidad con el tamaño de página de 16 KB de Google Play».
Una vez finalizado el comando « configure », compila e instala FFmpeg utilizando el comando « make ».
make -j installSi la compilación se completa sin errores, las bibliotecas de desarrollo de FFmpeg se instalarán en el directorio ../install-android. Si compilas Qt Multimedia, esta ruta se almacena en la variable FFMPEG_DIR, que se utiliza al configurar Qt Multimedia.
© 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.