This commit is contained in:
Chet Husk 2023-08-22 22:01:18 -05:00
Родитель eb76988ca5
Коммит 46a7766df0
5 изменённых файлов: 20 добавлений и 9 удалений

Просмотреть файл

@ -1,6 +1,6 @@
# Commands
This article outlines the commands exposed by the .NET Install Tool for Extension Authors. To see these commands used in an extension, check out the [sample extension](https://github.com/dotnet/vscode-dotnet-runtime/tree/main/sample) in this repository. Note that the majority of these commands are not user facing, meaning they can only be called programatically using the [VSCode API](https://code.visualstudio.com/api/extension-guides/command#programmatically-executing-a-command) by other extensions.
This article outlines the commands exposed by the .NET Install Tool. To see these commands used in an extension, check out the [sample extension](https://github.com/dotnet/vscode-dotnet-runtime/tree/main/sample) in this repository. Note that the majority of these commands are not user facing, meaning they can only be called programatically using the [VSCode API](https://code.visualstudio.com/api/extension-guides/command#programmatically-executing-a-command) by other extensions.
## dotnet.acquire

Просмотреть файл

@ -14,7 +14,7 @@ Learn more about configuring Visual Studio Code settings [here](https://code.vis
## Windows 7 Failures
The .NET Install Tool for Extension Authors requires TLS 1.2 to be enabled in order to install .NET. For more information on TLS1.2, see [the documentation](https://docs.microsoft.com/mem/configmgr/core/plan-design/security/enable-tls-1-2-client).
The .NET Runtime Install Tool requires TLS 1.2 to be enabled in order to install .NET. For more information on TLS1.2, see [the documentation](https://docs.microsoft.com/mem/configmgr/core/plan-design/security/enable-tls-1-2-client).
## Manually Installing .NET
@ -37,4 +37,4 @@ If .NET installation is failing or you want to reuse an existing installation of
## Other Issues
Haven't found a solution? Check out our [open issues](https://github.com/dotnet/vscode-dotnet-runtime/issues). If you don't see your issue there, please file a new issue by evoking the `.NET Install Tool: Report an issue with the .NET Install Tool for Extension Authors` command from Visual Studio Code.
Haven't found a solution? Check out our [open issues](https://github.com/dotnet/vscode-dotnet-runtime/issues). If you don't see your issue there, please file a new issue by evoking the `.NET Install Tool: Report an issue with the .NET Runtime Install Tool` command from Visual Studio Code.

Просмотреть файл

@ -1,4 +1,4 @@
# Troubleshooting Issues with .NET Install Tool for Extension Authors
# Troubleshooting Issues with .NET SDK Install Tool
## Unable to add to PATH

Просмотреть файл

@ -4,6 +4,10 @@
This extension provides a unified way for other extensions like the [C#] and [C# Dev Kit] extensions to install local, private versions of the .NET Runtime. This extension is not intended to be used directly by users to install .NET for development purposes because it only includes the .NET Runtime and not the entire .NET SDK.
## Why do I have this extension?
This extension was probably included as a dependency of the [C#] or [C# Dev Kit] extensions (though [Unity] and [.NET MAUI] extensions might also be the cause). These extensions call into this extension to provide a unified way of downloading per-extension copies of the .NET Runtime for those extensions to use internally. If you already have an installation of .NET that you'd like to use, see [the troubleshooting section below](#i-already-have-a-net-runtime-or-sdk-installed-and-i-want-to-use-it). 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.
## Troubleshooting
### I already have a .NET Runtime or SDK installed, and I want to use it
@ -63,11 +67,13 @@ See the [.NET home repo](https://github.com/Microsoft/dotnet) to find other .NE
.NET (including this repo) is licensed under the MIT license.
## Telemetry Notice
Please note that this extension collects telemetry by default and aims to follow the [VS Code Telemetry Policy](https://code.visualstudio.com/api/extension-guides/telemetry). You may disable this telemetry in the extension settings.
[C#]: https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.csharp
[C# Dev Kit]: https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.csdevkit
[using external installations]: https://github.com/dotnet/vscode-dotnet-runtime/blob/main/Documentation/troubleshooting-runtime.md#manually-installing-net
[changing the installation timeout]: https://github.com/dotnet/vscode-dotnet-runtime/blob/main/Documentation/troubleshooting-runtime.md#install-script-timeouts
## Telemetry Notice
Please note that this extension collects telemetry by default and aims to follow the [VS Code Telemetry Policy](https://code.visualstudio.com/api/extension-guides/telemetry). You may disable this telemetry in the extension settings.
[Unity]: https://marketplace.visualstudio.com/items?itemName=VisualStudioToolsForUnity.vstuc
[.NET MAUI]: https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.dotnet-maui

Просмотреть файл

@ -2,7 +2,10 @@
[![Version](https://img.shields.io/visual-studio-marketplace/v/ms-dotnettools.vscode-dotnet-sdk?style=for-the-badge)](https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.vscode-dotnet-sdk) [![Installs](https://img.shields.io/visual-studio-marketplace/i/ms-dotnettools.vscode-dotnet-sdk?style=for-the-badge)](https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.vscode-dotnet-sdk)
This VSCode extension allows acquisition of a local copy of the .NET SDK. This can be used by other extensions, like C# DevKit, Polyglot Notebooks, and others, to ensure that a .NET SDK is available on the user's machine. This can be useful when another extension needs to make use of the .NET Toolchain to compile or run code.
This VSCode extension allows acquisition of a local copy of the .NET SDK. While originally developed and intended to be used as part of the [.NET Coding Pack], this extension can be used by other extensions like C# DevKit, Polyglot Notebooks, and others to ensure that a .NET SDK is available on the user's machine. This can be useful when another extension needs to make use of the .NET Toolchain to compile or run code.
> **Note:**
> .NET SDKs installed with this extension are unique *per-calling-extension*, and will not be installed system-wide. This means they will not be usable from outside of the VS Code editor.
## .NET Foundation
@ -17,3 +20,5 @@ See the [.NET home repo](https://github.com/Microsoft/dotnet) to find other .NE
## Telemetry Notice
Please note that this extension collects telemetry by default and aims to follow the [VS Code Telemetry Policy](https://code.visualstudio.com/api/extension-guides/telemetry). You may disable this telemetry in the extension settings.
[.NET Coding Pack]: https://learn.microsoft.com/shows/on-net/get-started-quick-with-the-net-coding-pack