PlayerSupportPackPublisher.PublishAsync
Section titled “PlayerSupportPackPublisher.PublishAsync”
- Prepares a target closure in isolation and publishes its immutable deployment inputs.
Required contracts
Section titled “Required contracts”API: engine
Project: Inno.Build.SupportPacks.Core
Declaration
Section titled “Declaration”public System.Threading.Tasks.ValueTask<Inno.Build.SupportPacks.PlayerSupportPackPublication> Inno.Build.SupportPacks.PlayerSupportPackPublisher.PublishAsync(string engineRoot, string outputRoot, Inno.Build.BuildTargetId target, string dotnetHost, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken), string? nativeDependencies = null)Parameters
Section titled “Parameters”Parameter engineRoot: The source checkout containing InnoEngine.sln.
Parameter outputRoot: The directory owning installed target packs.
Parameter target: The registered target identity.
Parameter dotnetHost: The SDK executable selected by the host.
Parameter cancellationToken: Cancels preparation before directory installation begins.
Parameter nativeDependencies: An explicit native selection disabling third-party production, or null for local source preparation.
Returns
Section titled “Returns”Reading ownership of the selected Pack and any post-commit diagnostics. Dispose after consuming its files.
Remarks
Section titled “Remarks”Writers targeting the same pack share an exclusive, cancelable preparation lease. Publication atomically selects a fingerprint directory; previous generations remain valid for readers.
Exceptions
Section titled “Exceptions”Exception T:System.ArgumentException: A required path is blank or the target has no registered source.
Exception T:System.IO.DirectoryNotFoundException: The engine checkout is unavailable.
Exception T:System.IO.InvalidDataException: The prepared closure is incomplete or invalid.
Exception T:System.IO.IOException: The staging tree, immutable artifact or atomic current index cannot be installed.
Exception T:System.OperationCanceledException: Preparation was canceled; the installed pack is unchanged.