NetChris.Build.MSBuild 0.0.438178403-pre.24

This is a prerelease version of NetChris.Build.MSBuild.
dotnet add package NetChris.Build.MSBuild --version 0.0.438178403-pre.24                
NuGet\Install-Package NetChris.Build.MSBuild -Version 0.0.438178403-pre.24                
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.Build.MSBuild" Version="0.0.438178403-pre.24" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add NetChris.Build.MSBuild --version 0.0.438178403-pre.24                
#r "nuget: NetChris.Build.MSBuild, 0.0.438178403-pre.24"                
#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.Build.MSBuild as a Cake Addin
#addin nuget:?package=NetChris.Build.MSBuild&version=0.0.438178403-pre.24&prerelease

// Install NetChris.Build.MSBuild as a Cake Tool
#tool nuget:?package=NetChris.Build.MSBuild&version=0.0.438178403-pre.24&prerelease                

NetChris.Build.MSBuild

Provides:

  • Consistent versioning of assemblies and packages

Use

In your project's *.csproj file:

  • Set <VersionPrefix /> to the {Major}.{Minor} version of your project
  • Reference the NetChris.Build.MSBuild package

Example:

<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.Build.MSBuild" Version="0.0.*" />
  </ItemGroup>
</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.
AssemblyVersionPatch The patch number to use for the assembly (and file) version Pipeline IID (i.e. project-specific pipeline ID) to keep ⇐ UInt16.MaxValue - 1
AssemblyVersionBuild The build number to use for the assembly (and file) version TBD

References

There are no supported framework assets in this package.

Learn more about Target Frameworks and .NET Standard.

  • .NETCoreApp 3.1

    • No dependencies.

GitHub repositories

This package is not used by any popular GitHub repositories.