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.exeEl 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-androidQt 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.12479018El 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 17Para 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-buildEl 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 . --parallelInstalació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.