NetChris.BuildTools.Versioning 1.0.444414356

Prefix Reserved

There is a newer version of this package available.
See the version list below for details.

dotnet add package NetChris.BuildTools.Versioning --version 1.0.444414356

NuGet\Install-Package NetChris.BuildTools.Versioning -Version 1.0.444414356

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="NetChris.BuildTools.Versioning" Version="1.0.444414356">
  <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="NetChris.BuildTools.Versioning" Version="1.0.444414356" />
                    

                            Directory.Packages.props

<PackageReference Include="NetChris.BuildTools.Versioning">
  <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 NetChris.BuildTools.Versioning --version 1.0.444414356

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: NetChris.BuildTools.Versioning, 1.0.444414356"

#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 NetChris.BuildTools.Versioning@1.0.444414356

#: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=NetChris.BuildTools.Versioning&version=1.0.444414356
                    

                            Install as a Cake Addin

#tool nuget:?package=NetChris.BuildTools.Versioning&version=1.0.444414356
                    

                            Install as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

NetChris.BuildTools.Versioning

Provides consistent versioning of assemblies and packages

Use

In your project's *.csproj file:

Set <VersionPrefix /> to the {Major}.{Minor} version of your project
Add the reference: dotnet add package NetChris.BuildTools.Versioning
Alternately, directly add the PackageReference in your project, replacing "0.0.*" with the most appropriate package version:

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>netstandard1.1</TargetFramework>

    
    
    <VersionPrefix>0.2</VersionPrefix>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="NetChris.BuildTools.Versioning" Version="0.0.*">
      <PrivateAssets>all</PrivateAssets>
      <IncludeAssets>runtime; build; native; contentfiles; analyzers</IncludeAssets>
    </PackageReference>
  </ItemGroup>
</Project>

This relies on this blurb from "Include MSBuild props and targets in a package":

You might want to add custom build targets or properties in projects that consume your package, such as running a custom tool or process during build. You do this by placing files in the form <package_id>.targets or <package_id>.props [...] within the \build folder of the project.

Variables during build

There are a few properties you can set to vary the versioning. These values can also be supplied through environment variables. They are primarily of use in CI/CD scenarios.

Property	Use	Recommended source
`SemVerPatch`	The SemVer patch version.	Pipeline ID
`SemVerPrerelease`	The SemVer pre-release version, if any	Assuming Pipeline ID for the patch version, just a simple "prerelease" static string.
`AssemblyVersionBuild`	The build number to use for the assembly (and file) [version]https://docs.microsoft.com/en-us/dotnet/api/system.version)	Pipeline IID (i.e. project-specific pipeline ID) to keep ⇐ `UInt16.MaxValue - 1`
`AssemblyVersionRevision`	The revision number to use for the assembly (and file) version	For now, hard-set to `0`

References

SemVer

There are no supported framework assets in this package.

Learn more about Target Frameworks and .NET Standard.

.NETStandard 1.0
- NETStandard.Library (>= 1.6.1)

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
2.0.444415557	1,331	1/10/2022
1.0.444414356	727	1/10/2022
0.0.444355915-pre	662	1/10/2022
0.0.444352211-pre	736	1/10/2022