CMP0141

Флаги формата отладки MSVC выбираются с помощью абстракции.

Компиляторы, ориентированные на MSVC ABI, имеют флаги для выбора формата отладочной информации. Выбор формата отладочной информации обычно варьируется в зависимости от конфигурации сборки.

В CMake 3.24 и ниже, флаги формата отладочной информации добавляются в стандартные значения кеша CMAKE_<LANG>_FLAGS_<CONFIG> CMake автоматически. Это позволяет пользователям изменять значения кеша для настройки флагов. Однако наличие таких стандартных флагов является проблемой для проектов, которые хотят программно выбрать другую библиотеку времени выполнения. В частности, это требует редактирования строк переменных CMAKE_<LANG>_FLAGS_<CONFIG> с пониманием стандартных значений CMake, чтобы их можно было заменить.

CMake 3.25 и выше предпочитают исключить флаги формата отладочной информации из стандартных значений кеша CMAKE_<LANG>_FLAGS_<CONFIG> и вместо этого предлагают абстракцию первого класса. Переменная CMAKE_MSVC_DEBUG_INFORMATION_FORMAT и свойство целевого объекта MSVC_DEBUG_INFORMATION_FORMAT могут быть установлены для выбора формата отладочной информации MSVC. Если они не установлены, CMake включает отладочную информацию в отладочных конфигурациях, используя значение по умолчанию $<$<CONFIG:Debug,RelWithDebInfo>:ProgramDatabase>, если оно поддерживается компилятором, а в противном случае $<$<CONFIG:Debug,RelWithDebInfo>:Embedded>.

Эта политика обеспечивает совместимость с проектами, которые не были обновлены для понимания абстракции. Настройка политики вступает в силу с первого вызова команды project() или enable_language(), которая включает язык, компилятор которого ориентирован на MSVC ABI.

Поведение OLD для этой политики заключается в размещении флагов формата отладочной информации MSVC в стандартных значениях кеша CMAKE_<LANG>_FLAGS_<CONFIG> и игнорировании абстракции CMAKE_MSVC_DEBUG_INFORMATION_FORMAT. Поведение NEW для этой политики заключается в том, чтобы *не* размещать флаги формата отладочной информации MSVC в стандартных значениях кеша и вместо этого использовать абстракцию.

Эта политика была представлена в версии CMake 3.25. Используйте команду cmake_policy() для явного её задания в OLD или NEW. В отличие от многих политик, CMake версии 3.28.6 *не* предупреждает, когда эта политика не установлена, и просто использует поведение OLD.