NetChris.BuildTools.Versioning 0.0.444352211-pre

This is a prerelease version of NetChris.BuildTools.Versioning.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package NetChris.BuildTools.Versioning --version 0.0.444352211-pre                

                    
                

            
NuGet\Install-Package NetChris.BuildTools.Versioning -Version 0.0.444352211-pre
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="0.0.444352211-pre">
  <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. 
paket add NetChris.BuildTools.Versioning --version 0.0.444352211-pre                

                    
                

            
#r "nuget: NetChris.BuildTools.Versioning, 0.0.444352211-pre"
#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. 
// Install NetChris.BuildTools.Versioning as a Cake Addin
#addin nuget:?package=NetChris.BuildTools.Versioning&version=0.0.444352211-pre&prerelease

// Install NetChris.BuildTools.Versioning as a Cake Tool
#tool nuget:?package=NetChris.BuildTools.Versioning&version=0.0.444352211-pre&prerelease

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>
    <AssemblyName>NetChris.MyAssembly</AssemblyName>
    <RootNamespace>NetChris.Standard.MyAssembly</RootNamespace>

    <GenerateDocumentationFile>true</GenerateDocumentationFile>
    <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
    
    <VersionPrefix>0.2</VersionPrefix>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="NetChris.BuildTools.Versioning" Version="0.0.*" />
  </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

There are no supported framework assets in this package.

Learn more about Target Frameworks and .NET Standard.

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 873 1/10/2022
1.0.444414356 284 1/10/2022
0.0.444355915-pre 220 1/10/2022
0.0.444352211-pre 304 1/10/2022