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.

См. руководство cmake-buildsystem(7) для получения дополнительной информации о определении свойств системы сборки.

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

Импортированные исполняемые файлы

add_executable(<name> IMPORTED [GLOBAL])

Целевой объект импортированного исполняемого файла ссылается на исполняемый файл, расположенный вне проекта. Правила для его построения не генерируются, и свойство целевого объекта IMPORTED True. Имя целевого объекта имеет область видимости в каталоге, в котором оно создано, и ниже, но опция GLOBAL расширяет видимость. К нему можно обращаться, как к любому целевому объекту, созданному внутри проекта. Импортированные исполняемые файлы IMPORTED полезны для удобного обращения из команд, таких как 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 нельзя устанавливать или экспортировать.