En esta página

Implementación de una aplicación en Android

Este artículo describe los pasos técnicos necesarios para implementar una aplicación Qt en un dispositivo Android.

Opciones de empaquetado para Android

El código en Android se puede empaquetar de tres formas: como paquete de aplicación (APK), como paquete de aplicaciones de Android (AAB) o como archivo de Android (AAR). Cada uno de ellos es un tipo específico de formato ZIP que sigue una estructura de directorios predefinida. Las diferencias entre estos formatos son:

  • Los archivos APK se pueden instalar y ejecutar en un dispositivo.
  • Un AAB está pensado para ser interpretado por Google Play Store y se utiliza para generar archivos APK para diferentes arquitecturas de dispositivos y factores de forma.
  • Un AAR difiere fundamentalmente de los formatos APK y AAB en que es una biblioteca de Android. Se puede utilizar como dependencia de un módulo de aplicación de Android, pero no se puede ejecutar por sí solo. Para obtener más información, consulta Android: Archivo de Android (AAR).

Paquete de aplicaciones de Android

Para probar la aplicación de forma local, el formato APK es el adecuado, ya que se puede instalar y ejecutar directamente en el dispositivo. Para su distribución en Google Play, se recomienda utilizar en su lugar el formato AAB, que tiene una estructura similar. La ventaja adicional del AAB es que permite incluir todas las ABI de destino en el mismo paquete sin aumentar el tamaño del paquete que descargan los usuarios. Al utilizar el AAB, Google Play genera paquetes APK optimizados para los dispositivos que solicitan la descarga y los firma automáticamente con tu clave de editor. Para obtener más información, consulta Publicación en Google Play.

Para obtener más información sobre el formato AAB, consulta Paquetes de aplicaciones de Android.

En cualquier caso, el paquete de la aplicación se genera a partir de una estructura de directorios específica que contiene las bibliotecas « shared » de tu proyecto y las dependencias de Qt que necesita tu aplicación. Además, se compilan e incluyen todos los activos, recursos, archivos « jar » o código Java del proyecto.

Generación del paquete de la aplicación

Se recomienda utilizar Qt Creator para implementar aplicaciones Qt para Android. De lo contrario, se puede hacer lo mismo desde la línea de comandos con la ayuda de CMake o qmake. Para obtener más información, consulta «Compilación de proyectos Qt para Android desde la línea de comandos».

El proceso de empaquetado e implementación lo gestionan CMake o qmake, que, en segundo plano, utilizan la herramienta androiddeployqt para gestionar los detalles específicos de la compilación e implementación de una aplicación para Android. Qt Creator también utiliza la misma herramienta.

Ampliación de Qt con funciones de Android

Por defecto, Qt para Android se encarga de la mayor parte del trabajo pesado para poner en marcha una aplicación de Android, ya sea disponiendo de las API más útiles directamente desde Qt o utilizando QJniObject para invocar aquellas API que no están disponibles de forma inmediata. Lo mismo ocurre con CMake, que se encarga de los distintos casos de compilación e implementación. Sin embargo, en algunos casos puede ser necesario disponer de toda la potencia de las funciones nativas de Android, como escribir código en Java o Kotlin, o utilizar la gestión de recursos de Android. Qt lo permite al ofrecer al usuario la posibilidad de ampliar el conjunto de plantillas.

Las plantillas predeterminadas que utiliza Qt se encuentran en la ruta de instalación de Qt para Android; por ejemplo, en ~/Qt/<version>/android_<abi>/src/android/templates para Unix. Para utilizar esas plantillas, puedes hacer que Qt Creator las copie a tu proyecto; consulta Qt Creator: Configuración de implementación de Android Deploy Qt. O bien, puedes copiarlas manualmente en el código fuente de tu proyecto, en un subdirectorio llamado « android ». A continuación, asegúrate de definir la siguiente propiedad en tu archivo « CMakeLists.txt »:

set_property(TARGET target_name PROPERTY QT_ANDROID_PACKAGE_SOURCE_DIR
          "${CMAKE_CURRENT_SOURCE_DIR}/android")

O, si utilizas qmake, en tu archivo ` pro `:

android: ANDROID_PACKAGE_SOURCE_DIR = $$PWD/android

Nota: Al utilizar Qt Creator, los archivos que se encuentran en esta ruta son visibles por defecto en los archivos del proyecto si se utiliza CMake. Para conseguir el mismo comportamiento con qmake, añade manualmente esas rutas de archivo a tu proyecto utilizando DISTFILES.

