HEADER_FILE_ONLY

Является ли этот файл исходного кода только заголовочным файлом.

Свойство файла исходного кода, указывающее, является ли он заголовочным файлом, который не следует компилировать в объектный файл. Это свойство устанавливается автоматически на основе расширения файла и используется CMake для определения необходимости вычисления определённых сведений о зависимостях.

Установив для этого свойства значение ON, можно отключить компиляцию указанного файла исходного кода, даже если его следовало бы скомпилировать, поскольку он входит в состав исходных файлов библиотеки или исполняемого файла.

Это полезно, если некоторые файлы исходного кода проходят предварительную обработку, а затем предварительно обработанные файлы добавляются с помощью add_library() или add_executable(). Обычно в IDE отображаются только предварительно обработанные файлы, а исходные файлы не отображаются. Поэтому, если установить для всех исходных файлов это свойство в значение ON, а затем вызвать add_library() или add_executable(), передав как предварительно обработанные, так и исходные файлы, либо использовать target_sources() для добавления исходных файлов, результат будет именно таким, как ожидается: исходные файлы будут отображаться в IDE, но не будут собираться.