sdk icon indicating copy to clipboard operation
sdk copied to clipboard

NET tool roll forward error experience

Open JL03-Yue opened this issue 2 years ago • 2 comments

This pull request addresses the issue where the installation of a tool with an incompatible runtime results in failure. The proposed changes aim to provide clearer instructions for users encountering this issue and offer alternative solutions for resolution.

Changes made for error message:

  • Instructions with --allow-roll-forward flag: Included a step-by-step guide for users to install the tool with the --allow-roll-forward flag. The provided command (dotnet tool install --allow-roll-forward footool) is copy/pastable for user convenience.

  • Added guidance on installing .NET: Provided a link to download and install .NET , which is required by the tool. Users encountering compatibility issues are advised to install the required runtime using the provided link. Note that the given prompt leads to a general .NET downloading page https://aka.ms/dotnet/download/sdk/

  • Instructions with --force flag: Included instructions for users to install the tool with the --force flag and manually configure it to run. The provided command (dotnet tool install --force footool) allows users to force the installation and provides an alternative approach to resolving compatibility issues.

User experience: When installing a footool with incompatible runtime

Installation failed.

This app wasn't installed because it won't run on your machine. This can be resolved by one of the following:

1. Install with the `--allow-roll-forward` flag, using with the following command.

dotnet tool install -g --allow-roll-forward footool

2. Install .NET {version} with the following link

https://aka.ms/dotnet/download/sdk/

4. Install with `--force` and manually configure the tool to run, using with the following command.

dotnet tool install -g --force footool

Note that the global flag command prompt -g contains based on global or local tools install. Note that the provided prompt for downloading new .NET framework leads to a general .NET downloading page.

JL03-Yue avatar Jan 23 '24 22:01 JL03-Yue

/azp run

JL03-Yue avatar Mar 15 '24 22:03 JL03-Yue

Azure Pipelines successfully started running 1 pipeline(s).

azure-pipelines[bot] avatar Mar 15 '24 22:03 azure-pipelines[bot]