BuildCachePublisher.Record
Section titled “BuildCachePublisher.Record”
- Records a completed generation and optionally selects it as a protected current root. The caller must hold this publisher’s activity lease and the artifact’s producer or reading lease.
Required contracts
Section titled “Required contracts”API: engine
Project: Inno.Build.Toolchains
Declaration
Section titled “Declaration”public void Inno.Build.Toolchains.BuildCachePublisher.Record(string directory, string leasePath, System.Collections.Generic.IReadOnlyList<string> dependencies, string? currentKey, string? targetId, System.Threading.CancellationToken cancellationToken = default(System.Threading.CancellationToken))Parameters
Section titled “Parameters”Parameter directory: An existing artifact within this publisher’s exact boundary.
Parameter leasePath: The persistent lease used by its producer and readers.
Parameter dependencies: Exact owned entries required while this generation is protected.
Parameter currentKey: A product/target/configuration root identity, or null for an unselected generation.
Parameter cancellationToken: Cancels before metadata selection.
Parameter targetId: The producer’s product target, or null for a shared host generation.
Exceptions
Section titled “Exceptions”Exception T:System.IO.IOException: An owned path escapes the boundary, crosses a directory link, or contains an invalid file link.
Exception T:System.IO.DirectoryNotFoundException: The completed generation is absent.
Remarks
Section titled “Remarks”Reusable workspaces may contain compiler-created file aliases only when their complete link chain resolves to a regular file within the same workspace. Aliases are not counted as duplicate payloads. Immutable artifacts and process working directories reject all links.