CMP0056

Учитывать флаги ссылок в try_compile() сигнатуре файла исходного кода.

Команда try_compile() генерирует файл CMakeLists.txt для построения файла исходного кода в исполняемый файл. Для компиляции исходного кода таким же образом, как это может быть сделано вызывающим проектом, сгенерированный проект устанавливает значение переменной CMAKE_<LANG>_FLAGS в соответствии со значением в вызывающем проекте. В некоторых случаях может потребоваться значение переменной CMAKE_EXE_LINKER_FLAGS, но CMake 3.1 и ниже не устанавливали его в сгенерированном проекте. CMake 3.2 и выше предпочитает устанавливать его таким образом, чтобы учитывались как флаги компоновщика, так и флаги компилятора. Данная политика обеспечивает совместимость с поведением до версии 3.2.

Поведение OLD для этой политики заключается в том, чтобы не устанавливать значение переменной CMAKE_EXE_LINKER_FLAGS в сгенерированном тестовом проекте. Поведение NEW для этой политики заключается в установке значения переменной CMAKE_EXE_LINKER_FLAGS в тестовом проекте в соответствии со значением в вызывающем проекте.

Если код проекта не устанавливает политику явно, пользователи могут установить её в командной строке, определив переменную CMAKE_POLICY_DEFAULT_CMP0056 в кэше.

Данная политика была введена в CMake версии 3.2. В отличие от большинства политик, CMake версии 3.20.0-rc3 по умолчанию не выводит предупреждение, если эта политика не установлена, и просто использует поведение OLD. Для управления предупреждением см. документацию по переменной CMAKE_POLICY_WARNING_CMP0056.