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