qt_extract_metatypes
Extrae metatipos de un objetivo Qt y genera un archivo metatypes.json asociado.
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)Este comando se introdujo en Qt 6.0.
Sinopsis
qt_extract_metatypes(target
[MANUAL_MOC_JSON_FILES json_files...]
[OUTPUT_FILES variable_name]
)Si los comandos sin versión están desactivados, utiliza en su lugar qt6_extract_metatypes(). Admite el mismo conjunto de argumentos que este comando.
Descripción
Ciertas operaciones dependen de que se genere y recopile información de metatipo sobre los objetivos. Normalmente, los comandos de Qt XML se encargan de ello internamente, pero en los casos en que no sea así, se puede llamar a ` qt_extract_metatypes() ` para forzar la recopilación de esta información para un ` target` específico.
La información de metatipo se genera para los archivos fuente de un objetivo de una de las siguientes formas:
- De forma automática mediante AUTOMOC. El comando
qt_extract_metatypes()detecta cuándo está habilitado AUTOMOC en eltargety extrae automáticamente la información que necesita. - Manualmente, ejecutando
moccon la opción--output-json. El proyecto se encarga de realizar un seguimiento de todos los archivos JSON generados mediante este método y de pasarlos aqt_extract_metatypes()con la opciónMANUAL_MOC_JSON_FILES.
qt_extract_metatypes() Genera un archivo JSON de metatipos específico para el destino que recopila todos los detalles de los metatipos a partir de las entradas de AUTOMOC y de las entradas manuales de moc. Para ello, llama a moc con la opción --collect-json. Si necesitas saber dónde se encuentra el archivo JSON de metatipos resultante (por ejemplo, para pasárselo a otro comando o para instalarlo), utiliza la opción OUTPUT_FILES para indicar el nombre de una variable en la que almacenar su ruta absoluta.
Extracción automática de metatipos
Desde Qt 6.8, si no has desactivado « AUTOMOC » y estás utilizando CMake 3.19 o una versión posterior, o bien estás llamando a `qt_finalize_target()` manualmente, entonces se invoca automáticamente ` qt_extract_metatypes() ` como parte del paso de finalización de `qt_add_library()`. Esto no tiene ningún efecto si has llamado manualmente a qt_extract_metatypes() antes de la finalización, posiblemente con argumentos personalizados. Sin embargo, garantiza que los metatipos también se generen si no lo has hecho. Esto es importante si alguno de los tipos de la biblioteca se utiliza como parte de cualquier tipo QML en el futuro y no presenta inconvenientes.
Además, ` qt_add_qml_module()` invoca automáticamente ` qt_extract_metatypes() ` para su objetivo.
© 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.