CMP0123

在版本 3.21 中添加。

ARMClang cpu/arch 编译和链接标志必须显式设置。

CMake 3.20 及更低版本会自动映射 CMAKE_SYSTEM_PROCESSOR 变量和一个未记录的 CMAKE_SYSTEM_ARCH 到 ARMClang 的编译和链接选项。例如，当 CMAKE_SYSTEM_PROCESSOR 等于 cortex-m33 时，会添加 -mcpu=cortex-m33 标志。CMake 要求项目设置任一变量，否则会引发致命错误。但是，项目可能需要额外指定 CPU 功能，例如使用 -mcpu=cortex-m33+nodsp，这与 CMake 添加的 -mcpu=cortex-m33 冲突。这会导致链接错误或无法使用的二进制文件。

CMake 3.21 及更高版本更倾向于不自动添加任何 cpu/arch 编译和链接标志。相反，项目必须显式指定它们。此策略为尚未更新的项目提供兼容性。

此策略的 OLD 行为要求使用 ARMClang 的项目设置 CMAKE_SYSTEM_PROCESSOR 或 CMAKE_SYSTEM_ARCH，它会根据这些变量自动添加编译选项 -mcpu= 或 -march= 以及链接选项 --cpu=。 NEW 行为不添加编译或链接选项，项目负责设置正确的选项。

此策略是在 CMake 版本 3.21 中引入的。它可以通过 cmake_policy() 或 cmake_minimum_required() 设置。如果未设置，CMake 会发出警告并使用 OLD 行为。

注意

策略的 OLD 行为 根据定义已弃用，并且可能会在 CMake 的未来版本中移除。