En esta página

Implementación de aplicaciones QML

Esta página ofrece información sobre cómo implementar aplicaciones QML. Aborda el uso de Qt Creator para la implementación, así como el uso del sistema de recursos de Qt para empaquetar archivos QML y otros recursos junto con el ejecutable de la aplicación.

La implementación de aplicaciones con Qt Creator

Qt Creator implementa y empaqueta aplicaciones QML para diversas plataformas. En el caso de los dispositivos móviles, « Qt Creator » puede empaquetar directamente las aplicaciones en los formatos propios de cada plataforma, como APK.

Al ejecutar las aplicaciones en la plataforma de destino, estas necesitan acceder a la ubicación de las bibliotecas QML. Si se utiliza qmake, la variable de entorno « QT_INSTALL_QML » apunta a la ubicación de las bibliotecas. Los instaladores de Qt instalan las bibliotecas QML en: <version>/ <COMPILADOR>/qml directory.

Uso del sistema de recursos de Qt con QML

El sistema de recursos de Qt permite almacenar archivos de recursos como archivos binarios en el ejecutable de una aplicación. El sistema de recursos de Qt se utiliza para aplicaciones Qml, ya que permite hacer referencia a archivos Qml y otros recursos —como imágenes y archivos de sonido— a través del esquema URI del sistema de recursos, en lugar de mediante rutas relativas o absolutas a los recursos del sistema de archivos.

Nota: El uso del sistema de recursos implica que, por lo general, el ejecutable de la aplicación debe recompilarse cada vez que se modifique un archivo fuente QML, para actualizar los recursos del paquete.

La API del módulo QML de CMake coloca automáticamente tus archivos QML en el sistema de recursos. Para acceder a ellos, carga tu archivo QML principal como un recurso o como una URL con el esquema qrc. La ruta en el sistema de recursos donde se ubican tus archivos QML se puede encontrar concatenando:

Por ejemplo, un módulo llamado My.Own.Module se coloca en:

  • :/qt/qml/My/Own/Module/ si has especificado /qt/qml como RESOURCE_PREFIX, o si no has pasado RESOURCE_PREFIX y la política QTP0001 está configurada como NEW.
  • :/My/Own/Module/ si ha especificado / como RESOURCE_PREFIX, o si no ha superado RESOURCE_PREFIX y la política QTP0001 no está configurada en NEW.
  • :/Some/Prefix/My/Own/Module/ si ha especificado Some/Prefix/ como RESOURCE_PREFIX
  • :/ si has especificado NO_RESOURCE_TARGET_PATH

Una vez hecho esto, todos los archivos especificados mediante rutas relativas en QML se cargan desde el sistema de recursos. El uso del sistema de recursos es totalmente transparente para la capa QML; esto significa que todo el código QML debe hacer referencia a los archivos de recursos mediante rutas relativas y no debe utilizar el esquema qrc. Este esquema solo debe utilizarse desde el código C++ para hacer referencia a los archivos de recursos.

Nota: Al utilizar qmake, debes colocar manualmente tus archivos en el sistema de recursos. Consulta el Manual de qmake y la documentación general sobre el sistema de recursos para saber cómo hacerlo. Es recomendable seguir la convención de nomenclatura de rutas descrita anteriormente.

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