.NET Install Tool
This extension provides a unified way for other extensions like the C# and C# Dev Kit extensions to install local versions of the .NET Runtime, and machine-wide versions of the .NET SDK. Those extensions tell the .NET Install Tool when they would like a .NET SDK to be on the machine, and we install one for them if there's not already one that matches the SDK they need to run properly. In the future, this tool may support allowing users to call the API via VS Code to install .NET and pick a version of the SDK to install themselves.
Why do I have this extension?
This extension was probably included as a dependency of one of the following extensions, though this list is not exhaustive:
The above extensions call into this extension to provide a unified way of downloading shared .NET Runtimes or .NET SDKs. If you already have an installation of .NET that you'd like to use, see the troubleshooting section below. If you want to remove this extension completely, you will need to uninstall any extensions that depend on it first. If this extension is uninstalled, any .NET Runtimes installed by it will also be removed.
I already have a .NET Runtime or SDK installed, and I want to use it
Try adding the requesting extension to the
For C# Dev Kit you would use the same thing, but with the extension ID
Downloading .NET times out
It can sometimes take a while to download .NET. While the default download time is 600 seconds, if you need more time you can set the
You can read more about changing the installation timeout in our documentation.
The extension thinks you are offline with error response of 400 or 407, and you have a proxy.
This is a known issue with axios, the system we use to make web-requests. The requests we make need to be routed through the proxy. We have logic to try to detect your proxy automatically. If your proxy does not get detected by us, please try adding it here. You may want to consider temporarily switching to version 1.7.2 of the runtime extension if you are still experiencing issues as this version does not use axios. Note that proxies that require additional credentials are not yet supported.
Note: GFW / China also blocks some of our requests, which may be why our extension thinks you are offline or times out.
You can add the proxy in the extension settings like following the advice above for timeouts.
Information for repo contributors
Goals: Acquiring .NET Runtimes for extensions
Prior to the release of this extension, extension authors had no way of knowing if the .NET Runtime was installed on their target machines. Other solutions had a number of challenges:
This extension attempts to solve the above issues.
The .NET Install Tool is a .NET Foundation project.
See the .NET home repo to find other .NET-related projects.
.NET (including this repo) is licensed under the MIT license.
Please note that this extension collects telemetry by default and aims to follow the VS Code Telemetry Policy. You may disable this telemetry in the extension settings.