CMP0168¶
在版本 3.30 中添加。
The FetchContent 模块直接实现步骤，而不是通过子构建。
CMake 3.29 及更低版本将 FetchContent 实现为单独的子构建。这需要配置该单独的项目并使用构建工具。对于某些生成器和操作系统，这种方法可能非常慢。CMake 3.30 及更高版本倾向于直接在主项目中实现下载、更新和补丁步骤。
NEW 行为具有以下特征
不使用子构建。所有操作都直接从主项目的 CMake 配置步骤中实现。在 CMake 脚本模式下运行时，无需构建工具可用。
不支持生成器表达式和
$(SOMEVAR)形式的 GNU Make 变量。它们不应在FetchContent_Declare()或FetchContent_Populate()的任何参数中使用。所有
LOG_...和USES_TERMINAL_...选项、QUIET选项以及FETCHCONTENT_QUIET变量都将被忽略。FetchContent输出始终是主项目配置输出的一部分。这也意味着它现在遵循消息日志记录级别（请参阅CMAKE_MESSAGE_LOG_LEVEL和--log-level）。默认消息日志级别应与使用OLD策略设置的QUIET类似，只不过现在会显示警告。PREFIX、TMP_DIR、STAMP_DIR、LOG_DIR和DOWNLOAD_DIR选项及其关联的目录属性都将被忽略。FetchContent模块在内部控制这些位置。cmake --fresh将删除用于跟踪和填充依赖项的 stamp 和脚本文件。这将强制重新执行依赖项的下载、更新和补丁步骤。用于下载的目录不受cmake --fresh的影响，因此URL下载方法的任何先前下载的文件仍然可以重用。
OLD 行为具有以下特征
始终使用子构建来实现下载、更新和补丁步骤。即使在 CMake 脚本模式下使用
FetchContent_Populate()时，也必须有可用的构建工具。可以使用生成器表达式和
$(SOMEVAR)形式的 GNU Make 变量，尽管这种使用几乎总是不合适的。它们在子构建中进行评估，因此它们看不到来自主构建的任何信息。支持与下载、更新或补丁步骤相关的所有日志记录、终端控制和目录选项。
如果使用
QUIET选项，或者将FETCHCONTENT_QUIET变量设置为 true，则警告不会显示在输出中。cmake --fresh对依赖项的 stamp 或脚本文件没有影响。只有在依赖项的详细信息发生更改时，先前执行的步骤才会重新运行。
用户很有可能可以将 CMAKE_POLICY_DEFAULT_CMP0168 变量设置为 NEW，以全局切换到 NEW 行为，同时等待项目及其依赖项更新以默认使用 NEW 策略设置。项目通常不使用 NEW 行为不再支持的功能，即使是那些使用的项目，当这些选项被忽略时，通常仍然可以正常工作。在全局设置此行为之前，请检查是否有任何 FetchContent_Declare() 或 FetchContent_Populate() 调用以会改变可观察行为的方式使用被忽略的选项，除了将临时文件或内部生成的文件放在不同的位置之外。
此策略在 CMake 版本 3.30 中引入。它可以通过 cmake_policy() 或 cmake_minimum_required() 设置。如果未设置，CMake 不会发出警告，并使用 OLD 行为。
注意
策略的 OLD 行为按定义 已弃用，并可能在未来的 CMake 版本中删除。