set_property

Установите свойство с заданным именем в заданном объёме.

set_property(<GLOBAL                            |
              DIRECTORY [dir]                   |
              TARGET    [target1 [target2 ...]] |
              SOURCE    [src1 [src2 ...]]       |
              INSTALL   [file1 [file2 ...]]     |
              TEST      [test1 [test2 ...]]     |
              CACHE     [entry1 [entry2 ...]]>
             [APPEND] [APPEND_STRING]
             PROPERTY <name> [value1 [value2 ...]])

Установите одно свойство для нуля или более объектов области. Первый аргумент определяет область, в которой устанавливается свойство. Он должен быть одним из следующих:

GLOBAL

Область уникальна и не принимает имя.

DIRECTORY

Область по умолчанию — текущая директория, но может быть указана другая директория (уже обработанная CMake) полным или относительным путём.

TARGET

Область может именовать ноль или более существующих целей.

SOURCE

Область может именовать ноль или более исходных файлов. Обратите внимание, что свойства исходных файлов видны только для целей, добавленных в той же директории (CMakeLists.txt).

INSTALL

Область может именовать ноль или более установленных путей к файлам. Они предоставляются CPack для влияния на развертывание.

И ключ, и значение свойства могут использовать выражения генератора. Специфические свойства могут относиться к установленным файлам и/или директориям.

Компоненты пути должны быть разделены прямыми слешами, должны быть нормализованы и чувствительны к регистру.

Для ссылки на сам префикс установки с помощью относительного пути используйте «.».

В настоящее время свойства установленных файлов определены только для генератора WIX, где указанные пути относительны к префиксу установки.

TEST

Область может именовать ноль или более существующих тестов.

CACHE

Область должна именовать ноль или более существующих записей кэша.

Требуемый PROPERTY параметр немедленно следует за именем устанавливаемого свойства. Остальные аргументы используются для составления значения свойства в виде списка, разделённого точкой с запятой. Если указан APPEND параметр, список добавляется к любому существующему значению свойства. Если указан APPEND_STRING параметр, строка добавляется к любому существующему значению свойства как строка, то есть она приводит к более длинной строке, а не к списку строк.

См. cmake-properties(7) руководство для списка свойств в каждой области.