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 executable target ссылается на исполняемый файл, расположенный вне проекта. Правила его построения не генерируются, а целевое свойство 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 не может быть установлена или экспортирована.