HEADER_FILE_ONLY

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

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

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

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