Exec

Exec

Runs a custom executable as a build step. The executable can be one defined by another build step, or a prebuilt executable. The executable will be run if the outputfile is out of date (with respect to the input files or executable) or if it is missing.

Exec( alias ) ; (optional) Alias { .ExecExecutable ; Executable to run .ExecInput ; (optional) Input file(s) to pass to executable .ExecInputPath ; (optional) Path to find files in .ExecInputPattern ; (optional) Pattern(s) to use when finding files (default *.*) .ExecInputPathRecurse ; (optional) Recurse into dirs when finding files (default true) .ExecInputExcludePath ; (optional) Path(s) to exclude .ExecInputExcludedFiles ; (optional) File(s) to exclude from compilation (partial, root-relative of full path) .ExecInputExcludePattern; (optional) Pattern(s) to exclude .ExecOutput ; Output file generated by executable .ExecArguments ; (optional) Arguments to pass to executable .ExecWorkingDir ; (optional) Working dir to set for executable .ExecReturnCode ; (optional) Expected return code from executable (default 0) .ExecUseStdOutAsOutput ; (optional) Write the standard output from the executable to output file (default false) .ExecAlways ; (optional) Run the executable even if inputs have not changed (default false) .ExecAlwaysShowOutput ; (optional) Show the process output even if the step succeeds (default false) ; Additional options .PreBuildDependencies ; (optional) Force targets to be built before this Exec (Rarely needed, ; but useful when Exec relies on externally generated files). .Environment ; (optional) Environment variables used when running the executable ; If not set, uses .Environment from your Settings node }

Build-Time Substitutions

  • ExecArguments
    • %1 - Input file(s) as provided via ExecInput argument.
    • %2 - Output file as provided by ExecOutput argument.