NetChris.Build.MSBuild 1.0.439274985

This package has been deprecated as it is legacy and is no longer maintained.

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

dotnet add package NetChris.Build.MSBuild --version 1.0.439274985

NuGet\Install-Package NetChris.Build.MSBuild -Version 1.0.439274985

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="1.0.439274985">
  <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.Build.MSBuild --version 1.0.439274985

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

#r "nuget: NetChris.Build.MSBuild, 1.0.439274985"

#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=1.0.439274985

// Install NetChris.Build.MSBuild as a Cake Tool
#tool nuget:?package=NetChris.Build.MSBuild&version=1.0.439274985

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

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
Add the reference: dotnet add package NetChris.Build.MSBuild
Alternately, directly add the PackageReference in your project, using the appropriate major and minor versions:

<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.3.*">
      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
      <PrivateAssets>all</PrivateAssets>
    </PackageReference>
  </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.
`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`