qt_policy

修改 Qt CMake API 的默认行为。

该命令定义在Qt6 包的Core 组件中，可按如下方式加载：

find_package(Qt6 REQUIRED COMPONENTS Core)

该命令于 Qt 6.5 中引入。

语法

qt_policy(
    [SET <policy_name> behavior]
    [GET <policy_name> <variable>]
)

如果禁用了无版本命令，请改用qt6_policy() 。它支持与本命令相同的参数集。

描述

该命令有两种模式：

• 当使用SET 关键字时，此命令可用于选择采用Qt的CMake API中的行为变更，或明确选择不采用这些变更。
• 当使用GET 关键字时，<variable> 将被设置为该策略的当前行为，即OLD 或NEW 。

<policy_name> 必须是Qt CMake 策略之一的名字。策略名称的格式为QTP<NNNN> ，其中 <NNNN> 是指定策略索引的整数。使用无效的策略名称会导致错误。

支持旧版 Qt 的代码在获取<policy_name> 的值或设置其行为之前，可通过检查QT_KNOWN_POLICY_<policy_name> 变量的值来确认该策略是否存在。

if(QT_KNOWN_POLICY_<policy_name>)
    qt_policy(SET <policy_name> NEW)
endif()

您可以将behavior 设置为以下选项之一：

• NEW 以启用新行为
• OLD 以明确选择不采用新行为

可用策略