QT5-BUILD.ECLASS

节：eclass-manpages (5)
更新：2024 年 11 月
索引返回主内容

名称

qt5-build.eclass - 用于 Qt5 分割 ebuilds 的 Eclass。

描述

此 Eclass 包含构建 Qt5 时使用的各种函数。

支持的 EAPIS

函数

qt5-build_src_prepare: 准备环境并在必要时修补源代码。
qt5-build_src_configure: 在目标目录中运行 qmake。对于 qtbase 中的包，./configure 也在 qmake 之前运行。
qt5-build_src_compile: 在目标目录中运行 emake。
qt5-build_src_test: 在目标目录中运行测试。
qt5-build_src_install: 在目标目录中运行 emake install。
qt5-build_pkg_postinst: 安装或升级/降级后重新生成配置。
qt5-build_pkg_postrm: 当模块完全删除时重新生成配置。
qt5_configure_oos_quirk <file> 或 <file> <path>: 针对源外构建的奇特现象。在根目录中运行 qmake，将生成的 pri <file> 从源 <path> 复制到构建目录 <path>。如果没有指定 <path>，<file> 将被复制到 ${QT5_BUILD_DIR}。
qt5_syncqt_version: Qt5 syncqt.pl 的包装器，用于同步 ${PV} 的头文件（如果通过修补添加/删除头文件，则需要运行）。
qt5_symlink_binary_to_path <target binary name> [suffix]: 将给定的二进制文件从 QT5_BINDIR 链接到 QT5_PREFIX/bin，并可选地添加后缀。
qt_use <flag> [feature] [enableval]: <flag> 是 IUSE 中标志的名称。
如果启用了 <flag>，则输出 "-${enableval}-${feature}"，否则输出 "-no-${feature}"。如果未指定 [feature]，则使用 <flag> 来代替。如果未指定 [enableval]，则省略 "-${enableval}" 前缀。
qt_use_compile_test <flag> [config]: <flag> 是 IUSE 中标志的名称。[config] 是 qtCompileTest 的参数，默认为 <flag>。
此函数用于禁用在 qmake 时间使用 qtCompileTest() 函数检查的可选依赖项。如果禁用了 <flag>，则跳过编译测试，并假设依赖项不可用，即相应的特性将被禁用。请注意，此函数的所有调用必须在调用 qt5-build_src_configure 之前发生。
qt_use_disable_config <flag> <config> <files...>: <flag> 是 IUSE 中标志的名称。<config> 是 Qt5 配置项的（小写）名称。<files...> 是一个或多个 qmake 项目文件的列表。
此函数修补 <files> 以在禁用 <flag> 时将 <config> 视为禁用，否则不执行任何操作。这对于在系统上启用了配置项但禁用了相应的 USE 标志时避免自动依赖关系很有用。
qt_use_disable_mod <flag> <module> <files...>: <flag> 是 IUSE 中标志的名称。<module> 是 Qt5 模块的（小写）名称。<files...> 是一个或多个 qmake 项目文件的列表。
此函数修补 <files> 以在禁用 <flag> 时将 <module> 视为未安装，否则不执行任何操作。这对于在系统上存在模块但禁用了相应的 USE 标志时避免自动依赖关系很有用。

ECLASS 变量

QT5_BUILD_TYPE = release

默认值为 "release"。如果 PV 匹配 "*9999*"，则自动将其设置为 "live"。

QT5_KDEPATCHSET_REV（在 INHERIT 之前设置）

从 KDE 的 Qt5PatchCollection 中提取的下游生成的修补程序集修订版，修补程序集是通过以下方式从上游的 qt 模块 git 存储库中生成的

git format-patch v${PV}-lts-lgpl..origin/gentoo-kde/${PV} \
        -o ${QT5_MODULE}-${PV}-gentoo-kde-${QT5_KDEPATCHSET_REV}

用于 SRC_URI 并在 src_prepare 中应用。必须在继承 Eclass 之前设置。

QT5_MODULE ?= ${PN}（在 INHERIT 之前设置）

此包所属的模块的上游名称。用于 SRC_URI 和 EGIT_REPO_URI。必须在继承 Eclass 之前设置。

QT5_PV = $(ver_cut 1-3)

用于其他 dev-qt/ 包中的依赖项声明的 3 部分版本。

QT5_TARGET_SUBDIRS

包含应构建的源目录的数组变量。所有路径都必须相对于 ${S}。

QT5_GENTOO_CONFIG

<useflag:feature:macro> 三元组数组，在 src_install 中进行评估以生成每个包的已启用 QT_CONFIG 特性列表和宏定义，然后将其与系统上安装的所有其他 Qt5 包合并在一起以获得全局 qconfig.{h,pri} 文件。

QT5_GENTOO_PRIVATE_CONFIG

<useflag:feature> 对数组，在 src_install 中进行评估以生成每个包的已启用 QT.global_private 特性列表，然后将其与系统上安装的所有其他 Qt5 包合并在一起以获得全局 qmodule.pri 文件。

VIRTUALX_REQUIRED ?= manual（在 INHERIT 之前设置）

有关正确描述，请参阅 virtualx.eclass 手册页。这里我们将默认值重新定义为 manual，如果您的包需要虚拟 x 用于测试，则应继续设置 VIRTUALX_REQUIRED=test。

QT5_BUILD_DIR ?= ${S}_build（由 ECLASS 生成）

源外构建的构建目录。

作者

Davide Pesavento <[email protected]>

维护者

[email protected]

报告错误

请通过 https://bugs.gentoo.org/ 报告错误。

文件

qt5-build.eclass

另请参阅

ebuild(5)
https://gitweb.gentoo.org/repo/gentoo.git/log/eclass/qt5-build.eclass

此文档由 man2html 使用手册页创建。
时间：2024 年 11 月 12 日，格林威治标准时间 03:27:01