En esta página

Qt para Android: compilación a partir del código fuente

Esta página describe el proceso de configuración y compilación de Qt para Android. Para descargar e instalar una versión precompilada de Qt para Android, sigue las instrucciones de la página «Primeros pasos con Qt ».

Requisitos previos

Para compilar Qt para Android a partir del código fuente, asegúrate de que se cumplen todos los requisitos indicados en «Requisitos previos de Qt para Android» antes de continuar.

Windows

La compilación de Qt para Android en Windows también requiere el siguiente software:

  • Cadena de herramientas Mingw-w64 13.1

Nota: Qt para Android no admite la compilación a partir del código fuente con Microsoft Visual C++ (MSVC).

Instala los requisitos previos y añade las rutas de los binarios a la variable de sistema ` PATH`:

set MINGW_ROOT=<MINGW_ROOT_PATH>\bin
set PATH=%MINGW_ROOT%;%PATH%

Para comprobar la instalación, ejecuta:

where mingw32-make.exe

El comando debería mostrar en primer lugar mingw32-make.exe en la ruta <MINGW_ROOT>.

Obtención de los códigos fuente

Puedes descargar los códigos fuente de Qt desde la página de descargas de Qt o seguir la guía de la wiki sobre cómo obtener el código fuente.

Configuración

Con Qt 6, puedes compilar Qt para Android a partir del código fuente utilizando CMake. Qt 6 para Android requiere una compilación de Qt en el sistema anfitrión, lo que significa que, para compilar Qt para Android, debes compilar Qt para la plataforma de escritorio utilizada como sistema anfitrión (es decir, Linux, macOS o Windows). Consulta «Compilación cruzada de Qt » para obtener más detalles.

Para configurar Qt para Android, crea un directorio de compilación «sombra» para mantener limpio el directorio de código fuente:

mkdir -p ~/dev/build-qt-android
cd ~/dev/build-qt-android

Qt para Android es compatible con las siguientes arquitecturas de dispositivo (ABI): arm64-v8a, x86_64, x86 y armeabi-v7a

A continuación, ejecuta el script «configure» desde el directorio de compilación que acabas de crear:

<qt5_super_repo_path>/configure -prefix <install_path> -qt-host-path <qt_host_path> \
    -android-abis <abi> -android-sdk ~/Android/Sdk -android-ndk ~/Android/Sdk/ndk/27.2.12479018

El SDK de Android suele instalarse mediante Qt Creator o Android Studio en las siguientes ubicaciones:

  • Linux: ~/Android/Sdk/
  • macOS: ~/Library/Android/sdk/
  • Windows: C:\Users\<USER>\AppData\Local\Android\Sdk\

Nota: «configure» siempre utiliza el generador y la herramienta de compilación Ninja si hay un ejecutable de « ninja » disponible. Ninja es multiplataforma, cuenta con numerosas funciones, ofrece un gran rendimiento y se recomienda en todas las plataformas. El uso de otros generadores podría funcionar, pero no cuenta con soporte oficial.

Argumentos avanzados de «configure»

Antes de consultar esta sección, consulta Opciones de «configure» de Qt, que contiene más información sobre las opciones de «configure».

Qt para Android contiene código Java compilado en archivos *.jar con el compilador javac. Para establecer la versión de javac para el código fuente y el destino, utiliza -android-javac-source y -android-javac-target, respectivamente:

-android-javac-source 17 -android-javac-target 17

Para compilar Qt como una compilación de desarrollador en lugar de una compilación con prefijo, utiliza lo siguiente en lugar del argumento « -prefix »:

-developer-build

El argumento « -qt-host-path » debe apuntar al directorio « qtbase » dentro del directorio de compilación del host en una compilación de desarrollador del host. Por ejemplo: « ~/dev/build-qt-host/qtbase ».

Compilación

Para compilar Qt, ejecuta el siguiente comando:

cmake --build . --parallel

Instalación

Para compilaciones con prefijo, para instalar Qt, ejecuta el siguiente comando:

cmake --install .

En Unix, si no has especificado la opción de configuración ` -prefix <install_path> `, la instalación se realiza en ` /usr/local/Qt-<version>`; en ese caso, deberás utilizar ` sudo ` con el comando de instalación.

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