ManagedBuildInputSnapshot.CaptureAsync
Section titled “ManagedBuildInputSnapshot.CaptureAsync”
- Evaluates an explicit managed graph using its frozen SDK and hashes its declared compilation inputs.
Required contracts
Section titled “Required contracts”API: engine
Project: Inno.Build.Toolchains
Declaration
Section titled “Declaration”public static System.Threading.Tasks.ValueTask<Inno.Build.Toolchains.ManagedBuildInputSnapshot> Inno.Build.Toolchains.ManagedBuildInputSnapshot.CaptureAsync(Inno.Build.Toolchains.NativeBuildContext context, Inno.Build.Toolchains.DotNetSdkDescriptor sdk, string project, System.Collections.Generic.IReadOnlyDictionary<string, string> properties, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken))Parameters
Section titled “Parameters”Parameter context: The borrowed operation that owns phase-local content reads and tool statistics.
Parameter sdk: The SDK already selected for this project; evaluation must use its exact CLI entry.
Parameter project: The existing entry project whose references define the managed source closure.
Parameter properties: The immutable compiler and product properties also passed to the actual managed build.
Parameter cancellationToken: Cancels SDK evaluation, drains its process and removes this operation’s request directory.
Returns
Section titled “Returns”A snapshot that can be freshly verified after waiting or executing; no Player compilation is performed.
Remarks
Section titled “Remarks”Restore and evaluation use an owned SDK output layout, independently of ordinary IDE outputs. An explicit ArtifactsPath remains the caller’s responsibility, including its concurrency protection.
Exceptions
Section titled “Exceptions”Exception T:System.ArgumentNullException: A required operation, SDK or property collection is null.
Exception T:System.IO.FileNotFoundException: A required source, compiler, restored package input or SDK declaration is absent.
Exception T:System.IO.IOException: The source entry escapes the physical checkout or a filesystem alias cannot be resolved.
Exception T:System.InvalidOperationException: The selected SDK cannot evaluate the declared graph.
Exception T:System.OperationCanceledException: Evaluation or hashing was canceled.