Inno.Build.Composition
Section titled “Inno.Build.Composition”
- Explicit platform, content and deployment contributions for an owned build pipeline.
Explicit platform, content and deployment contributions for an owned build pipeline.
Start with distribution composition and Support Pack preparation.
Compose a distribution
Section titled “Compose a distribution”Compose a build distribution explains the actual registration sequence, host/tool/game targets and authoring lifetimes. This library defines neutral contracts; the standard distribution owns built-in registration. Shared Editor Hosting receives a distribution rather than referencing that concrete standard set.
BuildDistribution freezes platform/game/deployment contributions, rejects duplicate or mismatched identities and does not discover SDKs while registering. TryResolveNativeToolchain queries only a matching registered target; an absent registration does not hide a failure from a present provider. ResolveNativeProduct selects the declared product closure before SDK resolution or staging.
Borrowing and lifecycle
Section titled “Borrowing and lifecycle”BuildPipelineFactory receives current authoring services and the frozen distribution. It does not own those services; each Pipeline transaction owns its own work and sources own preparation tasks. Context supplies the neutral INativeBindingGenerator. CreateBindings outputs borrow current Assets/Serialization/TypeCatalog and cannot be retained across Session retirement.
Factories and layout delegates contain immutable configuration rather than live collectible-generation objects. Unsupported host/target combinations fail explicitly, and pre-commit cancellation preserves old output.
Host usage
Section titled “Host usage”Supply existing live dependencies. This example checks the host contract; it does not initialize a complete product or certify a physical device.
using System.Collections.Generic;using Inno.Build.Composition;using Inno.Build.Managed;
static BuildDistribution Compose( IReadOnlyList<GameBuildContribution> contributions, IReadOnlyList<IManagedDeploymentCompiler> deployments) { return new BuildDistribution(contributions, deployments);}Source boundary
Section titled “Source boundary”The source project defines the selected host declarations. Script projection and platform execution require their separate evidence.
API reference
Section titled “API reference”Source project facts
Section titled “Source project facts”Project: Inno.Build.Composition
Source: build/composition/Inno.Build.Composition/Inno.Build.Composition.csproj
| Type | API | Description |
|---|---|---|
| BuildCompositionContext | engine | Captures host-owned SDK selection and application location without probing global process state. |
| BuildDistribution | engine | Freezes platform factories, managed publishers, and matching Support Pack sources as one distribution. |
| BuildPipelineFactory | engine | Creates common build pipelines from a single distribution and explicitly borrowed authoring owners. |
| BuildPlatformContribution | engine | Binds one implemented target to its factory, Support Pack source and SDK provider as a single registration. |
| BuildTargetFactory | engine | Creates a platform packager without borrowing authoring or content compiler services. |
| GameBuildContribution | engine | Registers a platform contribution with the content implementation selected by a distribution. |
| GameContentCompilerFactory | engine | Creates a content compiler borrowing the active authoring services for one pipeline. |
| NativeProductContribution | engine | Binds a product’s immutable graph to its platform-selected execution strategy. |
| NativeToolchainContribution | engine | Registers an implemented native SDK capability without declaring a complete game product. |