ToolchainEnvironment.RunAsync
Section titled “ToolchainEnvironment.RunAsync”
- Executes a declared absolute tool with an explicitly resolved SDK environment and records the operation cost.
Required contracts
Section titled “Required contracts”API: engine
Project: Inno.Build.Toolchains
Declaration
Section titled “Declaration”public static System.Threading.Tasks.Task Inno.Build.Toolchains.ToolchainEnvironment.RunAsync(Inno.Build.Toolchains.NativeBuildContext context, string fileName, System.Collections.Generic.IReadOnlyList<string> arguments, string workingDirectory, System.Threading.CancellationToken cancellationToken, System.Collections.Generic.IReadOnlyDictionary<string, string> environment)Parameters
Section titled “Parameters”Parameter context: The operation owning execution statistics and frozen recipe inputs.
Parameter fileName: The absolute executable declared by the recipe; no host-native SDK is inferred.
Parameter arguments: Individual arguments passed without shell interpretation.
Parameter workingDirectory: The owned source or intermediate directory.
Parameter cancellationToken: Cancels execution and drains the complete process tree.
Parameter environment: The frozen environment supplied by the selected SDK resolver.
Returns
Section titled “Returns”Completion after successful exit and output delivery.
Exceptions
Section titled “Exceptions”Exception T:System.ArgumentException: The executable is not an absolute declared tool path.
Exception T:System.InvalidOperationException: The process fails to start or exits unsuccessfully.
Exception T:System.OperationCanceledException: Execution was canceled.