En esta página

Portar a Android

La mayoría de las aplicaciones Qt deberían poder portarse a Android con facilidad, a menos que dependan de una característica específica de hardware o software que no sea compatible con Android.

El enfoque de la adaptación varía en función de si la aplicación existente está basada en QML o en Widgets, de la herramienta de compilación que se vaya a utilizar y de si se está adaptando una aplicación móvil o de escritorio.

Las aplicaciones basadas en QML compiladas con CMake se consideran el mejor enfoque para las aplicaciones móviles.

Portabilidad desde aplicaciones de escritorio de Qt

La mayor parte de tu código Qt existente debería funcionar, pero debes tomar algunas decisiones sobre la escalabilidad de la interfaz de usuario y el diseño para diferentes orientaciones y tamaños de pantalla. Considera la posibilidad de utilizar diseños adaptativos para aprovechar al máximo las aplicaciones de Qt Qml.

Hay aspectos que no se ven directamente afectados por el uso de Qt, como las directrices de las tiendas de aplicaciones, las directrices sobre temas y otros que pueden influir en la forma de desarrollar la aplicación. Estos no se tratarán aquí.

Añadir recursos

La mayoría de las aplicaciones necesitan recursos. A continuación, explicamos cómo afecta esto a la adaptación de tu aplicación a Android.

Uso del sistema de recursos de Qt

Al igual que la mayoría de las aplicaciones con interfaz de usuario, las aplicaciones Qt también dependen de recursos como imágenes, iconos, archivos de traducción, etc. Estos recursos deben estar disponibles en el dispositivo, ya que son necesarios para que la aplicación funcione correctamente.

La opción más conveniente es agrupar los recursos en un archivo qrc, que se integra en el binario de la aplicación. Este enfoque reduce considerablemente el esfuerzo de portabilidad y proporciona un acceso más rápido a los recursos. Además, se trata de un enfoque multiplataforma, lo que facilita la portabilidad a otras plataformas.

Por defecto, todas las aplicaciones Qt pueden acceder al contenido de un archivo qrc utilizando el prefijo «:/» o el prefijo del esquema de URL «qrc:». Para obtener más información sobre los archivos qrc y cómo se gestionan, consulta el Sistema de recursos de Qt.

Añadir recursos mediante el enfoque de activos

Qt para Android proporciona un sistema de archivos virtual especial basado en el mecanismo de activos (assets) de Android. Los archivos que se colocan en el directorio«ANDROID_PACKAGE_SOURCE_DIR/assets/» se empaquetan como parte del paquete de la aplicación.

El enfoque de activos es la mejor opción para lograr una mayor interoperabilidad con las API de Android. Puede acceder a todos los recursos del directorio utilizando el prefijo «assets:». A diferencia de qrc, este enfoque es específico de Android y no constituye una solución multiplataforma.

Nota: El uso del sistema de recursos de Qt implica que los archivos « qrc » se incluyan en las bibliotecas compartidas, las cuales deben descomprimirse primero y cargarse mediante el enlazador, mientras que los activos de Android están comprimidos en el APK y pueden utilizarse directamente en la aplicación. Esto significa que el uso de los activos de Android puede ocupar menos espacio, pero no es una solución multiplataforma con Qt.

El enfoque de los recursos con CMake

Si eres nuevo en el uso de CMake o es la primera vez que utilizas CMake con Qt, consulta «Compilar con CMake». Aquí nos centraremos en los pasos necesarios para añadir recursos.

Probablemente querrás modificar algunos aspectos controlados por el archivo Android Manifest. Consulta «Configuración del archivo Android Manifest en Qt» para obtener más información al respecto. Así pues, es probable que ya hayas definido QT_ANDROID_PACKAGE_SOURCE_DIR de la siguiente manera:

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

Ahora, puedes colocar tus recursos directamente en esa carpeta o crear un paso personalizado con CMake para copiarlos desde la ruta principal del proyecto a la ruta de los recursos.

A continuación, puedes acceder a ese recurso de imagen desde C++ de la siguiente manera:

QImage image("assets:/images/happy.png");

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