qt_ifcodegen_generate

从qface IDL文件生成文件。

该命令定义在Qt6包的InterfaceFramework组件中。

使用以下命令加载包：

find_package(Qt6 REQUIRED COMPONENTS InterfaceFramework)

摘要

qt_ifcodegen_generate(
    IDL_FILES idl_files
    TEMPLATE template
    [ANNOTATION_FILES ...]
    [IMPORT_PATH ...]
    [OUTPUT_DIR output_dir]
    [EXTRA_HEADERS_OUTPUT_DIR extra_headers_output_dir]
    [EXTRA_TEMPLATE_SEARCH_PATH ...]
    [VERBOSE]
)

如果禁用了无版本命令，则使用qt6_ifcodegen_generate()代替。它支持与此命令相同的参数集。

描述

通过调用ifcodegen从qface接口定义语言（IDL）文件生成文件。它通常会由qt_ifcodegen_extend_target或qt_ifcodegen_import_variables内部调用。除非你有特殊的情况需要直接调用此函数生成文件，但不能以任何方式在CMake中使用它们，否则不应直接调用此函数。

使用IDL_FILES指定输入IDL文件，而TEMPLATE指定用于生成的ifcodegen模板。给定的模板可以是模板文件夹的路径，也可以是模板搜索路径中找到的模板名称。使用EXTRA_TEMPLATE_SEARCH_PATH参数，可以扩展搜索路径。如果您想使用自己的模板进行代码生成，这特别有用。作为函数参数的替代方法，可以使用全局CMake变量QT_IFCODEGEN_TEMPLATE_SEARCH_PATH为所有ifcodegen函数调用指定额外的搜索路径。

通过ANNOTATION_FILES参数传递额外的注释文件。

可以使用IMPORT_PATH将搜索路径添加到依赖此文件的IDL文件的搜索路径中。其他IDL文件仍需要单独生成和构建。

OUTPUT_DIR指定生成文件的目录，默认为CMAKE_CURRENT_BINARY_DIR。

使用EXTRA_HEADER_OUTPUT_DIR提供额外的目录，所有生成的头文件都复制到该目录。

默认情况下，将丢弃所有由ifcodegen生成的日志消息。要显示它们，您可以使用VERBOSE参数，设置IFCODEGEN_VERBOSE变量或设置CMAKE_MESSAGE_LOG_LEVEL为VERBOSE。

有关生成器命令行参数的更多详细信息，请参阅使用生成器。