En esta página

Compilación de FFmpeg desde el código fuente para Android en Windows

Esta página 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 Windows 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 C:\FFmpeg\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 C:\FFmpeg\ffmpeg.

Requisitos previos

Para compilar FFmpeg, se necesitan las siguientes herramientas y paquetes:

  • Compilador MinGW-w64.
  • MSYS2.
  • Paquetes MSYS (make, 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».

Consulta «Qt para Windows: compilación desde el código fuente» para ver los compiladores recomendados que también son compatibles con Qt. Puedes instalar un compilador MinGW-w64 compatible utilizando el archivo « Qt Online Installer ».

Instalación de MSYS2

Para instalar MSYS2, puedes:

Las instrucciones de este documento dan por hecho que MSYS2 está instalado en C:\msys64\, que es la ruta predeterminada al utilizar winget.

Una vez instalado, abre el shell de MSYS2 MINGW64 desde el menú de inicio de Windows y utilízalo para instalar las bibliotecas necesarias.

pacman -S --noconfirm make yasm diffutils

Antes de compilar FFmpeg, MSYS2 debe tener un compilador en su directorio PATH. Esto se hace de forma diferente para MSVC y MinGW-w64. Prepara el entorno MSYS2 para el compilador que utilices.

Preparación del entorno MSYS para la compilación con MinGW-w64

Si tienes MinGW-w64 instalado en C:\Qt\Tools\mingw1310_64\bin, puedes añadirlo a la variable de entorno PATH exportando la variable de entorno PATH.

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

Ten en cuenta que también es posible instalar MinGW-w64 mediante pacman.

pacman -S mingw-w64-x86_64-toolchain

Configurar las variables de entorno

Esta parte no es estrictamente necesaria, pero ayudará a que el comando `configure` resulte un poco más limpio y breve.

El siguiente comando da por hecho que el SDK de Android está instalado en C:\Users\<USER>\AppData\Local\Android\Sdk y que la versión del NDK de Android es la 26.1.10909125.

export ANDROID_NDK_ROOT=/c/Users/<USER>/AppData/Local/Android/Sdk/ndk/26.1.10909125

Se recomienda utilizar la misma versión del NDK que se indica 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

Desde el shell de MSYS2 preparado, acceda al directorio /c/FFmpeg. En este directorio, cree un directorio build-android que contendrá los archivos de compilación de FFmpeg, y acceda a él.

cd /c/FFmpeg/build-android

Para configurar FFmpeg, ejecuta:

../configure --prefix=../install-android --disable-doc --enable-network --enable-shared \
    --host-os=windows-x86_64 --target-os=android \
    --enable-cross-compile --arch=${ARCH} --cpu=${CPU} \
    --enable-jni --enable-mediacodec \
    --sysroot=${ANDROID_NDK_ROOT}/toolchains/llvm/prebuilt/windows-x86_64/sysroot \
    --sysinclude=${ANDROID_NDK_ROOT}/toolchains/llvm/prebuilt/windows-x86_64/sysroot/usr/include/ \
    --cc=${ANDROID_NDK_ROOT}/toolchains/llvm/prebuilt/windows-x86_64/bin/${TOOLCHAIN_ARCH}24-clang \
    --cxx=${ANDROID_NDK_ROOT}/toolchains/llvm/prebuilt/windows-x86_64/bin/${TOOLCHAIN_ARCH}24-clang++ \
    --strip=${ANDROID_NDK_ROOT}/toolchains/llvm/prebuilt/windows-x86_64/bin/llvm-strip

El 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 cuatro 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 MbedTLS

Si 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ñada las siguientes opciones de configuración a FFmpeg.

--extra-ldflags=-Wl,-z,max-page-size=16384

Para 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 install

Si la compilación se completa sin errores, las bibliotecas de desarrollo de FFmpeg se instalan en el directorio C:\FFmpeg\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.