qt_add_resources
Compila recursos binarios en código fuente.
El comando está definido en el componente « Core » del paquete « Qt6 », que se puede cargar de la siguiente manera:
find_package(Qt6 REQUIRED COMPONENTS Core)Sinopsis
qt_add_resources(<TARGET> <RESOURCE_NAME>
[PREFIX <PATH>]
[LANG <LANGUAGE>]
[BASE <PATH>]
[BIG_RESOURCES]
[DISCARD_FILE_CONTENTS]
[OUTPUT_TARGETS <VARIABLE_NAME>]
[FILES ...] [OPTIONS ...])Variante basada en variables:
qt_add_resources(<VAR> file1.qrc [file2.qrc ...]
[OPTIONS ...])Si los comandos sin versión están desactivados, utilice en su lugar qt6_add_resources(). Admite el mismo conjunto de argumentos que este comando.
Descripción
Para añadir recursos, puedes pasar un destino o un nombre de variable como primer argumento del comando.
Al pasar un objetivo como primer argumento, la función crea un recurso con el nombre RESOURCE_NAME, que contiene el FILES especificado. El recurso se vincula automáticamente a TARGET.
Al pasar un nombre de variable como primer argumento, ` qt_add_resources ` crea código fuente a partir de los archivos de recursos de Qt utilizando el ` Resource Compiler ` (rcc). Las rutas a los archivos fuente generados se añaden a ` <VAR>`.
Consulte El sistema de recursos de Qt para obtener una descripción general de los recursos de Qt.
Los argumentos de la variante basada en destino
PREFIX especifica un prefijo de ruta bajo el cual se puede acceder a todos los archivos de este recurso desde el código C++. Esto se corresponde con el atributo XML « prefix » del formato de archivo « .qrc ». Si no se indica « PREFIX », se utiliza la propiedad de destino «QT_RESOURCE_PREFIX ». A partir de Qt 6.5, « PREFIX » es opcional. Si se omite y no se especifica mediante « QT_RESOURCE_PREFIX », se utilizará « "/" » como prefijo de ruta por defecto.
LANG Especifica la configuración regional de este recurso. Esto se corresponde con el atributo XML « lang » del formato de archivo « .qrc ».
BASE Es un prefijo de ruta que indica el punto raíz del alias del archivo. Por ejemplo, si BASE es "assets" y FILES es "assets/images/logo.png", entonces el alias de ese archivo es "images/logo.png".
La configuración de los alias de los archivos debe establecerse a través de la propiedad del archivo fuente QT_RESOURCE_ALIAS.
BIG_RESOURCES Se puede especificar para habilitar la compatibilidad con recursos de gran tamaño. Esto genera directamente archivos objeto (.o, .obj) en lugar de código fuente C++. Esto permite incrustar recursos más grandes sin tener que compilar el código fuente C++ generado, lo que puede requerir demasiado tiempo y consumir mucha memoria.
Ten en cuenta que « BIG_RESOURCES » no es compatible con iOS debido a las restricciones del generador de proyectos Xcode de CMake. Consulta QTBUG-103497 para obtener más detalles. Además, « BIG_RESOURCES » solo funciona de forma fiable a partir de CMake 3.17.
Al utilizar este comando con bibliotecas estáticas, se generarán uno o más objetivos especiales. Si deseas realizar un procesamiento adicional sobre estos objetivos, pasa un nombre de variable al parámetro OUTPUT_TARGETS. La función qt_add_resources almacena los nombres de los objetivos especiales en la variable especificada.
Si se especifica ` DISCARD_FILE_CONTENTS `, los archivos de recursos se añadirán al sistema de recursos sin incrustar su contenido real. En su lugar, estos archivos se almacenarán como marcadores de posición vacíos dentro del recurso generado.
Argumentos de la variante basada en variables
Al utilizar la variante basada en variables, se pasan uno o más archivos « .qrc » como argumentos. La función genera código fuente a partir de estos archivos de recursos de Qt y añade las rutas a los archivos fuente generados a la variable especificada.
Argumentos de ambas variantes
Se pueden establecer archivos « OPTIONS » adicionales que se deben añadir a las llamadas a ` rcc `. Las opciones disponibles se pueden consultar en la documentación de rcc.
Ejemplos
Variante «Target», utilizando recursos inmediatos:
qt_add_executable(myapp main.cpp)
qt_add_resources(myapp "images"
PREFIX "/images"
FILES image1.png image2.png)Variante de variable, utilizando un archivo .qrc:
set(sources main.cpp)
qt_add_resources(sources example.qrc)
qt_add_executable(myapp ${sources})Advertencias
Al añadir varios recursos, el nombre de la variante de destino ( RESOURCE_NAME ) debe ser único para todos los recursos enlazados en el destino final.
Esto afecta especialmente a las compilaciones estáticas. En ese caso, el mismo nombre de recurso en diferentes bibliotecas estáticas entra en conflicto en el objetivo que lo consume.
A diferencia de RESOURCESde qmake, qt_add_resources no intenta compilar ningún archivo QML o JavaScript utilizando qmlcachegen. Para ello, utiliza qt_add_qml_module().
Véase también qt_add_big_resources().
© 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.