En esta página

Compilación de proyectos Qt para Android desde la línea de comandos

Compilación con CMake

Para compilar proyectos CMake con Qt instalado, por ejemplo, en Linux, utiliza lo siguiente con el envoltorio qt-cmake:

~/Qt/<qt_version>/android_<abi>/bin/qt-cmake \
    -DANDROID_SDK_ROOT=~/Android/Sdk \
    -DANDROID_NDK_ROOT=~/Android/Sdk/ndk/27.2.12479018 \
    -S <source_dir> -B <build_dir> \
    -GNinja

A lo largo de esta página, utilizamos la ruta del SDK de Android para Linux por simplicidad; sin embargo, al ejecutar estos comandos, asegúrate de utilizar la ruta correspondiente a tu sistema.

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: Si utilizas un Qt compilado por ti mismo, no es necesario que proporciones los argumentos del SDK y del NDK, ya que qt-cmake utiliza los mismos valores que se emplearon para compilar Qt.

Compilación de paquetes multi-ABI con CMake

En Qt 6.12, existen varias formas de compilar un paquete con múltiples ABI. De forma predeterminada, solo se selecciona la única ABI que pertenece al script qt-cmake. Al establecer la variable QT_ANDROID_BUILD_ALL_ABIS en TRUE se habilita la detección automática de los SDK de Qt para Android disponibles. El mecanismo de detección asume el uso de la estructura de directorios predeterminada proporcionada por Qt Online Installer:

~/Qt/<qt_version>:
    android_arm64_v8a
    android_armv7
    android_x86
    android_x86_64

El siguiente comando muestra la forma más sencilla de compilar un paquete multi-ABI para Android utilizando los SDK de Qt para Android proporcionados por Qt Online Installer:

~/Qt/<qt_version>/android_<abi>/bin/qt-cmake \
    -DQT_ANDROID_BUILD_ALL_ABIS=TRUE \
    -DANDROID_SDK_ROOT=~/Android/Sdk \
    -DANDROID_NDK_ROOT=~/Android/Sdk/ndk/27.2.12479018 \
    -S <source_directory> -B <build_directory>
    -GNinja

Mediante la variable QT_ANDROID_ABIS, es posible personalizar la lista de ABI para las que se compila el proyecto. Los kits de desarrollo de Qt para Android correspondientes deben seguir la estructura de directorios descrita anteriormente. La siguiente línea de comandos configura un proyecto únicamente para las ABI de arm64-v8a y x86:

~/Qt/<qt_version>/android_<abi>/bin/qt-cmake \
    -DQT_ANDROID_ABIS="arm64-v8a;x86" \
    -DANDROID_SDK_ROOT=~/Android/Sdk \
    -DANDROID_NDK_ROOT=~/Android/Sdk/ndk/27.2.12479018 \
    -S <source_directory> -B <build_directory>
    -GNinja

Nota: La ABI del SDK principal al que pertenece el script qt-cmake se añade a la lista de ABI utilizadas de forma incondicional. No es posible excluirla de la compilación.

Nota: QT_ANDROID_BUILD_ALL_ABIS tiene mayor prioridad que QT_ANDROID_ABIS.

Las rutas a los SDK de Qt para Android que no coincidan con la estructura de directorios predeterminada pueden modificarse utilizando las variables QT_PATH_ANDROID_ABI_<ABI> correspondientes.

El siguiente ejemplo habilita la detección automática de los SDK de Qt para Android disponibles y especifica rutas personalizadas a los SDK armeabi-v7a y arm64-v8a:

<qt_for_android_install_path>/bin/qt-cmake \
    -DQT_ANDROID_BUILD_ALL_ABIS=TRUE
    -DQT_PATH_ANDROID_ABI_armeabi-v7a="<Qt/for/armeabi-v7a>" \
    -DQT_PATH_ANDROID_ABI_arm64-v8a="<Qt/for/arm64-v8a>" \
    -DANDROID_SDK_ROOT=~/Android/Sdk \
    -DANDROID_NDK_ROOT=~/Android/Sdk/ndk/27.2.12479018 \
    -S <source_directory> -B <build_directory>
    -GNinja

También es posible configurar la propiedad de destino QT_ANDROID_ABIS, que especifica una lista de ABI para las que se compila el destino de un único ejecutable. Por ejemplo:

qt_add_executable(MyApp main.cpp)
set_target_properties(MyApp PROPERTIES QT_ANDROID_ABIS "arm64-v8a;x86")

El objetivo MyApp se compilará únicamente para armeabi-v7a y arm64-v8a, incluso si se ha establecido la variable QT_ANDROID_BUILD_ALL_ABIS o QT_ANDROID_ABIS.

Creación del paquete de Android

Una vez configurado el proyecto, puede utilizar los siguientes objetivos de CMake para crear el paquete de la aplicación:

cmake --build . --target apk

O para generar el AAB:

cmake --build . --target aab

En segundo plano, el código Qt se compila y se copia al directorio android-build; a continuación, se utiliza Gradle para compilar el código Java y empaquetar la aplicación.

Firmar el paquete de Android

Si se compila un APK destinado a su publicación, debe firmarse. Para obtener más información sobre cómo firmar el paquete con Qt Creator, consulta «Firmar paquetes de Android». De lo contrario, comprueba las variables de CMake QT_ANDROID_SIGN_APK y QT_ANDROID_SIGN_AAB.

Compilación de un archivo AAR (archivo de Android)

Nota: La compatibilidad con la compilaciónde AAR se introdujo en Qt 6.8.

Un archivo AAR (Android Archive) es un formato de biblioteca de Android. A diferencia de un APK o un AAB, no se puede ejecutar de forma independiente, sino que está pensado para integrarse como dependencia en una aplicación nativa de Android. Esta es la configuración habitual cuando se aloja contenido Qt Qml dentro de una actividad nativa de Android.

Para generar un AAR, define tu aplicación Qt con ` qt_add_executable ` como de costumbre. Los objetivos de compilación AAR se crean automáticamente junto con los objetivos APK y AAB. Compila todos los paquetes AAR de un proyecto con:

cmake --build . --target aar

Para compilar solo el AAR para un objetivo específico denominado « myapp »:

cmake --build . --target myapp_make_aar

Compilación con qmake

Puedes seguir utilizando qmake para compilar proyectos de usuario, igual que en Qt 5.

Nota: La compilación de paquetes con múltiples ABI con ` qmake ` no está soportada en Qt 6.

Véase también QT_ANDROID_ABIS, QT_ANDROID_BUILD_ALL_ABIS, QT_PATH_ANDROID_ABI_<ABI> y QT_ANDROID_ABIS.

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