Novolis.MSBuild.LibraryReference 2026.1.1.12

There is a newer version of this package available.
See the version list below for details.
dotnet add package Novolis.MSBuild.LibraryReference --version 2026.1.1.12
                    
NuGet\Install-Package Novolis.MSBuild.LibraryReference -Version 2026.1.1.12
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Novolis.MSBuild.LibraryReference" Version="2026.1.1.12">
  <PrivateAssets>all</PrivateAssets>
  <IncludeAssets>runtime; build; native; contentfiles; analyzers</IncludeAssets>
</PackageReference>
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Novolis.MSBuild.LibraryReference" Version="2026.1.1.12" />
                    
Directory.Packages.props
<PackageReference Include="Novolis.MSBuild.LibraryReference">
  <PrivateAssets>all</PrivateAssets>
  <IncludeAssets>runtime; build; native; contentfiles; analyzers</IncludeAssets>
</PackageReference>
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Novolis.MSBuild.LibraryReference --version 2026.1.1.12
                    
#r "nuget: Novolis.MSBuild.LibraryReference, 2026.1.1.12"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Novolis.MSBuild.LibraryReference@2026.1.1.12
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Novolis.MSBuild.LibraryReference&version=2026.1.1.12
                    
Install as a Cake Addin
#tool nuget:?package=Novolis.MSBuild.LibraryReference&version=2026.1.1.12
                    
Install as a Cake Tool

<p align="center"> <a href="https://github.com/Novolis-Platform/novolis-msbuild"> <img src="https://raw.githubusercontent.com/Novolis-Platform/.github/main/brand/logo-icon.svg" width="72" alt="Novolis"/> </a> </p>

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): emits PackageReference without Version, and adds PackageVersion only when that PackageId is not already in @(PackageVersion).
  • Non-CPM: puts Version on the PackageReference.

Notes

  • Same non-transitive caveat as ProjectReference mode: replacing a package with a project drops NuGet transitive closure. Reference needed dependencies explicitly.
  • Common PackageReference / ProjectReference metadata (PrivateAssets, IncludeAssets, ExcludeAssets, OutputItemType, …) is forwarded when set.
  • Committed .csproj files should use LibraryReference (or PackageReference); do not commit cross-repo ProjectReference paths.
There are no supported framework assets in this package.

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