Skip to content
You're viewing an older version of this GitHub Action. Do you want to see the latest version instead?
rotate-cw

GitHub Action

.NET project version updater

v1.1

.NET project version updater

rotate-cw

.NET project version updater

Update or bump project versions in .csproj, .props, .nuspec, and many other .NET file types

Installation

Copy and paste the following snippet into your .yml file.

              

- name: .NET project version updater

uses: vers-one/[email protected]

Learn more about this action in vers-one/dotnet-project-version-updater

Choose a version

.NET project version updater

A GitHub action to update or bump project versions in .csproj, .cs, .prop, and .nuspec files.

Build Tests

Supports:

  • .NET / .NET Core projects (.csproj files);
  • Shared project properties (.prop files);
  • .NET Framework AssemblyInfo files (AssemblyInfo.cs);
  • Nuget package specs (.nuspec files).

Inputs

file or files (required)

Project file paths.

Can be either:

  • path to a single project file: "src/MyProject.csproj";
  • path pattern: "src/**/*.csproj";
  • comma-separated list of path patterns: "src/**/*.csproj", "src/**/*.nuspec", "!src/**/Test"

See fast-glob package documentation for more examples of supported file path patterns.

version (required)

The new version for the project file.

Can be either:

  • explicit version: e.g. 1.2.3 or 1.0.0-beta5;
  • one of the bump commands:
    • bump-major;
    • bump-minor;
    • bump-build;
    • bump-revision;
  • bump pattern: e.g. *.^.0.? where:
    • ? instructs to leave this version part unchanged;
    • * instructs to leave this version part unchanged or to set it to zero if it doesn't exist;
    • ^ instructs to bump this version part;
    • number instructs to overwrite this version part with the specified number;
    • missing part instructs to remove it from the version if it exists.

Examples:

Old version version input New version Explanation
1.2.3 2.4.6 2.4.6 Sets explicit numeric version
2.4.6 2.4.7-rc1 2.4.7-rc1 Sets explicit semantic version
1.1.1.1 bump-major 2.1.1.1 Bumps the major part, leaves other parts unchanged
1.1.1.1 bump-minor 1.2.1.1 Bumps the minor part, leaves other parts unchanged
1.1.1.1 bump-build 1.1.2.1 Bumps the build part, leaves other parts unchanged
1.1.1.1 bump-revision 1.1.1.2 Bumps the revision part, leaves other parts unchanged
1 bump-minor 1.1 Sets the missing minor part to zero and bumps it
1 bump-build 1.0.1 Sets the missing minor and build parts to zero and bumps the build part
1.2 bump-revision 1.2.0.1 Sets the missing build and revision parts to zero and bumps the revision part
1.1.1.1 ^.*.*.* 2.1.1.1 Bumps the major part, leaves other parts unchanged
1.1.1.1 *.^.*.* 1.2.1.1 Bumps the minor part, leaves other parts unchanged
1.1.1.1 *.*.^.* 1.1.2.1 Bumps the build part, leaves other parts unchanged
1.1.1.1 *.*.*.^ 1.1.1.2 Bumps the revision part, leaves other parts unchanged
1.1.45 *.^.^ 1.2.46 Bumps the minor and the build parts, leaves the major part unchanged
1.1.45 ^.0.^ 2.0.46 Bumps the major and the build parts, sets the minor part to zero
1.1.1.1 *.* 1.1 Removes the build and the revision parts, leave the major and the minor parts unchanged
1.1.7 *.^.0 1.2.0 Bumps the minor part, sets the build part to zero, and leaves the major part unchanged
1.1.7.1 *.^.0 1.2.0 Bumps the minor part, sets the build part to zero, removes the revision part, and leaves the major part unchanged
1.1.7 *.*.*.1 1.1.7.1 Sets the revision part to 1, leaves other parts unchanged
1.1.7 *.*.*.^ 1.1.7.1 Sets the missing revision part to zero and bumps it, leaves other parts unchanged
1.1 *.*.* 1.1.0 Sets the missing build part to zero, leaves the major and the minor parts unchanged
1.1 *.*.? 1.1 Leaves the major, minor, and the build parts unchanged
1.1 *.*.*.* 1.1.0.0 Sets the missing build and revision parts to zero, leaves the major and the minor parts unchanged
1.1 ?.?.?.? 1.1 Leaves all parts unchanged

Outputs

oldVersion

The version found in the project file before the update. In case of multiple project files, this will be the version found in the first project file.

Example: 1.3.5

newVersion

The version set by the action during the update. In case of multiple project files, this will be the version written into the first project file.

Example: 1.3.6

Usage

Scenario 1: Set an explicit version for a single file

name: Manual version update

on:
  workflow_dispatch:
    inputs:
      version:
        description: "New version for the project"
        required: true 
        type: string

jobs:
  update:
    runs-on: ubuntu-latest
    name: Update version
    steps:
      - name: Checkout
        uses: actions/checkout@v2

      - name: Set MyProject.csproj version
        id: update
        uses: vers-one/[email protected]
        with:
          file: "src/MyProject.csproj"
          version: ${{ github.event.inputs.version }}

      - run: |
          git config user.name "Your Name"
          git config user.email "[email protected]"
          git add .
          git commit -m "Update project version to ${{ steps.update.outputs.newVersion }}"
          git push

Scenario 2: Set an explicit version for multiple files

name: Manual version update

on:
  workflow_dispatch:
    inputs:
      version:
        description: "New version for all projects"
        required: true 
        type: string

jobs:
  update:
    runs-on: ubuntu-latest
    name: Update versions
    steps:
      - name: Checkout
        uses: actions/checkout@v2

      - name: Set project versions
        id: update
        uses: vers-one/[email protected]
        with:
          file: |
            "**/*.csproj", "**/*.nuspec", "**/AssemblyInfo.cs"
          version: ${{ github.event.inputs.version }}

      - run: |
          git config user.name "Your Name"
          git config user.email "[email protected]"
          git add .
          git commit -m "Update project versions to ${{ steps.update.outputs.newVersion }}"
          git push

Scenario 3: Bump version on push to the main branch

name: Bump build version

on:
  push:
    branches: [ main ]

jobs:
  bump:
    runs-on: ubuntu-latest
    name: Build and bump version
    steps:
      - name: Checkout
        uses: actions/checkout@v2

      - name: Install .NET 6
        uses: actions/setup-dotnet@v1
        with:
          dotnet-version: 6.0.x

      - name: Restore dependencies
        run: dotnet restore

      - name: Build
        run: dotnet build

      - name: Bump build version
        id: bump
        uses: vers-one/[email protected]
        with:
          file: "src/MyProject.csproj"
          version: bump-build

      - run: |
          git config user.name "Your Name"
          git config user.email "[email protected]"
          git add .
          git commit -m "Bump project version to ${{ steps.bump.outputs.newVersion }}"
          git push

A few notes on version numbers

  • This action searches for the following version declarations:
    • for .csproj, .prop, and .nuspec files: <Version>...</Version> (case insensitive);
    • for .cs files: [assembly: AssemblyVersion("...")] and [assembly: AssemblyFileVersion("...")].
  • If you set the new version explicitly, you can use any string as a version number (e.g. 1.2.3, 1.0.0-beta5, Vista, blah-blah, etc). However if you use one of the bump commands or a bump pattern, the existing version must by in the following format: major[.minor[.build[.revision]]].
  • Keep in mind that .NET Framework assembly versions must be in the following format: major.minor[.build[.revision]]. Any other versions formats like 1.0.0-beta5 will cause a compilation failure.