En esta página

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 el target y extrae automáticamente la información que necesita.
  • Manualmente, ejecutando moc con 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 a qt_extract_metatypes() con la opción MANUAL_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.