HEADER_FILE_ONLY

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

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

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

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