add_executable

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

add_executable(<name> [WIN32] [MACOSX_BUNDLE]
               [EXCLUDE_FROM_ALL]
               [source1] [source2 ...])

Добавляет целевой исполняемый файл, названный <name>, который будет скомпилирован из исходных файлов, перечисленных в вызове команды. (Исходные файлы можно опустить, если они будут добавлены позже с помощью target_sources().) Имя <name> соответствует логическому имени целевого файла и должно быть уникальным в рамках проекта. Фактическое имя скомпилированного исполняемого файла формируется на основе конвенций для данной платформы (например, <name>.exe или просто <name>).

По умолчанию исполняемый файл будет создан в каталоге сборки, соответствующем каталогу исходных файлов, в котором была вызвана команда. Обратитесь к документации свойства цели RUNTIME_OUTPUT_DIRECTORY, чтобы изменить это расположение. Обратитесь к документации свойства цели OUTPUT_NAME, чтобы изменить <name> часть конечного имени файла.

Если WIN32 задано, свойство WIN32_EXECUTABLE будет установлено для созданной цели. Для получения подробной информации см. документацию по этому свойству цели.

Если MACOSX_BUNDLE задано, соответствующее свойство будет установлено для созданной цели. Для получения подробной информации см. документацию по свойству цели MACOSX_BUNDLE.

Если EXCLUDE_FROM_ALL задано, соответствующее свойство будет установлено для созданной цели. Для получения подробной информации см. документацию по свойству цели EXCLUDE_FROM_ALL.

Аргументы исходных файлов для add_executable могут использовать «генераторские выражения» со синтаксисом $<...>. Доступные выражения см. в руководстве cmake-generator-expressions(7). Дополнительную информацию о определении свойств системы сборки см. в руководстве cmake-buildsystem(7).

См. также HEADER_FILE_ONLY о том, что делать, если некоторые исходные файлы предварительно обработаны, и вам нужно, чтобы исходные файлы были доступны в IDE.

add_executable(<name> IMPORTED [GLOBAL])

Целевая ссылка IMPORTED исполняемого файла ссылается на исполняемый файл, расположенный вне проекта. Правила для его сборки не генерируются, и свойство цели IMPORTED установлено в True. Имя цели имеет область действия в каталоге, где оно создано и ниже, но опция GLOBAL расширяет видимость. К нему можно обращаться как к любой другой цели, скомпилированной в рамках проекта. IMPORTED исполняемые файлы полезны для удобного использования в командах, таких как add_custom_command(). Подробности импортируемого исполняемого файла указываются с помощью свойств, имена которых начинаются с IMPORTED_. Наиболее важным таким свойством является IMPORTED_LOCATION (и его версия для конфигурации IMPORTED_LOCATION_<CONFIG>), которое указывает расположение основного исполняемого файла на диске. Для получения дополнительной информации см. документацию по свойствам IMPORTED_*.

add_executable(<name> ALIAS <target>)

Создает Целевое псевдоним, поэтому <name> можно использовать для ссылки на <target> в последующих командах. Целевая ссылка <name> не отображается в сгенерированной системе сборки в качестве целевого файла make. Целевая ссылка <target> может не быть не-GLOBAL Импортированной целью или ALIAS. Целевые ссылки ALIAS могут использоваться в качестве целей для чтения свойств, исполняемых файлов для пользовательских команд и пользовательских целей. Их также можно проверить на существование с помощью обычной команды if(TARGET). Целевая ссылка <name> не может использоваться для изменения свойств <target>, то есть она не может использоваться в качестве операнда set_property(), set_target_properties(), target_link_libraries() и т. д. Целевая ссылка ALIAS не может быть установлена ​​или экспортирована.