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) для списка свойств в каждом объёме.