Skip to content
Purview Dev logo

Documentation section: Project

Release notes

Stable release history for Purview.Aspire.ResourceKit, with the highlights that matter when you upgrade from the 1.0.0-prerelease.* line. The full, machine-readable history lives in CHANGELOG.md and on the GitHub releases page.

  • BuildResource is generated from a declared path. A DotnetProjectResource, ViteAppResource or NextJsAppResource kit that declares ProjectPath/ResourcePath and writes no override gets AddDotnetProject, AddViteApp or AddNextJsApp generated, so the path is stated once, on the attribute. A hand-written override still wins, and SG0018 still validates it. See Project Resources.
  • SG0044 (Info) and its code fix remove an override that only repeats the generated call, moving the path into the attribute first when it isn’t declared there.
  • Aspire 17 Project V2 — [ResourceDefinition<DotnetProjectResource>("api", ProjectPath = "../Api/Api.csproj")] with AddDotnetProject. The generator emits ResourceKitBase<THostKit, DotnetProjectResource>; SG0018 validates the declared path (normalising \//), SG0019 validates an explicit base, and the new SG0041 reports a ProjectPath on a resource that is not DotnetProjectResource. See Project Resources.
  • Aspire 13.6 still supported. The package keeps the Aspire.Hosting 13.6.5 floor and resolves DotnetProjectResource by metadata name, so a 13.6 consumer is unaffected. verify-consumers builds both a 13.6 and a 17 consumer from the packed package.
  • Path-based resources. ResourcePath declares the path for AddDotnetProject and the Aspire JavaScript Add*App methods, validated by SG0018. SG0042 reports a ProjectPath that disagrees with it and SG0043 a resource type that is not added by path.
  • Typed paths. <ResourceKitProject> and <ResourceKitPath> items generate AppHostProjects constants (Name, Path) to use on the attribute; RKP0001–RKP0003 report a missing path or an invalid name.
  • Breaking: .NET 10 is the minimum. The net8.0 and net9.0 targets are gone; a consuming AppHost must be on net10.0 or net11.0, and the package ships lib/net10.0 (the floor) and lib/net11.0 (the newest leg). See Supported target frameworks and .NET 11 toolchain and feature adoption.
  • .NET 11 leg and tooling — the repository builds with the .NET 11 GA SDK, Purview.BuildSdk 2.0.1 and TUnit 1.83. The net11.0 leg opts into the SDK’s Runtime Async (PurviewRuntimeAsync=true) and takes its memory-safety rules; the net10.0 leg keeps the 10.0.15 Microsoft.Extensions.* floor. OptionsHelper.PathFor<TOptions, TValue> adds a non-boxing selector overload, and pack validation now compares against the published 1.1.0 baseline.
  • Resource groups. [ResourceGroup] and [InGroup<TGroup>] gather kits under named, nestable groups. A group can be switched off or given a mode from configuration, and in run mode it appears as a node in the dashboard with its kits nested underneath. See Groups and URLs.
  • Named dashboard URLs. [ResourceUrl] and [EndpointUrl] declare a kit’s or group’s dashboard links as options. A relative URL adds one link for one endpoint, instead of rewriting every endpoint URL as WithUrl("/path") does.
  • Diagnostics SG0021-SG0031 for groups and URLs. A group can never become its own ancestor or member.
  • Parent and child resource kits (issue #57). Parent = typeof(TParentKit) gives the child a typed Parent, the parent a typed child property, parent-before-child build ordering, inherited enablement, and nested options (<HostKit>:<Parent>:<Child>). VNET/subnets, SQL server/database, Service Bus and storage account/container hierarchies are supported without a second composition framework. See Parent and child resource kits.
  • Diagnostics SG0032-SG0038 for self-parenting, cycles, unavailable parents, child property collisions, duplicate child property names, and generated Parent member collisions. Manual graphs are validated at runtime before any Aspire resource is created.
  • SG0039 warns when a child’s explicit primary group differs from its parent’s, because visual placement follows the child’s group (or an existing Aspire parent chain), not the ResourceKit hierarchy.
  • SG0040 (Info) and its code fix remove a redundant .ResourceBuilder hop from a kit receiver: Parent.ResourceBuilder.AddDatabase(...) becomes Parent.AddDatabase(...).

The first stable release. The public surface that shipped during the prerelease line is now frozen under semantic versioning.

  • Attributes drive generation — [HostKit] and [ResourceDefinition] / [ResourceDefinition<TResource>] produce the host kit, resource kit skeletons, typed options, and the AppHost extension method. See Attributes Reference and Generated Output.
  • Deterministic lifecycle — Build/BuildResource(...) constructs resources, then Configure/ConfigureResource() wires them together. See Lifecycle: Build vs Configure.
  • Declarative enablement — IsEnabled and IsResourceEnabled(builder). See Enablement.
  • Typed, extendable options — generated sealed partial options bound from configuration. See Configuration and Options.
  • Test-friendly overrides — OptionsHelper for args, environment variables, and flattening. See OptionsHelper and Testing with ResourceKit.
  • Project resources — first-class AddProject<T>() support with SG0018/SG0019 validation. See Project Resources.
  • Diagnostics SG0001–SG0020 with an IDE code fix for SG0020. See Diagnostics.
  • Agent skills — 1.0.0 bundled aspire-apphost-to-resourcekit and copied it into .agents/skills/** on build. That delivery is withdrawn: skills now install through the skills CLI, and the authored set has changed. See Agent Skills.
  • No public API changes are required when moving from 1.0.0-prerelease.* to 1.0.0.
  • Pin Purview.Aspire.ResourceKit to 1.0.0 (or a later compatible 1.x).