add_executable

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

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

Добавляет целевой исполняемый файл, названный <name>, который будет построен из исходных файлов, перечисленных в вызове команды. <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) для получения дополнительной информации об определении свойств системы сборки.

add_executable(<name> IMPORTED [GLOBAL])

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

add_executable(<name> ALIAS <target>)

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