v4.1.0

What's Changed

• Add workflow file for publishing releases to immutable action package by @Jcambass in #548
• Upgrade IA Publish by @Jcambass in #550

Bug fixes :

• Fixed Basic Validation failure checks by @HarithaVattikuti in #545
• Revise isGhes logic by @jww3 in #556

Dependency updates :

• Bump fast-xml-parser from 4.3.6 to 4.4.1 by @dependabot in #540

New Contributors

• @Jcambass made their first contribution in #548
• @jww3 made their first contribution in #556

Full Changelog: v4...v4.1.0

v4.0.1

What's Changed

Documentation changes:

• Update README.md to use latest action version by @mikes-gh in #502
• Update links to runner software by @samuel-w in #499

Dependency updates:

• Bump undici from 5.27.2 to 5.28.3 by @dependabot in #515
• Bump braces from 3.0.2 to 3.0.3 and other dependency updates by @dependabot in #533

New Contributors

• @mikes-gh made their first contribution in #502
• @samuel-w made their first contribution in #499

Full Changelog: v4...v4.0.1

v4.0.0

What's Changed

In the scope of this release, the version of the Node.js runtime was updated to 20. The majority of dependencies were updated to the latest versions. From now on, the code for the setup-dotnet will run on Node.js 20 instead of Node.js 16.

Breaking changes

• Update Node.js runtime to version 20 by @HarithaVattikuti in #484
• Sequential version install fix by @nikolai-laevskii in #433
  In setup-dotnet@v3, the dotnet executable was overwritten during each action run, sometimes leading to failures if the executable was still in use. This issue was resolved in setup-dotnet@v4 by introducing an additional install-script run that installs the LTS version of the dotnet executable and utilizes it for all subsequent dotnet installations. The actual download is performed only once per workflow by the initial install-script run. To use older versions, utilize global.json. For more details, refer to the documentation.

Non-breaking changes

• Refactor installer by @nikolai-laevskii in #432
• Allow json comments by @nikolai-laevskii in #431
• Update fast-xml-parser and dotnet installer scripts by @IvanZosimov in #437
• Update dependencies by @IvanZosimov in #440
• Bump word-wrap from 1.2.3 to 1.2.4 by @dependabot in #444
• Update installers by @nikolai-laevskii in #462
• Update semver by @dmitry-shibanov in #468

New Contributors

• @HarithaVattikuti made their first contribution in #484

Full Changelog: v3...v4.0.0

v3.2.0

What's Changed

In scope of this minor release, the ability to cache the NuGet global-packages folder was added in #303 by @nogic1008

For caching, the action uses the @toolkit/cache library under the hood, which in turn allows getting rid of configuring the @actions/cache action separately.

Such input parameters as cache and cache-dependency-path were added. The cache input is optional, and caching is turned off by default, cache-dependency-path is used to specify the path to a dependency file - packages.lock.json.

Example of use-case:

- uses: actions/setup-dotnet@v3
  with:
    dotnet-version: 6.x
    cache: true
    cache-dependency-path: subdir/packages.lock.json

More details can be found in the action's documentation.

Full Changelog: v3...v3.2.0

v3.1.0

What's Changed

This minor release includes the following new features:

• The latest patch syntax was added in #428 by @IvanZosimov

- uses: actions/setup-dotnet@v3
  with:
    dotnet-version: '7.0.2xx'

More details about the new syntax can be found here.

• The global-json-file input was updated to accept absolute paths in #396 by @othmane-kinane-nw
• Error messages were made more informative in #375 by @IvanZosimov
• Notification if the global.json was not found in the root directory was added in #344 by @teo-tsirpanis

It also contains several infrastructure changes:

• Update to latest actions/publish-action by @JamesMGreene in #348
• Update version of publish-action by @MaksimZhukov in #368
• Update action to use reusable workflows by @IvanZosimov in #358
• Update workflow badges by @IvanZosimov in #377
• Add and configure ESLint and update configuration for Prettier by @IvanZosimov in #391
• Turn on automatic update of ESLint and Prettier configuration files by @IvanZosimov in #395
• Update e2e tests and e2e test infrastructure by @IvanZosimov in #414
• Refactor and update unit-tests by @IvanZosimov in #418
• Increase amount of retries for Dotnet installation scripts tests by @nikolai-laevskii in #427

New Contributors

• @teo-tsirpanis made their first contribution in #344
• @JamesMGreene made their first contribution in #348
• @othmane-kinane-nw made their first contribution in #396
• @nikolai-laevskii made their first contribution in #427

Full Changelog: v3...v3.1.0

Fix issue with ECONNRESET and refactor authutil

In scope of this release we updated the link to the .Net Core releases index file (#337) in order to fix the ECONNRESET error. Besides, we refactored authutil.ts to get rid of xmlbuilder (#336)

Updating @action/core, adding logic for processing the DOTNET_INSTALL_DIR environment variable.

In the scope of this release such changes were made:

1. The logic for processing the DOTNET_INSTALL_DIR environment variable was added to support relative paths and paths containing ~ #332
2. The version of @actions/core was bumped to 1.10.0 #331

Enable DOTNET_INSTALL_DIR environment variable

In scope of this release the DOTNET_INSTALL_DIR environment variable was enabled to add the ability to change the installation directory for .NET SDK #329. The DOTNET_INSTALL_DIR can be helpful when access to the default installation directory, for instance, on self-hosted runners, is denied.

Example of usage:

build:
  runs-on: self-hosted
  env:
    DOTNET_INSTALL_DIR: "path/to/directory"
  steps:
    - uses: actions/setup-dotnet@v3
      with:
        dotnet-version: '3.1.x'

v3.0.0

This major release includes the following changes:

• #219 New input dotnet-quality was added in #315:

    - uses: actions/setup-dotnet@v3
      with:
        dotnet-version: '6.0.x'
        dotnet-quality: 'preview'
    - run: dotnet build <my project>

More in detail here.

• #241 The output variable dotnet-version which contains the installed by the action SDK version was added in #324:

    - uses: actions/setup-dotnet@v3
      id: cp310
      with:
        dotnet-version: '3.1.422'
    - run: echo '${{ steps.cp310.outputs.dotnet-version }}' # outputs 3.1.422

More in detail here.

• The dotnet-version syntax was updated and now it allows to specify the prerelease version without using include-prerelease input. The include-prerelease input was cut out:

    - uses: actions/setup-dotnet@v3
      with:
        dotnet-version: '5.0.0-preview.6'

More in detail here.

• #251 The problem with out of support .NET version warnings was solved in #315.

Breaking changes:

• Installation paths for Windows and Ubuntu images were changed to match the location of pre-installed SDKs. In more detail, read here.

Add support for Windows-arm

In scope of this release we add support for Windows-arm. Besides, we change getInput to getBooleanInput for include-prerelease.