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:
- la URL
RESOURCE_PREFIXque hayas pasado a qt_add_qml_module. /qt/qml, si no has pasadoRESOURCE_PREFIXa ` qt_add_qml_module ` y la política QTP0001 está configurada comoNEW./, si no has pasadoRESOURCE_PREFIXa qt_add_qml_module y la política QTP0001 estánotconfigurada comoNEW.- Si no has pasado
NO_RESOURCE_TARGET_PATHa qt_add_qml_module: elURIque has pasado a qt_add_qml_module con los puntos sustituidos por barras.
Por ejemplo, un módulo llamado My.Own.Module se coloca en:
:/qt/qml/My/Own/Module/si has especificado/qt/qmlcomoRESOURCE_PREFIX, o si no has pasadoRESOURCE_PREFIXy la política QTP0001 está configurada comoNEW.:/My/Own/Module/si ha especificado/comoRESOURCE_PREFIX, o si no ha superadoRESOURCE_PREFIXy la política QTP0001 no está configurada enNEW.:/Some/Prefix/My/Own/Module/si ha especificadoSome/Prefix/comoRESOURCE_PREFIX:/si has especificadoNO_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.
Información relacionada
© 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.