NativeToolchainPreparation.Freeze
Section titled “NativeToolchainPreparation.Freeze”
- Validates and freezes a provider’s complete tool selection before product staging, including CMake data from its physical installation rather than a shared command prefix.
Required contracts
Section titled “Required contracts”API: engine
Project: Inno.Build.Toolchains
Declaration
Section titled “Declaration”public static Inno.Build.Toolchains.NativeToolchainSelection Inno.Build.Toolchains.NativeToolchainPreparation.Freeze(string targetId, Inno.Build.Toolchains.BuildHostDescriptor host, System.Collections.Generic.IReadOnlyDictionary<string, string> tools, System.Collections.Generic.IReadOnlyDictionary<string, string> environment, System.Collections.Generic.IEnumerable<string> inputs, System.Collections.Generic.IEnumerable<string> cmakeArguments, Inno.Build.Toolchains.NativeLinkPlan linkPlan, bool multiConfiguration, Inno.Build.Toolchains.NativeCompilerInputs? compilerInputs = null)Parameters
Section titled “Parameters”Parameter targetId: The explicit requested target.
Parameter host: The declared tool execution host.
Parameter tools: Selected executable paths.
Parameter environment: Isolated child environment.
Parameter inputs: Selected compiler and SDK inputs.
Parameter cmakeArguments: Ordered target configuration arguments.
Parameter multiConfiguration: Whether configuration is chosen during build.
Parameter linkPlan: The sole source of target library formats and linker capabilities.
Parameter compilerInputs: The selected SDK parser inputs, or null for a selection without parsing capability.
Returns
Section titled “Returns”An immutable selection with validated physical tool and SDK inputs.
Exceptions
Section titled “Exceptions”Exception T:System.IO.FileNotFoundException: A selected SDK input or executable is absent.
Exception T:System.IO.IOException: A selected CMake executable alias cannot be resolved to its installation.