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.