Qt para Android - Construir desde el código fuente
Esta página describe el proceso de configuración y construcción de Qt para Android. Para descargar e instalar un Qt para Android precompilado, siga las instrucciones de la página Introducción a Qt.
Requisitos previos
Para compilar Qt para Android desde el código fuente, asegúrese de que se cumplen todos los requisitos de Introducción a Qt para Android antes de continuar.
Windows
Construir Qt para Android en Windows también requiere el siguiente software:
- Mingw-w64 13.1 toolchain
Nota: Qt para Android no admite la compilación desde el código fuente con Microsoft Visual C++ (MSVC).
Instale los requisitos previos y añada sus rutas binarias al sistema PATH:
set MINGW_ROOT=<MINGW_ROOT_PATH>\bin set PATH=%MINGW_ROOT%;%PATH%
Para verificar la instalación, ejecute:
where mingw32-make.exe
El comando debe listar primero mingw32-make.exe bajo la ruta <MINGW_ROOT>.
Obtener los fuentes
Puedes descargar los fuentes de Qt desde la página de descargas de Qt, o seguir la guía wiki para Obtener el código fuente.
Configurando
Con Qt 6, puedes construir Qt para Android desde el código fuente usando CMake. Qt 6 para Android requiere una compilación Qt host, lo que significa que para compilar Qt para Android, es necesario compilar Qt para la plataforma de escritorio utilizada como host (es decir, Linux, macOS o Windows). Consulte Compilación cruzada de Q t para obtener más detalles.
Para configurar Qt para Android, cree un directorio de compilación sombra para mantener limpio el directorio fuente:
mkdir -p ~/dev/build-qt-android cd ~/dev/build-qt-android
Qt para Android soporta las siguientes arquitecturas de dispositivo (ABIs): arm64-v8a, x86_64, x86, y armeabi-v7a
A continuación, ejecuta el script de configuración 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 se instala normalmente 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 Ninja y la herramienta de compilación si hay un ejecutable ninja disponible. Ninja es multiplataforma, rico en características, performante y recomendado en todas las plataformas. El uso de otros generadores puede funcionar pero no está soportado oficialmente.
Argumentos avanzados de configuración
Antes de explorar esta sección, consulte Opciones de configuración de Qt, que contiene más información sobre las opciones de configuración.
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, utilice -android-javac-source y -android-javac-target respectivamente:
-android-javac-source 8 -android-javac-target 8
Para compilar Qt como una compilación para desarrolladores en lugar de una compilación de prefijo, utilice lo siguiente en lugar del argumento -prefix:
-developer-build
-qt-host-path debe apuntar al directorio qtbase del directorio de compilación del host en una compilación de desarrollador del host. Por ejemplo: ~/dev/build-qt-host/qtbase.
Compilación de
Para compilar Qt, ejecute el siguiente comando:
cmake --build . --parallel
Instalación
Para las compilaciones prefijo, para instalar Qt, ejecute el siguiente comando:
cmake --install .
En Unix, si no has proporcionado la opción -prefix <install_path> configure, la instalación se coloca bajo /usr/local/Qt-<version>, en ese caso, necesitarías usar sudo con el comando install.
© 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.