VersionInfoGenerator 3.1.0

VersionInfoGenerator

A .NET library that makes csproj version information (including git state) available at runtime and compile time.

Compliant with SemVer 2.0.0

How to use

In your .csproj:

<PropertyGroup>
  <Version>1.0.0</Version> 
  <VersionPrerelease>rc1</VersionPrerelease> 
</PropertyGroup>

<ItemGroup>
  <PackageReference Include="VersionInfoGenerator" Version="3.1.0" PrivateAssets="all" />
</ItemGroup>

Output:

internal static class VersionInfo
{
    public const string RootNamespace = "VersionInfoGenerator.TestProject";
    public const string Version = "1.0.0";
    public const string VersionPrerelease = "rc1";
    public const string VersionMetadata = "git-ac717b1";
    public const string SemVer = "1.0.0-rc1+git-ac717b1";
    public const string GitRevShort = "ac717b1";
    public const string GitRevLong = "ac717b1885cd0f984cabe77dd5f37c9200795298";
    public const string GitBranch = "master";
    public const string GitTag = "v1.0.0";
    public const int GitCommitsSinceTag = 0;
    public const bool GitIsDirty = false;
}

Settings

<PropertyGroup>
  
  <Version>1.0.0</Version>
  
  <VersionValidate>true</VersionValidate>
  
  <VersionPrerelease></VersionPrerelease>
  
  <VersionMetadata>git-@@GitRevShort@@</VersionMetadata>
  
  <VersionInfoUseMetadata>true</VersionInfoUseMetadata>
  
  <VersionInfoOverrideVersions>true</VersionInfoOverrideVersions>
  
  <VersionInfoOverridePackageVersion>true</VersionInfoOverridePackageVersion>
  
  <VersionInfoOverrideRepositoryInfo>true</VersionInfoOverrideRepositoryInfo>
  
  <VersionInfoClassName>VersionInfo</VersionInfoClassName>
  
  
  <VersionInfoClassNamespace></VersionInfoClassNamespace>
  
  <VersionInfoClassNamespaceGlobal>false</VersionInfoClassNamespaceGlobal>
  
  <VersionInfoClassModifiers>internal static</VersionInfoClassModifiers>
  
  <VersionInfoGenerateClass>true</VersionInfoGenerateClass>
  
  <VersionInfoClassSerializedProperties>RootNamespace;Version;VersionPrerelease;VersionMetadata;SemVer;GitRevShort;GitRevLong;GitBranch;GitTag;GitCommitsSinceTag;GitIsDirty</VersionInfoClassSerializedProperties>
  
  <VersionInfoGenerateJson>false</VersionInfoGenerateJson>
  
  <VersionInfoJsonOutputPath>VersionInfo.json</VersionInfoJsonOutputPath>
  
  <VersionInfoJsonSerializedProperties>RootNamespace;Version;VersionPrerelease;VersionMetadata;SemVer;GitRevShort;GitRevLong;GitBranch;GitTag;GitCommitsSinceTag;GitIsDirty</VersionInfoClassJsonSerializedProperties>
</PropertyGroup>

A config file (named VersionInfoGenerator.Config.props) can be created to gain more control over the MSBuild properties, e.g.:

<Project>
  <PropertyGroup>
    <GitBinary>/path/to/git</GitBinary>
  </PropertyGroup>

  <Target Name="VersionInfoConfig" AfterTargets="VersionInfoGenerator_GetGitInfo">
    <PropertyGroup>
      <VersionMetadata>NO_TAG</VersionMetadata>
      <VersionMetadata Condition="'$(GitTag)' != ''">$(GitTag)</VersionMetadata>
    </PropertyGroup>

    <PropertyGroup Condition="'$(GitCommitsSinceTag)' != '0'">
      <VersionMetadata>$(VersionMetadata)-$(GitCommitsSinceTag)</VersionMetadata>
    </PropertyGroup>

    <PropertyGroup Condition="'$(GitBranch)' == 'master'">
      <VersionMetadata>$(VersionMetadata)-RELEASE</VersionMetadata>
    </PropertyGroup>
  </Target>
</Project>

VersionInfo.json

A JSON file can be generated for version processing by external tools, e.g.:

<PropertyGroup>
  <VersionInfoGenerateJson>true</VersionInfoGenerateJson>
</PropertyGroup>

Output (bin/Release/xxx/VersionInfo.json):

{
  "RootNamespace": "VersionInfoGenerator.TestProject",
  "Version": "1.0.0",
  "VersionPrerelease": null,
  "VersionMetadata": "git-0378e47",
  "SemVer": "1.0.0+git-0378e47",
  "GitRevShort": "0378e47",
  "GitRevLong": "0378e47109d698eeceaf07ad75e48ea36143d2e3",
  "GitBranch": "master",
  "GitTag": "v1.0.0",
  "GitCommitsSinceTag": 0,
  "GitIsDirty": false
}

Special variable substitution

Special variables can be used to customize the SemVer metadata (as an alternative to VersionInfoGenerator.Config.props):

• @@GitRevShort@@: the 7-character hash of the current commit (suffixed with -dirty if there's uncommited changes)
• @@GitRevLong@@: the full hash of the current commit (suffixed with -dirty if there's uncommited changes)
• @@GitBranch@@: the current git branch
• @@GitTag@@: the current git tag
• @@GitCommitsSinceTag@@: the number of commits since the last git tag
• @@VersionMetadata@: the default VersionMetadata format (git-@@GitRevShort@@)

Troubleshooting

If you encounter any issues, make sure to:

• Rebuild the project/solution then restart your IDE
• Test building through the command line using dotnet build
• Update your IDE to the latest version (requires at least Visual Studio 2019 16.9; Jetbrains Rider is untested)
• Update the dotnet runtime to the latest version

If none of the above works, open an issue.