BuildPipeline.EnsurePlayerSupportPackAsync
Section titled “BuildPipeline.EnsurePlayerSupportPackAsync”
- Validates the platform and managed deployment before asynchronously preparing its Support Pack.
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.BuildPipeline.EnsurePlayerSupportPackAsync(Inno.Build.BuildTargetId target, Inno.Build.Managed.ManagedDeploymentId? deployment, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken))Parameters
Section titled “Parameters”Parameter target: The registered platform and architecture target to prepare.
Parameter deployment: The selected managed publisher, or null to use the platform’s default deployment. Unsupported pairs fail before any provisioner or external tool starts.
Parameter cancellationToken: Cancellation before the Pack installation commits.
Returns
Section titled “Returns”Reading ownership of the verified Pack, to be disposed after starting its consuming build. No authoring asset database operations run during preparation.
Exceptions
Section titled “Exceptions”Exception T:System.NotSupportedException: No game target is registered for the requested identity.
Exception T:System.InvalidOperationException: The managed publisher is absent or cannot publish the selected platform’s runtime identifier.
Exception T:System.IO.DirectoryNotFoundException: The Pack is absent and this host has no provisioner.
Exception T:System.IO.InvalidDataException: An installed or newly published Pack fails deployment validation.