Qt6 模块

Meson 0.57.0 中的新增内容

Qt6 模块提供了一些方法，可以自动处理 Qt 所需的各种工具和步骤。

警告：在 0.63.0 版本之前，Meson 无法找到 Qt 6.1 或更高版本，因为 Qt 工具已移至 libexec 子目录，并且工具名称仅以 Qt 主版本号为后缀，例如 qmake6。

compile_resources

新增于 0.59.0

将 Qt 的资源集合文件 (.qrc) 编译成 c++ 文件以供编译。

它不接受位置参数，并接受以下关键字参数

name (字符串 | 空)：如果提供一个 .cpp 文件，则会生成一个 .cpp 文件，并将所有 qrc 文件的输出合并到此文件中，否则每个 qrc 文件都将写入其自己的 cpp 文件。
sources (文件 | 字符串 | 自定义目标 | 自定义目标索引 | 生成器输出)[]：要转换的源列表。必需，至少需要一个源
新增于 0.60.0：支持自定义目标、自定义目标索引和生成器输出。
extra_args 字符串[]：要直接传递给 qt-rcc 的额外参数
method 字符串：用于检测 Qt 的方法，请参见 dependency()

compile_ui

新增于 0.59.0

将 Qt 的 ui 文件 (.ui) 编译成头文件。

它不接受位置参数，并接受以下关键字参数

sources (文件 | 字符串 | 自定义目标 | 自定义目标索引 | 生成器输出)[]：要转换的源列表。必需，至少需要一个源
新增于 0.60.0：支持自定义目标、自定义目标索引和生成器输出。
extra_args 字符串[]：要直接传递给 qt-uic 的额外参数
method 字符串：用于检测 Qt 的方法，请参见 dependency()
preserve_paths 布尔值：新增于 1.4.0。如果为 true，则指定输出文件需要在目标临时目录中保留其目录结构。例如，当处理名为 subdir/one.input 的文件时，如果为 true，则会生成文件 {target private directory}/subdir/one.out，如果为 false（默认值），则会生成文件 {target private directory}/one.out。

compile_moc

新增于 0.59.0

将 Qt 的 moc 文件 (.moc) 编译成头文件和/或源文件。必须至少提供一个 headers 或 sources 关键字参数。

它不接受位置参数，并接受以下关键字参数

sources (文件 | 字符串 | 自定义目标 | 自定义目标索引 | 生成器输出)[]：要转换为 .moc 文件以供手动包含的源列表。
新增于 0.60.0：支持自定义目标、自定义目标索引和生成器输出。
headers (文件 | 字符串 | 自定义目标 | 自定义目标索引 | 生成器输出)[]：要转换为 .cpp 文件的头文件列表
新增于 0.60.0：支持自定义目标、自定义目标索引和生成器输出。
extra_args 字符串[]：要直接传递给 qt-moc 的额外参数
method 字符串：用于检测 Qt 的方法，请参见 dependency()
dependencies：依赖项对象，其包含目录由 moc 使用。
include_directories (字符串 | IncludeDirectory)[]：在转换 .moc 文件时使用的 include_directory() 对象列表
preserve_paths 布尔值：新增于 1.4.0。如果为 true，则指定输出文件需要在目标临时目录中保留其目录结构。例如，当处理名为 subdir/one.input 的文件时，如果为 true，则会生成文件 {target private directory}/subdir/one.out，如果为 false（默认值），则会生成文件 {target private directory}/one.out。

preprocess

建议改用 compile_resources、compile_ui 和 compile_moc。

获取 moc、uic 和 rcc 的源代码，并将其转换为 c++ 文件以供编译。

具有以下签名：qt.preprocess(name: str | None, *sources: str)

如果传递了 name 参数，则所有 rcc 文件都将写入一个输出文件

已弃用，自 0.59.0 起：在可变参数 sources 参数和 sources 关键字参数中给出的文件将直接通过预处理器程序传递。不要这样做 - 只需将 preprocess() 的输出添加到另一个源列表中

sources = files('a.cpp', 'main.cpp', 'bar.c')
sources += qt.preprocess(qresources : ['resources'])

此方法接受以下关键字参数

