set_property

Установить именованное свойство в заданной области видимости.

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

Устанавливает одно свойство для нуля или более объектов области видимости.

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

GLOBAL

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

DIRECTORY

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

TARGET

Область видимости может называть ноль или более существующих целей. См. также команду set_target_properties().

SOURCE

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

INSTALL

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

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

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

Чтобы сослаться на сам префикс установки с относительным путем, используйте «.».

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

TEST

Область видимости может называть ноль или более существующих тестов. См. также команду set_tests_properties().

CACHE

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

Необходимый параметр PROPERTY непосредственно следует за именем устанавливаемого свойства. Остальные аргументы используются для составления значения свойства в виде списка, разделенного точкой с запятой.

Если указан параметр APPEND, список добавляется к любому существующему значению свойства. Если указан параметр APPEND_STRING, строка добавляется к любому существующему значению свойства как строка, т. е. это приводит к более длинной строке, а не к списку строк. При использовании APPEND или APPEND_STRING со свойством, определенным для поддержки поведения INHERITED (см. define_property()), наследование не происходит при поиске исходного значения для добавления. Если свойство еще не установлено непосредственно в указанной области видимости, команда будет вести себя так, как если бы APPEND или APPEND_STRING не были указаны.

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