HEADER_FILE_ONLY

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

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

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

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