qresources (字符串 | 文件)[]：传递给 RCC 编译器
ui_files： (字符串 | 文件 | 自定义目标)[]：传递给 uic 编译器
moc_sources： (字符串 | 文件 | 自定义目标)[]：传递给 moc 编译器。这些将被转换为 .moc 文件，旨在被 #include
moc_headers： (字符串 | 文件 | 自定义目标)[]：传递给 moc 编译器。这些将被转换为 .cpp 文件
include_directories (IncludeDirectories | 字符串)[], 要添加到 moc 的头文件搜索路径中的目录
moc_extra_arguments 字符串[]：moc 的任何其他参数。
uic_extra_arguments 字符串[]：uic 的任何其他参数。
rcc_extra_arguments 字符串[]：rcc 的任何其他参数。
dependencies Dependency[]：moc 所需的依赖项对象。
已弃用，自 0.59.0 起。: sources：额外的源列表，它们将不变地添加到输出中。
preserve_paths 布尔值：自 1.4.0 起。如果为 true，则指定输出文件需要在目标临时目录中保留其目录结构。例如，当处理名为 subdir/one.input 的文件时，如果为 true，则会生成文件 {target private directory}/subdir/one.out，如果为 false（默认值），则会生成文件 {target private directory}/one.out。

它返回一个要传递给编译目标的目标和源数组。

compile_translations

此方法生成使用 lrelease 构建翻译文件所需的必要目标，它不接受位置参数，并接受以下关键字参数

ts_files (文件 | 字符串 | 自定义目标 | 自定义目标索引 | 生成器输出)[]：由 Qt 的 lupdate 工具生成的输入翻译文件列表。
新增于 0.60.0：支持自定义目标、自定义目标索引和生成器输出。
install 布尔值：如果为 true，则此目标将在安装步骤期间安装（可选）。
install_dir 字符串：要安装到的目录（可选）。
build_by_default 布尔值：如果设置为 true，则使此目标默认构建，即在调用 meson compile 时；默认值为 false（可选）。
qresource 字符串：要从中提取 ts_files 的 rcc 源文件；不能与 ts_files 关键字参数一起使用。
rcc_extra_arguments 字符串[]：rcc 的任何其他参数（可选），在与 `qresource` 一起使用时。

返回值为：编译翻译的自定义目标列表，或者，如果使用 qresource 文件，则为一个包含已处理源文件的单个自定义目标，该目标应传递给主构建目标。

has_tools

此方法如果找到此模块使用的所有工具，则返回 true，否则返回 false。

它应该用于编译可选的 Qt 代码

qt6 = import('qt6')
if qt6.has_tools(required: get_option('qt_feature'))
  moc_files = qt6.preprocess(...)
  ...
endif

此方法接受以下关键字参数

required 布尔值 | 功能选项：默认情况下，required 设置为 false。如果 required 设置为 true 或启用的 feature，并且缺少某些工具，Meson 将中止。
method 字符串：用于检测 Qt 的方法，请参见 dependency()
tools：字符串[]：自 1.6.0 起。要检查的工具列表。可测试的工具包括 moc、uic、rcc 和 lrelease。默认情况下，tools 设置为 ['moc', 'uic', 'rcc', 'lrelease']

依赖项

请参见 Qt 依赖项

'modules' 参数用于在项目中包含 Qt 模块。有关模块列表，请参见 Qt 文档中的模块列表。

'private_headers' 参数允许使用 Qt 模块的私有头文件。

示例

一个简单的示例如下所示

qt6 = import('qt6')
qt6_dep = dependency('qt6', modules: ['Core', 'Gui'])
inc = include_directories('includes')
moc_files = qt6.compile_moc(headers : 'myclass.h',
                            extra_arguments: ['-DMAKES_MY_MOC_HEADER_COMPILE'],
                            include_directories: inc,
                            dependencies: qt6_dep)
translations = qt6.compile_translations(ts_files : 'myTranslation_fr.ts', build_by_default : true)
executable('myprog', 'main.cpp', 'myclass.cpp', moc_files,
           include_directories: inc,
           dependencies : qt6_dep)

有时，翻译会使用 qresource 文件嵌入到二进制文件中。在这种情况下，不需要显式列出 ts 文件，而是会从 qresource 文件中列出的已构建 qm 文件推断出来。例如

qt6 = import('qt6')
qt6_dep = dependency('qt6', modules: ['Core', 'Gui'])
lang_cpp = qt6.compile_translations(qresource: 'lang.qrc')
executable('myprog', 'main.cpp', lang_cpp,
           dependencies: qt6_dep)

搜索结果为

在 GitHub 上编辑