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