Skip to content

Latest commit

 

History

History
41 lines (33 loc) · 2.05 KB

dotnet.md

File metadata and controls

41 lines (33 loc) · 2.05 KB
Raw

.NET support

Nerdbank.GitVersioning offers first class version stamping support for .NET assemblies.

Assembly version generation

During the build it adds source code such as this to your compilation:

[assembly: System.Reflection.AssemblyVersion("1.0")]
[assembly: System.Reflection.AssemblyFileVersion("1.0.24.15136")]
[assembly: System.Reflection.AssemblyInformationalVersion("1.0.24.15136-alpha+g9a7eb6c819")]
  • The first and second integer components of the versions above come from the version file.
  • The third integer component of the version here is the height of your git history up to that point, such that it reliably increases with each release.
  • The fourth component (when present) is the first two bytes of the git commit ID, encoded as an integer. This number will appear essentially random, and is not useful in sorting versions. It is useful when you have two branches in git history that have exactly the same major.minor.height version information in order to distinguish which commit it is.
  • The -alpha tag also comes from the version file and indicates this is an unstable version.
  • The -g9a7eb6c819 tag is the concatenation of -g and the git commit ID that was built.

This class is also injected into your project at build time:

internal sealed partial class ThisAssembly {
    internal const string AssemblyVersion = "1.0";
    internal const string AssemblyFileVersion = "1.0.24.15136";
    internal const string AssemblyInformationalVersion = "1.0.24.15136-alpha+g9a7eb6c819";
    internal const string AssemblyName = "Microsoft.VisualStudio.Validation";
    internal const string PublicKey = @"0024000004800000940000...reallylongkey..2342394234982734928";
    internal const string PublicKeyToken = "b03f5f7f11d50a3a";
    internal const string AssemblyTitle = "Microsoft.VisualStudio.Validation";
    internal const string AssemblyConfiguration = "Debug";
    internal const string RootNamespace = "Microsoft";
}

This allows you to actually write source code that can refer to the exact build number your assembly will be assigned.