El proceso de compilación copia las plantillas al directorio de compilación <build_path>/android-build desde tu proyecto o desde las plantillas predeterminadas si el proyecto no ha establecido QT_ANDROID_PACKAGE_SOURCE_DIR. A continuación, el directorio <build_path>/android-build actúa como directorio de empaquetado. El paquete de la aplicación se crea desde allí utilizando Gradle.

Con QT_ANDROID_GRADLE_MULTI_MODULE habilitado, el directorio de empaquetado contiene, en su lugar, un proyecto de Gradle con varios módulos. A continuación, la aplicación se empaqueta desde <build_path>/android-build/app, y cada característica dinámica obtiene su propio módulo junto a ella.

Ahora, repasemos las diferentes partes con las que el usuario puede trabajar tras ampliar las plantillas predeterminadas.

AndroidManifest.xml

El archivo AndroidManifest.xml proporciona metainformación detallada sobre tu aplicación. Esta información se utiliza para personalizar el paquete de tu aplicación, y el dispositivo la utiliza para decidir qué funciones habilitar, como la orientación predeterminada de la aplicación. Además, Google Play Store la utiliza para obtener información sobre el código de versión, la compatibilidad con dispositivos, el nombre del paquete y mucho más. El manifiesto de Android también se utiliza para definir servicios de Android y actividades personalizadas de Android.

Para obtener más información sobre el « AndroidManifest.xml », consulta la documentación del archivo Android Manifest y {Qt Creator: Configuración de implementación de Android}{Edición de archivos Manifest}.

Archivos de Gradle

Gradle se utiliza para compilar paquetes de Android. Qt incluye dos conjuntos de archivos relacionados con Gradle:

  • El envoltorio de Gradle, que se utiliza para descargar una versión específica del propio Gradle, y los scripts de compilación que se utilizan para iniciar la compilación con Gradle. Estos archivos se incluyen con Qt, por ejemplo, en ~/Qt/<version>/android_<abi>/src/3rdparty/gradle.

    Nota: Por lo general , se recomienda utilizar la misma versión de Gradle que incluye Qt. No obstante, si deseas utilizar una versión diferente de Gradle, puedes modificar el envoltorio de Gradle gradle-wrapper.properties y configurarlo con la versión de Gradle que desees utilizar.

  • El archivo de configuración de Gradle build.gradle, que se encuentra en las plantillas de Android. Este archivo es necesario para Gradle y se puede utilizar para personalizar la compilación. Se puede utilizar para establecer el objetivo de compilación o la API mínima, o para añadir dependencias de bibliotecas. También se puede utilizar para configurar el complemento de Gradle para Android, que es una dependencia necesaria de Gradle para compilar aplicaciones de Android. Un ejemplo de ello es:
    buildscript {
        ...
        dependencies {
            classpath 'com.android.tools.build:gradle:9.2.1'
        }
    }

    Para obtener más información, consulta Android: Archivos de configuración de compilación.

Código Java/Kotlin

Para incluir código Java/Kotlin con el fin de utilizar algunas API que Qt no cubre o por cualquier otro motivo, coloque dicho código en la ruta <QT_ANDROID_PACKAGE_SOURCE_DIR>/src/. Por ejemplo, puede llamar a métodos Java desde el código Qt. Para ver un ejemplo, consulte el ejemplo de notificador de Qt para Android.

Recursos

Android permite añadir archivos de recursos, como iconos, imágenes, cadenas de texto, colores, etc. Se puede hacer referencia a esos recursos directamente desde el código Java/Kotlin o desde el archivo de manifiesto. Cualquier archivo de este tipo se puede añadir al proyecto en la ruta <QT_ANDROID_PACKAGE_SOURCE_DIR>/res/. Por ejemplo, los iconos de la aplicación se pueden añadir en la ruta res/drawable/icon.png.

Para obtener más información, consulta Android: Descripción general de los recursos de las aplicaciones.

Recursos internos de Qt

De forma predeterminada, Qt incluye algunos recursos necesarios para que las aplicaciones funcionen correctamente. Por ejemplo, en Unix, estos recursos se encuentran en ~/Qt/<version>/android_<abi>/src/android/templates/res.

strings.xml

Este archivo se encuentra en res/values/strings.xml. Contiene las cadenas que utiliza la biblioteca Qt para hacer referencia a las traducciones de los mensajes en distintos idiomas.

libs.xml

Este archivo se encuentra en res/values/libs.xml. Se utiliza exclusivamente para gestionar la información de implementación de las bibliotecas Qt, y no se recomienda modificarlo manualmente.

Recursos de Android

Para obtener más información sobre la gestión de recursos de Android, consulta «Añadir recursos».

Bibliotecas de Android

Para obtener más información sobre cómo utilizar bibliotecas de terceros en tu proyecto Qt, consulta «Incluir una biblioteca en un proyecto de Android».

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