Skip to content
API referenceDevelopmentEngine APIEngine ccf7d03f
Synced

ScriptCompiler.CompileRuntimeDeploymentAsync

Section titled “ScriptCompiler.CompileRuntimeDeploymentAsync”
  • Compiles only the runtime assembly closure required by a deployed Player and binds it to that Player runtime.

API: engine
Project: Inno.Scripting.Compiler

public System.Threading.Tasks.ValueTask<Inno.Scripting.Compiler.ScriptCompilationResult> Inno.Scripting.Compiler.ScriptCompiler.CompileRuntimeDeploymentAsync(string targetRuntimeDirectory, System.IProgress<Inno.Scripting.Compiler.ScriptCompilationProgress>? progress = null, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken))

Complete cache trees use Core IO atomic publication and replacement. Cancellation before commit preserves the previous tree; cancellation does not undo a committed cache. Cleanup failure after commit preserves the installed tree and remaining backup without activating a generation.

Parameter targetRuntimeDirectory: The verified Player Support Pack directory whose runtime assemblies will execute the emitted scripts.

Parameter progress: Optional observer for monotonic compiler progress.

Parameter cancellationToken: The token that cancels compilation before an artifact generation is committed.

The immutable diagnostics and runtime-only artifacts produced by the compilation attempt.

Exception T:System.OperationCanceledException: Thrown when cancellationToken is canceled.

Exception T:System.ArgumentException: Thrown when targetRuntimeDirectory is empty.

Exception T:System.IO.DirectoryNotFoundException: Thrown when targetRuntimeDirectory does not exist.

Exception T:System.IO.InvalidDataException: Thrown when the target runtime has no valid Inno runtime assembly closure.

Exception T:System.IO.IOException: Artifact publication fails, or cleanup fails after a complete cache tree commits.

Exception T:System.UnauthorizedAccessException: The filesystem continues denying artifact access after the bounded Core IO wait.

Exception T:System.AggregateException: Cache replacement and restoration both fail; the exception identifies the preserved previous tree.