-
Notifications
You must be signed in to change notification settings - Fork 6k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Reorganize version articles #6453
Merged
BillWagner
merged 17 commits into
dotnet:master
from
BillWagner:reorganize-version-articles
Aug 7, 2018
Merged
Changes from all commits
Commits
Show all changes
17 commits
Select commit
Hold shift + click to select a range
2ea44cf
Reorganize version topic
KathleenDollard bda6bae
update per feedback on PR #6081
BillWagner 962ed86
interim checkin
BillWagner 56f9936
Next draft
BillWagner 402f716
write uninstall
BillWagner 598c421
Add unix and linux uinstall instructions.
BillWagner 9fac058
proofread
BillWagner 7ed62e7
fix a tab error
BillWagner e49242b
update Linux uninstall instructions
BillWagner 4cd46c2
respond to feedback on Linux uninstall
BillWagner cf48068
respond to content feedback.
BillWagner f559e35
typo
BillWagner fadb4ce
branding: macOS is the official capitalization
BillWagner 6b44203
final proofread
BillWagner ebb824a
Final updates
BillWagner fb86771
respond to feedback
BillWagner 5fbfc14
revert framework cell for .NET standard 2.0
BillWagner File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
Large diffs are not rendered by default.
Oops, something went wrong.
Binary file added
BIN
+362 KB
docs/core/versions/media/remove-runtime-sdk-versions/programs-and-features.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,190 @@ | ||
| --- | ||
| title: How to remove .NET runtime and SDK | ||
| description: Instructions for removing the .NET Core Runtime and SDK components on Windows, Mac, and Linux | ||
| ms.date: 07/28/2018 | ||
| author: billwagner | ||
| ms.author: wiwagn | ||
| --- | ||
| # How to remove the .NET Core Runtime and SDK | ||
|
|
||
| Over time, as you install updated versions of the .NET Core runtime and SDK, you may want to remove outdated versions of .NET Core from your machine. Removing older versions of the runtime may change the runtime chosen to run shared framework applications, as detailed in the article on [.NET Core version selection](selection.md). | ||
|
|
||
| Starting with .NET Core 2.1, the .NET CLI has options you can use to list the versions of the SDK and runtime that are installed on your machine. Use [`dotnet --list-sdks`](../tools/dotnet.md#options) to see the list of SDKs installed on your machine. Use [`dotnet --list-runtimes`](../tools/dotnet.md#options) to see the list of runtimes installed on your machine. The following text shows typical output for Windows, macOS, or Linux: | ||
|
|
||
| # [Windows](#tab/Windows) | ||
|
|
||
| ```console | ||
| C:\> dotnet --list-sdks | ||
| 2.1.200-preview-007474 [C:\Program Files\dotnet\sdk] | ||
| 2.1.200-preview-007480 [C:\Program Files\dotnet\sdk] | ||
| 2.1.200-preview-007509 [C:\Program Files\dotnet\sdk] | ||
| 2.1.200-preview-007570 [C:\Program Files\dotnet\sdk] | ||
| 2.1.200-preview-007576 [C:\Program Files\dotnet\sdk] | ||
| 2.1.200-preview-007587 [C:\Program Files\dotnet\sdk] | ||
| 2.1.200-preview-007589 [C:\Program Files\dotnet\sdk] | ||
| 2.1.200 [C:\Program Files\dotnet\sdk] | ||
| 2.1.201 [C:\Program Files\dotnet\sdk] | ||
| 2.1.202 [C:\Program Files\dotnet\sdk] | ||
| 2.1.300-preview2-008533 [C:\Program Files\dotnet\sdk] | ||
| 2.1.300 [C:\Program Files\dotnet\sdk] | ||
| 2.1.400-preview-009063 [C:\Program Files\dotnet\sdk] | ||
| 2.1.400-preview-009088 [C:\Program Files\dotnet\sdk] | ||
| 2.1.400-preview-009171 [C:\Program Files\dotnet\sdk] | ||
|
|
||
| C:\> dotnet --list-runtimes | ||
| Microsoft.AspNetCore.All 2.1.0-preview2-final [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.All] | ||
| Microsoft.AspNetCore.All 2.1.0 [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.All] | ||
| Microsoft.AspNetCore.All 2.1.1 [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.All] | ||
| Microsoft.AspNetCore.All 2.1.2 [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.All] | ||
| Microsoft.AspNetCore.App 2.1.0-preview2-final [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.App] | ||
| Microsoft.AspNetCore.App 2.1.0 [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.App] | ||
| Microsoft.AspNetCore.App 2.1.1 [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.App] | ||
| Microsoft.AspNetCore.App 2.1.2 [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.App] | ||
| Microsoft.NETCore.App 2.0.6 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App] | ||
| Microsoft.NETCore.App 2.0.7 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App] | ||
| Microsoft.NETCore.App 2.0.9 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App] | ||
| Microsoft.NETCore.App 2.1.0-preview2-26406-04 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App] | ||
| Microsoft.NETCore.App 2.1.0 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App] | ||
| Microsoft.NETCore.App 2.1.1 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App] | ||
| Microsoft.NETCore.App 2.1.2 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App] | ||
| ``` | ||
|
|
||
| # [Linux](#tab/Linux) | ||
|
|
||
| ```console | ||
| $ dotnet --list-sdks | ||
| 1.0.1 [/usr/share/dotnet/sdk] | ||
| 1.0.4 [/usr/share/dotnet/sdk] | ||
| 2.0.0-preview1-005977 [/usr/share/dotnet/sdk] | ||
| 2.0.0-preview2-006497 [/usr/share/dotnet/sdk] | ||
| 2.0.0 [/usr/share/dotnet/sdk] | ||
| 2.1.4 [/usr/share/dotnet/sdk] | ||
| 2.1.300-preview2-008530 [/usr/share/dotnet/sdk] | ||
| 2.1.300 [/usr/share/dotnet/sdk] | ||
| 2.1.301 [/usr/share/dotnet/sdk] | ||
|
|
||
| $ dotnet --list-runtimes | ||
| Microsoft.AspNetCore.All 2.1.0-preview2-final [/usr/share/dotnet/shared/Microsoft.AspNetCore.All] | ||
| Microsoft.AspNetCore.All 2.1.0 [/usr/share/dotnet/shared/Microsoft.AspNetCore.All] | ||
| Microsoft.AspNetCore.All 2.1.1 [/usr/share/dotnet/shared/Microsoft.AspNetCore.All] | ||
| Microsoft.AspNetCore.App 2.1.0-preview2-final [/usr/share/dotnet/shared/Microsoft.AspNetCore.App] | ||
| Microsoft.AspNetCore.App 2.1.0 [/usr/share/dotnet/shared/Microsoft.AspNetCore.App] | ||
| Microsoft.AspNetCore.App 2.1.1 [/usr/share/dotnet/shared/Microsoft.AspNetCore.App] | ||
| Microsoft.NETCore.App 1.0.4 [/usr/share/dotnet/shared/Microsoft.NETCore.App] | ||
| Microsoft.NETCore.App 1.0.5 [/usr/share/dotnet/shared/Microsoft.NETCore.App] | ||
| Microsoft.NETCore.App 1.1.1 [/usr/share/dotnet/shared/Microsoft.NETCore.App] | ||
| Microsoft.NETCore.App 1.1.2 [/usr/share/dotnet/shared/Microsoft.NETCore.App] | ||
| Microsoft.NETCore.App 2.0.0-preview1-002111-00 [/usr/share/dotnet/shared/Microsoft.NETCore.App] | ||
| Microsoft.NETCore.App 2.0.0-preview2-25407-01 [/usr/share/dotnet/shared/Microsoft.NETCore.App] | ||
| Microsoft.NETCore.App 2.0.0 [/usr/share/dotnet/shared/Microsoft.NETCore.App] | ||
| Microsoft.NETCore.App 2.0.5 [/usr/share/dotnet/shared/Microsoft.NETCore.App] | ||
| Microsoft.NETCore.App 2.1.0-preview2-26406-04 [/usr/share/dotnet/shared/Microsoft.NETCore.App] | ||
| Microsoft.NETCore.App 2.1.0 [/usr/share/dotnet/shared/Microsoft.NETCore.App] | ||
| Microsoft.NETCore.App 2.1.1 [/usr/share/dotnet/shared/Microsoft.NETCore.App] | ||
| ``` | ||
|
|
||
| # [macOS](#tab/macOS) | ||
|
|
||
| ```console | ||
| $ dotnet --list-sdks | ||
| 1.0.1 [/usr/local/share/dotnet/sdk] | ||
| 1.0.4 [/usr/local/share/dotnet/sdk] | ||
| 2.0.0-preview1-005977 [/usr/local/share/dotnet/sdk] | ||
| 2.0.0-preview2-006497 [/usr/local/share/dotnet/sdk] | ||
| 2.0.0 [/usr/local/share/dotnet/sdk] | ||
| 2.1.4 [/usr/local/share/dotnet/sdk] | ||
| 2.1.300-preview2-008530 [/usr/local/share/dotnet/sdk] | ||
| 2.1.300 [/usr/local/share/dotnet/sdk] | ||
| 2.1.301 [/usr/local/share/dotnet/sdk] | ||
|
|
||
| $ dotnet --list-runtimes | ||
| Microsoft.AspNetCore.All 2.1.0-preview2-final [/usr/local/share/dotnet/shared/Microsoft.AspNetCore.All] | ||
| Microsoft.AspNetCore.All 2.1.0 [/usr/local/share/dotnet/shared/Microsoft.AspNetCore.All] | ||
| Microsoft.AspNetCore.All 2.1.1 [/usr/local/share/dotnet/shared/Microsoft.AspNetCore.All] | ||
| Microsoft.AspNetCore.App 2.1.0-preview2-final [/usr/local/share/dotnet/shared/Microsoft.AspNetCore.App] | ||
| Microsoft.AspNetCore.App 2.1.0 [/usr/local/share/dotnet/shared/Microsoft.AspNetCore.App] | ||
| Microsoft.AspNetCore.App 2.1.1 [/usr/local/share/dotnet/shared/Microsoft.AspNetCore.App] | ||
| Microsoft.NETCore.App 1.0.4 [/usr/local/share/dotnet/shared/Microsoft.NETCore.App] | ||
| Microsoft.NETCore.App 1.0.5 [/usr/local/share/dotnet/shared/Microsoft.NETCore.App] | ||
| Microsoft.NETCore.App 1.1.1 [/usr/local/share/dotnet/shared/Microsoft.NETCore.App] | ||
| Microsoft.NETCore.App 1.1.2 [/usr/local/share/dotnet/shared/Microsoft.NETCore.App] | ||
| Microsoft.NETCore.App 2.0.0-preview1-002111-00 [/usr/local/share/dotnet/shared/Microsoft.NETCore.App] | ||
| Microsoft.NETCore.App 2.0.0-preview2-25407-01 [/usr/local/share/dotnet/shared/Microsoft.NETCore.App] | ||
| Microsoft.NETCore.App 2.0.0 [/usr/local/share/dotnet/shared/Microsoft.NETCore.App] | ||
| Microsoft.NETCore.App 2.0.5 [/usr/local/share/dotnet/shared/Microsoft.NETCore.App] | ||
| Microsoft.NETCore.App 2.1.0-preview2-26406-04 [/usr/local/share/dotnet/shared/Microsoft.NETCore.App] | ||
| Microsoft.NETCore.App 2.1.0 [/usr/local/share/dotnet/shared/Microsoft.NETCore.App] | ||
| Microsoft.NETCore.App 2.1.1 [/usr/local/share/dotnet/shared/Microsoft.NETCore.App] | ||
| ``` | ||
|
|
||
| *** | ||
|
|
||
| ## Uninstalling .NET Core | ||
|
|
||
| # [Windows](#tab/Windows) | ||
|
|
||
| .NET Core uses the Windows **Add/Remove Programs** dialog to remove versions of the .NET Core runtime and SDK. The following figure shows the **Add/Remove Programs** dialog with several versions of the .NET runtime and SDK installed. | ||
|
|
||
|  | ||
|
|
||
| Select any versions you want to remove from your machine and click **Uninstall**. | ||
|
|
||
| # [Linux](#tab/Linux) | ||
|
|
||
| There are more options to uninstall .NET Core (either SDK or runtime) on Linux. The best way for you to uninstall .NET Core is to mirror the action you used to install .NET Core. The specifics depend on your chosen distribution and the installation method. | ||
|
|
||
| > [!IMPORTANT] | ||
| > For Red Hat installations, consult the [Red Hat Getting Started Guide](https://access.redhat.com/documentation/en-us/net_core/2.0/html/getting_started_guide/gs_install_dotnet#install_register_rehel) for information on installing and uninstalling .NET Core. | ||
|
|
||
| Starting with .NET Core 2.1, there is no need to uninstall the .NET Core SDK when upgrading it using a package manager. The package manager `update` or `refresh` commands will automatically remove the older version upon the successful installation of a newer version. | ||
|
|
||
| If you installed .NET Core using a package manager, you use that same package manager to uninstall .NET SDK or runtime. .NET Core installations support most popular package managers. Consult the documentation for your distribution's package manager for the precise syntax on your environment: | ||
|
|
||
| - [apt-get(8)](https://linux.die.net/man/8/apt-get) is used by Debian based systems, including Ubuntu. | ||
| - [yum(8)](https://linux.die.net/man/8/yum) is used on Fedora, CentOS, and Oracle Linux. | ||
| - [zypper(8)](https://en.opensuse.org/SDB:Zypper_manual_(plain)) is used on openSUSE and SUSE Linux Enterprise System (SLES). | ||
| - [dnf(8)](https://dnf.readthedocs.io/latest/command_ref.html) is used on Fedora. | ||
|
|
||
| In almost all cases, the command to remove a package is `remove`. | ||
|
|
||
| The package name for the .NET Core SDK installation for most package managers is `dotnet-sdk`, followed by the version number. Starting with the version 2.1.300 of the .NET Core SDK and version `2.1` of the runtime, only the major and minor version numbers are necessary: for example, the .NET Core SDK version 2.1.300 can be referenced as the package `dotnet-sdk-2.1`. Prior versions require the entire version string: for example, `dotnet-sdk-2.1.200` would be required for version 2.1.200 of the .NET Core SDK. | ||
|
|
||
| For machines that have installed only the runtime, and not the SDK, the package name is `dotnet-runtime-<version>` for the .NET Core runtime, and `aspnetcore-runtime-<version>` for the entire runtime stack. | ||
|
|
||
| .NET Core installations prior to 2.0 did not uninstall the host application when the SDK was uninstalled using the package manager. Using `apt-get`, the command is: | ||
|
|
||
| ```bash | ||
| apt-get remove dotnet-host | ||
| ``` | ||
|
|
||
| Note that there is no version attached to `dotnet-host`. | ||
|
|
||
| If you installed using a tarball, you must remove .NET Core using the manual method. | ||
|
|
||
| You remove the SDKs and runtimes separately, by removing the directory that contains that version. For example, to remove the 1.0.1 SDK and runtime, you would use the following bash commands: | ||
|
|
||
| ```bash | ||
| sudo rm -rf /usr/share/dotnet/sdk/1.0.1 | ||
| sudo rm -rf /usr/share/dotnet/shared/Microsoft.NETCore.App/1.0.1 | ||
| sudo rm -rf /usr/share/dotnet/shared/Microsoft.AspNetCore.App/1.0.1 | ||
| sudo rm -rf /usr/share/dotnet/host/fxr/1.0.1 | ||
| ``` | ||
|
|
||
| The parent directories for the SDK and runtime are listed in the output from the `dotnet --list-sdks` and `dotnet --list-runtimes` command, as shown in the earlier table. | ||
|
|
||
| # [macOS](#tab/macOS) | ||
|
|
||
| On Mac, you must remove the SDKs and runtimes separately, by removing the directory that contains that version. For example, to remove the 1.0.1 SDK and runtime, you would use the following bash commands: | ||
|
|
||
| ```bash | ||
| sudo rm -rf /usr/local/share/dotnet/sdk/1.0.1 | ||
| sudo rm -rf /usr/local/share/dotnet/shared/Microsoft.NETCore.App/1.0.1 | ||
| sudo rm -rf /usr/local/share/dotnet/shared/Microsoft.AspNetCore.App/1.0.1 | ||
| sudo rm -rf /usr/local/share/dotnet/host/fxr/1.0.1 | ||
| ``` | ||
|
|
||
| The parent directories for the SDK and runtime are listed in the output from the `dotnet --list-sdks` and `dotnet --list-runtimes` command, as shown in the earlier table. | ||
|
|
||
| Starting with .NET Core 2.1, there is no need to uninstall the .NET Core SDK when upgrading it using a package manager. The package manager `update` or `refresh` commands will automatically remove the older version upon the successful installation of a newer version. | ||
|
|
||
| --- | ||
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,21 @@ | ||
| --- | ||
| title: .NET Core version history | ||
| description: See the timeline for versions of the .NET Core runtime, .NET Core SDK, C# compiler and VB.NET compiler. | ||
| ms.date: 07/26/2018 | ||
| --- | ||
|
|
||
| # NET Core version history | ||
|
|
||
| Version numbers for .NET Core are challenging because .NET Core SDK and .NET Core Runtime release on different cadences. The different cadences mean the team was forced to do only two of the following three things: | ||
|
|
||
| 1. Release independently, specifically allowing tools, C# and VB to advance faster than the .NET Core Runtime. | ||
| 2. Maintain alignment in version numbers between .NET Core SDK and .NET Core Runtime. | ||
| 3. Use semantic versioning for both the .NET Core SDK and .NET Core Runtime. | ||
|
|
||
| 2.0.0 forced version alignment and proceeded smoothly for one release. In December 2017 .NET Core SDK had a feature release, with no corresponding release in the .NET Core Runtime. The team chose goals 1 and 3, losing alignment between the .NET Core Runtime and SDK. Several .NET Core SDK 2.1.x versions were released before .NET Core Runtime 2.1. Since the SDK is not forwards compatible, these 2.1.x SDK versions could not target .NET Core Runtime 2.1. The team responded to the considerable confusion by switching to goals 1 and 2, abandoning semantic versioning as described in [.NET Core versioning](index.md#versioning-details). | ||
|
|
||
| Because of the timing of the decision to abandon semantic versioning, there were transitional releases in the 2.1.10x and 2.1.20x version number ranges that also can't target .NET Core Runtime 2.1. | ||
|
|
||
| The first two digits of the version numbers realign with the 2.1.0 version of the .NET Core Runtime and the 2.1.300 version of the .NET Core SDK. | ||
|
|
||
| Detailed information about the versions of individual components, including framework and language compiler versions, can be found on the [.NET Core downloads page](https://www.microsoft.com/net/download/dotnet-core/current). For detailed information about previous versions, select the requested version from the [.NET Core download archives page](https://www.microsoft.com/net/download/archives). Detailed support information can be found in the article describing the official [.NET Support Policy](https://www.microsoft.com/net/Support/Policy). |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think you need to end the tab section with ---, no?