You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/core/install/windows.md
+15-15Lines changed: 15 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@ description: "Learn about which versions of .NET SDK and .NET Runtime are suppor
4
4
author: adegeo
5
5
ms.author: adegeo
6
6
ms.topic: install-set-up-deploy #Don't change
7
-
ms.date: 05/15/2024
7
+
ms.date: 10/10/2024
8
8
#customer intent: As a developer or user, I want to decide the best way to install .NET on Windows.
9
9
---
10
10
@@ -16,30 +16,30 @@ ms.date: 05/15/2024
16
16
> -[Install on macOS](macos.md)
17
17
> -[Install on Linux](linux.md)
18
18
19
-
There are many different ways to install .NET on Windows. This article helps you understand the difference between the SDK and Runtime, which runtime you should install, and the method you should use to install .NET.
19
+
This article teaches you about which versions of .NET are supported on Windows, how to install .NET, and what the difference is between the SDK and runtime.
20
20
21
-
.NET is made up of the runtime and the SDK. The runtime runs .NET apps, and the SDK is used to create apps.
21
+
Unlike .NET Framework, .NET isn't tied to your version of Windows. You can only have a single version of .NET Framework installed on Windows. But .NET is standalone and can be installed anywhere on your computer. Some apps might include their own copy of .NET.
22
22
23
-
Unlike .NET Framework, .NET isn't installed and tied to your version of Windows. You can only have a single version of .NET Framework installed on Windows. .NET can be installed anywhere on your computer and some apps might include their own copy of .NET.
23
+
By default, .NET is installed to the _Program Files\\dotnet_ directory on your computer, unless the installation method chooses a different directory.
24
24
25
-
By default, .NET is installed to the _Program Files\\dotnet_ directory on your computer, unless the install method chooses a different directory.
25
+
.NET is made up of the runtime and the SDK. The runtime runs .NET apps, and the SDK is used to create apps.
26
26
27
27
## Choose the correct runtime
28
28
29
-
There are three different runtimes for Windows, which enable different types of apps to run. The SDK includes all three runtimes. If you install a specific runtime, it might include other runtimes. The following table describes which runtime is included with a particular .NET installer:
29
+
There are three different runtimes for Windows, which enable different types of apps to run. The SDK includes all three runtimes, and an installer for a runtimemight include an additional runtime. The following table describes which runtime is included with a particular .NET installer:
30
30
31
-
|| Includes .NET Runtime | Includes .NET Desktop Runtime | Includes ASP.NET Core Runtime |
31
+
|Installer| Includes .NET Runtime | Includes .NET Desktop Runtime | Includes ASP.NET Core Runtime |
To ensure that you can run all .NET apps on Windows, install both the ASP.NET Core Runtime and the .NET Desktop Runtime. The ASP.NET Core Runtime runs any web apps, and the .NET Desktop Runtime runs any desktop app, such as a Windows Presentation Foundation (WPF) or Windows Forms (WinForms) app.
38
+
To ensure that you can run all .NET apps on Windows, install both the ASP.NET Core Runtime and the .NET Desktop Runtime. The ASP.NET Core Runtime runs web-based apps, and the .NET Desktop Runtime runs desktop apps, such as a Windows Presentation Foundation (WPF) or Windows Forms app.
39
39
40
40
## Choose how to install .NET
41
41
42
-
There are different ways to install .NET, and some products, like Visual Studio, might manage their own version of .NET. If you install .NET through software that manages its own version of .NET, you should also install the .NET runtime separately so that you can run .NET apps.
42
+
There are different ways to install .NET, and some productsmight manage their own version of .NET. If you install .NET through software that manages its own version of .NET, it might not be enabled system-wide. Make sure you understand the implications of installing .NET through other software.
43
43
44
44
If you're unsure which method you should choose after reviewing the lists in the following sections, you probably want to use the [.NET Installer](#net-installer).
45
45
@@ -203,7 +203,7 @@ The [download page](https://dotnet.microsoft.com/download/dotnet) for .NET provi
203
203
1. Find the SDK or Runtime box that contains the links for downloading .NET.
204
204
1. Under the **Installers** column, find the **Windows** row and select the link for your CPU architecture. If you're unsure, select **x64** as it's the most common.
205
205
206
-
The browser automatically downloads the MSI package.
206
+
The browser should automatically download the installer.
207
207
208
208
> [!TIP]
209
209
> The following image shows the SDK, but you can also download the Runtime.
@@ -215,15 +215,17 @@ The [download page](https://dotnet.microsoft.com/download/dotnet) for .NET provi
215
215
216
216
The Windows Installer dialog is opened.
217
217
218
-
:::image type="content" source="media/windows/msi-installer.png" alt-text="A screenshot of the .NET MSI installer app window.":::
218
+
:::image type="content" source="media/windows/msi-installer.png" alt-text="A screenshot of the .NET installer app window.":::
219
219
220
220
1. Select **Install** and follow the instructions to install .NET.
221
221
222
222
To learn how to use the .NET CLI, see [.NET CLI overview](../tools/index.md).
223
223
224
224
### Command-line options
225
225
226
-
If you want to install .NET silently, such as in a production environment or to support continuous integration, use the following Windows Installer options:
226
+
Use the `/?` parameter to display a list of options.
227
+
228
+
If you want to install .NET silently, such as in a production environment or to support continuous integration, use the following options:
227
229
228
230
-`/install`\
229
231
Installs .NET.
@@ -238,8 +240,6 @@ Suppresses any attempts to restart.
For more information, see [Standard Installer Command-Line Options](/windows/win32/msi/standard-installer-command-line-options).
242
-
243
243
> [!TIP]
244
244
> The installer returns an exit code of **0** for success and an exit code of **3010** to indicate that a restart is required. Any other value is most likely an error code.
245
245
@@ -261,7 +261,7 @@ The .NET WinGet packages are:
261
261
If you install the SDK, you don't need to install the corresponding runtime.
0 commit comments