Requisitos previos de Qt para Android
Para desarrollar aplicaciones para Android con Qt, es necesario configurar el entorno de desarrollo con las herramientas y dependencias necesarias. Esta página ofrece instrucciones paso a paso para ayudarte a dar los primeros pasos.
Requisitos previos para el desarrollo en Android
Para desarrollar con Qt para Android, necesitarás los siguientes requisitos previos:
- Kit de desarrollo de Java (JDK)
- Herramientas de línea de comandos de Android, que incluyen:
- NDK de Android: para compilar código C++.
- Plataforma SDK de Android y herramientas de compilación del SDK de Android: para compilar aplicaciones de Android.
- Herramientas de la plataforma del SDK de Android: para implementar y gestionar las dependencias de Android.
Instalación de los requisitos previos
Uso de la configuración de desarrollo para Android de Qt Creator
La forma más sencilla de gestionar las dependencias es utilizando la configuración de desarrollo para Android integrada en Qt Creator. La primera vez que abras Qt Creator tras instalar Qt para Android, se te preguntará si deseas ejecutar el asistente de configuración de Android. Esto también configura OpenSSL para Android.
Utilizar una ubicación de SDK existente
Si ya tienes una configuración del SDK de Android, no es necesario que ejecutes este asistente. En su lugar, en Qt Creator, ve a Preferences > Devices > Android y selecciona las rutas de tu JDK y SDK existentes. Consulta las rutas habituales del SDK de Android. Para obtener más información, consulta Qt Creator: Configurar el entorno de desarrollo para Android.
Instalación manual de los requisitos previos
Si prefieres instalar manualmente los requisitos previos, sigue estos pasos.
- Instala el kit de desarrollo de Java (JDK).
El desarrollo de Qt para Android requiere el JDK 21 o superior, proporcionado por cualquiera de las siguientes distribuciones compatibles:
Instala el JDK que prefieras. Si el instalador no configura la variable de entorno `
JAVA_HOME` para que apunte a la ubicación del JDK instalado, puedes configurarla manualmente. Por ejemplo, en Linux:sudo apt-get install openjdk-21-jdk export JAVA_HOME=/usr/lib/jvm/java-21-openjdk-amd64O en macOS:
brew install openjdk@21 sudo ln -sfn "$(brew --prefix openjdk@21)/libexec/openjdk.jdk" \ "/Library/Java/JavaVirtualMachines/openjdk-21.jdk" export JAVA_HOME="$(/usr/libexec/java_home -v 21)" - Instala las herramientas de línea de comandos del SDK de Android. Descarga la última versión de las herramientas de línea de comandos del SDK de Android para tu sistema operativo y descomprímela en la ruta adecuada, tal y como se indica a continuación.
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\
O bien, utiliza el gestor de paquetes de tu sistema operativo; por ejemplo, en macOS:
brew install android-commandlinetools - Linux:
- Instala la plataforma SDK de Android, las herramientas de compilación y las herramientas de plataforma.
Asegúrate de instalar la plataforma SDK, las herramientas de plataforma y las herramientas de compilación. Para Qt 6.12, utiliza:
sdkmanager "platform-tools" "platforms;android-36" "build-tools;36.0.0" - Instala el NDK de Android.
Qt 6.12 utiliza el NDK 27.2.12479018; puedes instalarlo ejecutando:
sdkmanager "ndk;27.2.12479018" - (Opcional) Instala el emulador de Android.
Si desea utilizar el emulador de Android, puede instalarlo ejecutando:
sdkmanager "emulator" - Configuraciones específicas de cada plataforma
- En Windows, es necesario instalar el controlador USB adicional que se incluye en el paquete «extras» del SDK de Android. Instálalo ejecutando lo siguiente:
sdkmanager.bat "extras;google;usb_driver" - En Linux, se necesitan las siguientes dependencias para utilizar herramientas como
adbogdb, a las que se puede acceder a través de Qt Creator:sudo apt-get install libstdc++6 libncurses5Nota: Se requiere aceleraciónpor hardware para obtener un rendimiento aceptable del emulador de Android. Sin ella, el emulador utiliza la emulación de CPU por software, que funciona con extrema lentitud. Consulta Android: Aceleración del emulador para obtener más información.
- En Windows, es necesario instalar el controlador USB adicional que se incluye en el paquete «extras» del SDK de Android. Instálalo ejecutando lo siguiente:
Prueba de la configuración
Una vez instalados y configurados los requisitos previos, puede probar su entorno de desarrollo ejecutando los ejemplos incluidos en la instalación de Qt. Para obtener más información, consulte Ejemplos para dispositivos móviles.
© 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.