🚀 dotnet-install v0.3.0

This release adds global.json-based SDK installation support, improves the GitHub Action experience, and strengthens validation, test coverage, and documentation across the project.

✨ Highlights

• Added --jsonfile support to install the SDK version pinned in global.json
• Added support for compatible sdk.rollForward behaviors by mapping them to the closest supported wildcard selector
• Added global-json-file input to the GitHub Action for installing the SDK version defined in global.json
• Improved GitHub Action validation so version and global-json-file cannot be combined
• Expanded docs and examples for global.json, compatibility switches, and action usage

🔧 Improvements

• Updated install planning to resolve SDK version selection from global.json
• Added validation to prevent --jsonfile from being used with runtime-only installs or --quality
• Improved GitHub Action install scripts to resolve and validate global.json paths from the workspace
• Reworked action script test infrastructure to use TcpListener for better reliability and portability
• Updated System.CommandLine from 2.0.5 to 2.0.8

📝 Full Changelog

Full Changelog: v0.2.0...v0.3.0

🚀 dotnet-install v0.2.0

This release adds upgrade and self-update workflows, expands platform support with new musl Linux and macOS x64 binaries, and improves the overall CLI and GitHub Action experience.

✨ Highlights

• Added upgrade command to install the requested SDK/runtime version and remove obsolete versions in the same channel
• Added self-update command to update the dotnet-install executable directly from GitHub releases
• Added new release binaries for:
  • linux-musl-x64
  • linux-musl-arm64
  • osx-x64
• Improved GitHub Action runtime detection for musl-based Linux environments such as Alpine
• Refreshed documentation with clearer getting-started guidance and more examples

🔧 Improvements

• Expanded CLI command surface and validation for upgrade and self-update scenarios
• Improved release publishing workflow to produce and upload additional platform artifacts
• Refined runtime identifier handling to better align with the host runtime
• Added tests covering:
  • upgrade planning
  • self-update behavior
  • macOS x64 asset selection
  • Linux musl asset selection
  • removal/orchestration flows

📦 Assets

This release includes binaries for:

• Linux x64
• Linux ARM64
• Linux musl x64
• Linux musl ARM64
• macOS x64
• macOS ARM64
• Windows x64
• Windows ARM64

Each binary also includes a corresponding .sha256 checksum file.

📝 Full Changelog

Full Changelog: 0.1.0...v0.2.0

0.1.0

Initial stable release of dotnet-install, a managed implementation of the dotnet-install scripts.

Included

• Native single-file binaries for win-x64, win-arm64, linux-x64, linux-arm64, and osx-arm64
• NuGet global tool package: spark.dotnet-install
• First-party GitHub Action for installing SDKs from this repository’s release binaries

Highlights

• Install SDKs and runtimes by channel, exact version, or selectors such as 10.0.x
• Download, extract, and verify archives
• Update process PATH, with optional user PATH persistence on Windows
• Remove installed SDK/runtime folders and related assets under the install root
• GitHub Action support for installing multiple SDK versions in one step

Notes

• --dry-run stops after plan generation
• Local action usage (uses: ./) resolves the latest published release binary for validation flows