Synced
ScriptReloadHost
Section titled “ScriptReloadHost”
- Watches, compiles, and atomically activates one project’s C# script assemblies.
Required contracts
Section titled “Required contracts”API: engine
Implements: System.IDisposable
Inherits: object
Project: Inno.Scripting.Reload
Declaration
Section titled “Declaration”public sealed class Inno.Scripting.Reload.ScriptReloadHost : System.IDisposableMembers
Section titled “Members”| Kind | Element | Description |
|---|---|---|
| Constructors | ScriptReloadHost.Constructor | Creates a reload host for one compiler and runtime module owner. |
| Methods | ScriptReloadHost.AdvanceUnloadVerification | Advances cooperative unload verification for retired script generations. |
| Methods | ScriptReloadHost.ApplyPendingReload | Applies the latest compiled generation, or commits a Plugin-unavailability generation when changed Plugin code cannot produce a replacement, at a caller-controlled main-thread safe point. |
| Methods | ScriptReloadHost.CancelCompilation | Requests cancellation of the active compilation without changing the active script generation. |
| Methods | ScriptReloadHost.Dispose | Cancels and waits for active compilation work, stops Asset Database observation, and unloads the active script module. |
| Methods | ScriptReloadHost.GenerateProjectFiles | Generates standard SDK-style game/editor projects and a solution for IDE tooling. |
| Methods | ScriptReloadHost.RecompileScripting | Queues incremental recompilation of changed script assemblies. |
| Methods | ScriptReloadHost.ReloadPlugins | Queues replacement of the unified plugin generation and both dependent scripting generations. Valid script artifacts are reused when plugin reference fingerprints are unchanged. |
| Methods | ScriptReloadHost.ReloadScripting | Queues a complete rebuild of both scripting load contexts while retaining the plugin generation. Valid cached artifacts are reused. |
| Methods | ScriptReloadHost.Start | Subscribes to committed asset changes and queues a cache-aware initial compilation request. |
| Methods | ScriptReloadHost.TryCompilePending | Starts a pending compilation after the configured quiet period has elapsed. |
| Properties | ScriptReloadHost.compilationElapsed | Gets the elapsed duration of the active or most recently completed compilation. |
| Properties | ScriptReloadHost.isCompilationPending | Gets whether source or plugin changes are waiting to be compiled. |
| Properties | ScriptReloadHost.isCompilationTakingLong | Gets whether the active compilation exceeded the configured warning duration. |
| Properties | ScriptReloadHost.isCompiling | Gets whether a compilation currently owns the compiler gate. |
| Properties | ScriptReloadHost.isFaulted | Gets whether a retired generation exceeded the retention threshold and permanently stopped this host. |
| Properties | ScriptReloadHost.isUnloadVerificationPending | Gets whether retired collectible assembly generations are still being verified for unload. |
| Properties | ScriptReloadHost.lastCompilation | Gets the most recently completed compilation. |
| Properties | ScriptReloadHost.progress | Gets one atomically published operation, fraction, stage and cancellation snapshot. |