PlayerSupportPackCatalog.PublishAsync
Section titled “PlayerSupportPackCatalog.PublishAsync”
- Validates and publishes an immutable pack, then atomically selects it for new readers.
Required contracts
Section titled “Required contracts”API: engine
Project: Inno.Build
Declaration
Section titled “Declaration”public System.Threading.Tasks.ValueTask<Inno.Build.PlayerSupportPackLease> Inno.Build.PlayerSupportPackCatalog.PublishAsync(Inno.Build.BuildTargetId target, string stagingDirectory, Inno.Build.IPlayerSupportPackValidator validator, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken), System.Func<System.Threading.CancellationToken, System.Threading.Tasks.ValueTask>? verifyInputs = null)Parameters
Section titled “Parameters”Parameter target: The platform and architecture owning the staged inputs.
Parameter stagingDirectory: A complete, exclusively owned staging tree on the same filesystem as this catalog. Successful publication consumes this directory unless identical inputs already exist.
Parameter validator: The target validator for runtime and linker inputs.
Parameter cancellationToken: Cancels validation or lease acquisition before selecting the completed pack.
Parameter verifyInputs: Optional final source-input gate after output validation and any publication wait. Omit only when the caller exclusively owns a fully prepared tree with no external preparation inputs.
Returns
Section titled “Returns”Reading ownership of the selected immutable pack; earlier readers retain their own protection.
Exceptions
Section titled “Exceptions”Exception T:System.IO.InvalidDataException: The candidate is incomplete or contains forbidden inputs.
Exception T:System.IO.IOException: The completed directory or its atomic current index cannot be installed.
Exception T:System.OperationCanceledException: Cancellation occurred before the current index was committed.