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) руководстве.