execute_process

Выполнить один или несколько дочерних процессов.

execute_process(COMMAND <cmd1> [<arguments>]
                [COMMAND <cmd2> [<arguments>]]...
                [WORKING_DIRECTORY <directory>]
                [TIMEOUT <seconds>]
                [RESULT_VARIABLE <variable>]
                [RESULTS_VARIABLE <variable>]
                [OUTPUT_VARIABLE <variable>]
                [ERROR_VARIABLE <variable>]
                [INPUT_FILE <file>]
                [OUTPUT_FILE <file>]
                [ERROR_FILE <file>]
                [OUTPUT_QUIET]
                [ERROR_QUIET]
                [COMMAND_ECHO <where>]
                [OUTPUT_STRIP_TRAILING_WHITESPACE]
                [ERROR_STRIP_TRAILING_WHITESPACE]
                [ENCODING <name>]
                [ECHO_OUTPUT_VARIABLE]
                [ECHO_ERROR_VARIABLE]
                [COMMAND_ERROR_IS_FATAL <ANY|LAST>])

Выполняет заданную последовательность из одного или нескольких команд.

Команды выполняются параллельно как конвейер, при этом стандартный вывод каждого процесса передаётся в стандартный ввод следующего. Единая труба стандартной ошибки используется для всех процессов.

execute_process выполняет команды во время конфигурирования проекта CMake перед генерацией системы сборки. Используйте команды add_custom_target() и add_custom_command() для создания пользовательских команд, которые выполняются во время сборки.

Параметры:

COMMAND

Строка команд дочернего процесса.

CMake выполняет дочерний процесс, напрямую используя API операционной системы:

• На платформах POSIX строка команд передаётся дочернему процессу в массиве типа argv[].
• На платформах Windows строка команд кодируется как строка таким образом, чтобы дочерние процессы, использующие CommandLineToArgvW, смогли декодировать исходные аргументы.

Не используется промежуточный интерпретатор команд, поэтому операторы оболочки, такие как >, обрабатываются как обычные аргументы. (Используйте параметры INPUT_*, OUTPUT_*, и ERROR_* для перенаправления stdin, stdout и stderr.)

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

WORKING_DIRECTORY

Назначенный каталог будет установлен как текущий рабочий каталог дочерних процессов.

TIMEOUT

По истечении заданного количества секунд (допускаются дробные значения), все незавершенные дочерние процессы будут завершены, и RESULT_VARIABLE будет установлено в строку, упоминающую о «тайм-ауте».

RESULT_VARIABLE

Переменная будет содержать результат последнего дочернего процесса. Это будет целочисленный код возврата последнего дочернего процесса или строка, описывающая ошибку.

RESULTS_VARIABLE <variable>

Добавлена в версии 3.10.

Переменная будет содержать результат всех процессов как список, разделённый точкой с запятой, в порядке указанных COMMAND аргументов. Каждая запись будет представлять собой целочисленный код возврата соответствующего дочернего процесса или строку, описывающую ошибку.

INPUT_FILE <file>

<file> прикрепляется к стандартному вводу трубы первого COMMAND процесса.

OUTPUT_FILE <file>

<file> прикрепляется к стандартному выводу трубы последнего COMMAND процесса.

ERROR_FILE <file>

<file> прикрепляется к трубе стандартной ошибки всех COMMAND процессов.

OUTPUT_QUIET, ERROR_QUIET

Стандартный вывод на OUTPUT_VARIABLE или стандартная ошибка на ERROR_VARIABLE не подключены (содержимое переменной отсутствует). Параметры *_FILE и ECHO_*_VARIABLE не затрагиваются.

OUTPUT_VARIABLE, ERROR_VARIABLE

Названная переменная будет содержать содержимое труб стандартного вывода и стандартной ошибки соответственно. Если одна и та же переменная указана для обеих труб, их вывод будет объединён в порядке их вывода.

ECHO_OUTPUT_VARIABLE, ECHO_ERROR_VARIABLE

Добавлена в версии 3.18.

Стандартный вывод или стандартная ошибка не будут исключительно перенаправлены в указанные переменные.

Вывод будет продублирован в указанные переменные и также в стандартный вывод или стандартную ошибку аналогично команде tee Unix.

COMMAND_ECHO <where>

Добавлена в версии 3.15.

Выполняемая команда будет выведена в <where> с <where>, установленным в одно из значений STDERR, STDOUT или NONE. См. переменную CMAKE_EXECUTE_PROCESS_COMMAND_ECHO для способов управления стандартным поведением, если этот параметр отсутствует.

ENCODING <name>

Добавлена в версии 3.8.

На платформах Windows кодировка, используемая для декодирования вывода процесса. Игнорируется на других платформах. Допустимые имена кодировок:

NONE

Не выполнять декодирование. Предполагается, что вывод процесса закодирован таким же способом, что и внутренняя кодировка CMake (UTF-8).

Это было значением по умолчанию в CMake 3.14 и ранее.

AUTO

Использовать кодовую страницу активной консоли или, если она недоступна, использовать ANSI.

Это было значением по умолчанию в CMake 3.15 по 3.30.

ANSI

Использовать ANSI кодовую страницу.

OEM

Использовать кодовую страницу OEM (Original Equipment Manufacturer).

UTF-8

Добавлена в версии 3.11.

Использовать кодовую страницу UTF-8.

Это значение по умолчанию. См. политику CMP0176.

UTF8

Использовать кодовую страницу UTF-8. Использование этого имени не рекомендуется в пользу UTF-8, чтобы соответствовать соглашению об именовании RFC UTF-8 UTF-8 RFC.

COMMAND_ERROR_IS_FATAL <ANY|LAST>

Добавлена в версии 3.19.

Параметр, следующий за COMMAND_ERROR_IS_FATAL, определяет поведение при возникновении ошибки:

ANY Если любая из команд в списке команд завершается ошибкой, команда execute_process() завершается с ошибкой.

LAST Если последняя команда в списке команд завершается ошибкой, команда execute_process() завершается с ошибкой. Команды, предшествующие в списке, не приведут к фатальной ошибке.