En esta página

qt_wrap_cpp

Crea archivos .moc a partir de los archivos 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)

Este comando se introdujo en Qt 5.0.

Sinopsis

qt_wrap_cpp admite dos sintaxis. La primera se añadió en Qt 6.8 y tiene el siguiente formato:

qt_wrap_cpp(<TARGET> src_file1 [src_file2 ...]
            [OPTIONS ...]
            [DEPENDS ...])

Nota: Se recomienda utilizarla firma anterior en lugar de la antigua.

qt_wrap_cpp(<VAR> src_file1 [src_file2 ...]
            [TARGET target]
            [OPTIONS ...]
            [DEPENDS ...])

Si los comandos sin versión están desactivados, utiliza en su lugar qt6_wrap_cpp(). Admite el mismo conjunto de argumentos que este comando.

Descripción

Crea reglas para llamar a Meta-Object Compiler (moc) sobre los archivos fuente indicados. Por cada archivo de entrada, se genera un archivo de salida en el directorio de compilación.

Con la sintaxis basada en el destino, los archivos generados se añaden como fuentes a <TARGET>. Con la sintaxis anterior, las rutas de los archivos generados se añaden a <VAR>.

Nota: Se trata de una macro de bajo nivel. Consulta la documentación de CMake sobre AUTOMOC para conocer una forma más cómoda de procesar los archivos fuente con moc.

Argumentos

Se puede establecer un ` TARGET` explícito. Esto garantizará que las propiedades del destino ` INCLUDE_DIRECTORIES ` y ` COMPILE_DEFINITIONS ` también se utilicen al escanear los archivos fuente con ` moc`.

Desde Qt 6.8, cuando se pasa un archivo fuente a ` qt_wrap_cpp ` en lugar de un archivo de cabecera para generar un archivo ` .moc ` para un destino, se necesita el parámetro ` TARGET ` para establecer la ruta de inclusión correcta para el archivo ` .moc ` generado en el archivo fuente.

Si se llama a ` qt_wrap_cpp ` en un ámbito de directorio diferente al del objetivo, se debe utilizar la firma basada en el objetivo de ` qt_wrap_cpp ` o pasar el objetivo con el argumento ` TARGET `.

Puedes configurar opciones adicionales de ` OPTIONS ` que se deben añadir a las llamadas a ` moc `. Encontrarás las opciones disponibles en la documentación de moc.

Las « OPTIONS » pueden evaluar expresiones generadoras cuando se establece « TARGET ».

Nota: Si los « OPTIONS » incluyen tanto expresiones generadoras como caracteres especiales, utiliza variables para implementarlos. Por ejemplo, utiliza $<ANGLE-R>, $<COMMA> y $<SEMICOLON> en lugar de >, , y :. De lo contrario, la expresión generadora no se evaluará correctamente. Los « OPTIONS » están envueltos en expresiones generadoras, por lo que debes escapar los caracteres especiales que contengan.

DEPENDS permite añadir dependencias adicionales para la recreación de los archivos generados. Esto resulta útil cuando los archivos fuente tienen dependencias implícitas, como el código de un complemento de Qt que incluye un archivo .json mediante la macro Q_PLUGIN_METADATA().

Ejemplos

Desde Qt 6.8:

qt_add_executable(myapp myapp.cpp main.cpp)
qt_wrap_cpp(myapp myapp.cpp)


// myapp.cpp
#include "myapp.h"
#include <QObject>

class MyApp : public QObject {
    Q_OBJECT
public:
    MyApp() = default;
};

#include "myapp.moc"

En el archivo anterior, myapp.moc se incluye en myapp.cpp. Para generar el archivo myapp.moc, se utiliza la macro qt_wrap_cpp con el parámetro TARGET. El archivo .moc y su ruta se añadirán a los directorios de fuentes e «include» del objetivo mediante la macro qt_wrap_cpp.

La versión anterior:

set(SOURCES myapp.cpp main.cpp)
qt_wrap_cpp(SOURCES myapp.h)
qt_add_executable(myapp ${SOURCES})

En el siguiente ejemplo, se evaluarán las expresiones del generador pasadas a ` OPTIONS `, ya que se ha establecido ` TARGET `. El argumento se especifica de esta forma para evitar errores de sintaxis en las expresiones del generador.

set(SOURCES myapp.cpp main.cpp)
qt_wrap_cpp(SOURCES myapp.h
            TARGET myapp
            OPTIONS
            "$<$<CONFIG:Debug>:-DMY_OPTION_FOR_DEBUG>"
            "-DDEFINE_CMDLINE_SIGNAL=void cmdlineSignal(const QMap<int, int> &i)"
            "$<$<CONFIG:Debug>:-DDEFINE_CMDLINE_SIGNAL_IN_GENEX=void cmdlineSignal(const QMap<int$<COMMA> int$<ANGLE-R> &i)>")
qt_add_executable(myapp ${SOURCES})

El siguiente ejemplo utiliza ` target_compile_definitions ` para establecer ` COMPILE_DEFINITIONS `, que se añadirán a ` OPTIONS`.

set(SOURCES myapp.cpp main.cpp)
qt_wrap_cpp(SOURCES myapp.h
            TARGET myapp)
qt_add_executable(myapp ${SOURCES})
target_compile_definitions(myapp PRIVATE "$<$<CONFIG:Debug>:MY_OPTION_FOR_DEBUG>"
                                         "DEFINE_CMDLINE_SIGNAL=void cmdlineSignal(const QMap<int, int> &i)"
                                         "$<$<BOOL:TRUE>:DEFINE_CMDLINE_SIGNAL_IN_GENEX=void cmdlineSignal(const QMap<int$<COMMA> int$<ANGLE-R> &i)>")

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