ScriptCompiler.CompileRuntimeDeploymentAsync
Section titled “ScriptCompiler.CompileRuntimeDeploymentAsync”
- Compiles only the runtime assembly closure required by a deployed Player and binds it to that Player runtime.
Required contracts
Section titled “Required contracts”API: engine
Project: Inno.Scripting.Compiler
Declaration
Section titled “Declaration”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))Remarks
Section titled “Remarks”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.
Parameters
Section titled “Parameters”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.
Returns
Section titled “Returns”The immutable diagnostics and runtime-only artifacts produced by the compilation attempt.
Exceptions
Section titled “Exceptions”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.