Novolis.MSBuild.LibraryReference
2026.1.1.21
See the version list below for details.
dotnet add package Novolis.MSBuild.LibraryReference --version 2026.1.1.21
NuGet\Install-Package Novolis.MSBuild.LibraryReference -Version 2026.1.1.21
<PackageReference Include="Novolis.MSBuild.LibraryReference" Version="2026.1.1.21"> <PrivateAssets>all</PrivateAssets> <IncludeAssets>runtime; build; native; contentfiles; analyzers</IncludeAssets> </PackageReference>
<PackageVersion Include="Novolis.MSBuild.LibraryReference" Version="2026.1.1.21" />
<PackageReference Include="Novolis.MSBuild.LibraryReference"> <PrivateAssets>all</PrivateAssets> <IncludeAssets>runtime; build; native; contentfiles; analyzers</IncludeAssets> </PackageReference>
paket add Novolis.MSBuild.LibraryReference --version 2026.1.1.21
#r "nuget: Novolis.MSBuild.LibraryReference, 2026.1.1.21"
#:package Novolis.MSBuild.LibraryReference@2026.1.1.21
#addin nuget:?package=Novolis.MSBuild.LibraryReference&version=2026.1.1.21
#tool nuget:?package=Novolis.MSBuild.LibraryReference&version=2026.1.1.21
Novolis.MSBuild.LibraryReference
MSBuild package that provides a single LibraryReference item for dependencies that should use a local ProjectReference when the project exists, otherwise a PackageReference.
Expansion runs at evaluation time so dotnet restore (including NuGet static-graph restore) sees the resulting references. Do not reintroduce a Target for this; Target-added ProjectReferences fail restore with NETSDK1004.
Novolis workspace
Novolis.Packaging.targets already imports these props and targets and sets LibraryReferenceDefaultVersion to 2026.1.*. A Novolis repo only adds the item:
<ItemGroup>
<LibraryReference Include="Novolis.Math.Geometry" />
</ItemGroup>
Do not PackageReference this package inside the workspace. Static-graph restore would miss the expanded references on the first pass.
Install (outside the workspace)
<ItemGroup>
<PackageReference Include="Novolis.MSBuild.LibraryReference" PrivateAssets="all" />
</ItemGroup>
With central package management, add a PackageVersion row (for example 2026.1.*).
Usage
<ItemGroup>
<LibraryReference Include="Novolis.Math.Geometry"
Version="2026.1.*"
ProjectPath="$(NovolisWorkspaceRoot)novolis-math\src\Novolis.Math.Geometry\Novolis.Math.Geometry.csproj" />
<LibraryReference Include="Some.Other.Lib" />
</ItemGroup>
Optional map (PackageId → path), useful when many consumers share the same checkout layout:
<ItemGroup>
<LibraryProjectMap Include="Novolis.Math.Geometry">
<ProjectPath>$(NovolisWorkspaceRoot)novolis-math\src\Novolis.Math.Geometry\Novolis.Math.Geometry.csproj</ProjectPath>
</LibraryProjectMap>
</ItemGroup>
LibraryReference items without ProjectPath pick up a matching LibraryProjectMap entry before the Exists check.
Properties
| Property | Default | Meaning |
|---|---|---|
LibraryReferenceEnabled |
true |
Kill switch |
LibraryReferenceDefaultVersion |
* |
Used when item Version is omitted (“latest” float) |
Floating versions require NuGet floating versions (Novolis enables CentralPackageFloatingVersionsEnabled). Prefer an explicit platform float such as 2026.1.* for Novolis packages.
CPM vs non-CPM
- CPM (
ManagePackageVersionsCentrally=true): emitsPackageReferencewithout Version, and addsPackageVersiononly when that PackageId is not already in@(PackageVersion). - Non-CPM: puts
Versionon thePackageReference.
Notes
- Same non-transitive caveat as ProjectReference mode: replacing a package with a project drops NuGet transitive closure. Reference needed dependencies explicitly.
- Common
PackageReference/ProjectReferencemetadata (PrivateAssets,IncludeAssets,ExcludeAssets,OutputItemType, …) is forwarded when set. - Committed
.csprojfiles should useLibraryReference(orPackageReference); do not commit cross-repoProjectReferencepaths.
Learn more about Target Frameworks and .NET Standard.
This package has no dependencies.
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 2026.1.1.22 | 100 | 11/6/2026 |
| 2026.1.1.21 | 96 | 11/6/2026 |
| 2026.1.1.20 | 131 | 10/18/2026 |
| 2026.1.1.19 | 118 | 10/18/2026 |
| 2026.1.1.16 | 122 | 10/18/2026 |
| 2026.1.1.14 | 157 | 10/4/2026 |
| 2026.1.1.13 | 146 | 10/1/2026 |
| 2026.1.1.12 | 142 | 9/30/2026 |