Skip to content

Commit dee26c1

Browse files
dev-env-freshness-and-duplication (MicrosoftDocs#5067)
1 parent 0a9d15b commit dee26c1

File tree

2 files changed

+39
-35
lines changed

2 files changed

+39
-35
lines changed

hub/apps/windows-app-sdk/preview-experimental-install.md

Lines changed: 18 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -2,21 +2,23 @@
22
title: Install tools for preview and experimental versions of the Windows App SDK
33
description: Configure your development computer by installing the appropriate tools to develop apps for Windows by using the preview and experimental channels of the [Windows App SDK](./index.md).
44
ms.topic: article
5-
ms.date: 08/19/2024
5+
ms.date: 12/18/2024
66
keywords: windows win32, windows app development, Windows App SDK, preview, experimental
77
ms.localizationpriority: medium
88
---
99

1010
# Install tools for preview and experimental channels of the Windows App SDK
1111

12-
Configure your development computer by installing the appropriate tools to develop apps for Windows with the preview and experimental channels of the [Windows App SDK](./index.md).
12+
Configure your development computer with the tools required to build Windows apps using the [Windows App SDK](./index.md) (preview and experimental release channels) and [WinUI](/windows/apps/winui/winui3/).
1313

14-
> [!NOTE]
15-
> This topic is for the preview and experimental release channels of the Windows App SDK—see [Windows App SDK release channels](./release-channels.md). For the stable channel, there's also [Install tools for the Windows App SDK](./set-up-your-development-environment.md).
14+
Before installing any tools, see [System requirements for Windows app development](system-requirements.md).
15+
16+
> [!IMPORTANT]
17+
> This article applies only to the [preview and experimental release channels](./release-channels.md) of the Windows App SDK. For the stable release channel, see [Install tools for the Windows App SDK](./set-up-your-development-environment.md).
1618
1719
## Install Visual Studio
1820

19-
Use these links to install Visual Studio 2022 (recommended) or Visual Studio 2019. You can choose between the free Visual Studio Community edition, Visual Studio Professional, or Visual Studio Enterprise. Also see [System requirements for Windows app development](system-requirements.md).
21+
Use the following links to install Visual Studio 2022 (recommended) or Visual Studio 2019. You can choose between the free Visual Studio Community Edition, Visual Studio Professional, or Visual Studio Enterprise.
2022

2123
> [!div class="button"]
2224
> [Download Visual Studio 2022](/visualstudio/releases/2022/release-notes)
@@ -26,26 +28,28 @@ Use these links to install Visual Studio 2022 (recommended) or Visual Studio 201
2628
2729
### Required workloads and components
2830

29-
While installing Visual Studio, select these workloads and components.
31+
During Visual Studio installation, you have the option to install workloads and components (you can also open the Visual Studio Installer and select **Modify** to add workloads and components after installation). We recommend installing the following:
32+
33+
From within the Visual Studio Installer app:
3034

31-
* On the **Workloads** tab of the installation dialog, select as appropriate:
35+
* On the **Workloads** tab:
3236
* For Universal Windows Platform (UWP) app development, select **Universal Windows Platform development**
3337
* Then in the **Installation details** pane of the installation dialog for that workload, make sure either **C++ (v143) Universal Windows Platform tools** (for Visual Studio 2022) or **C++ (v142) Universal Windows Platform tools** (for Visual Studio 2019) is selected.
3438
* For C# app development, select **.NET Desktop Development**
3539
* For C++ app development, select **Desktop development with C++**
3640

37-
* On the **Individual components** tab of the installation dialog, in the **SDKs, libraries, and frameworks** section, make sure **Windows 10 SDK (10.0.19041.0)** is selected.
41+
* On the **Individual components** tab, in the **SDKs, libraries, and frameworks** section, make sure **Windows 10 SDK (10.0.19041.0)** is selected.
3842

3943
## Preview release
4044

4145
The [Windows App SDK](index.md) includes Visual Studio project and item templates for creating and developing WinUI 3 apps. For a preview of the next stable release, install the latest extension from the preview release channel. For more info, see [Preview release channel](preview-channel.md).
4246

4347
### [Visual Studio 2022 version 17.1 and later](#tab/vs-2022-17-1)
4448

45-
The templates are available by installing a Visual Studio extension (VSIX).
49+
The templates are installed through a Visual Studio extension (VSIX).
4650

4751
> [!NOTE]
48-
> If you installed **Windows App SDK C# Templates** (an installation detail of the **.NET Desktop Development** workload) and/or **Windows App SDK C++ Templates** (an installation detail of the **Desktop development with C++** workload), then run Visual Studio Installer to uninstall them before installing the VSIX.
52+
> If you installed **Windows App SDK C# Templates** (an installation detail of the **.NET Desktop Development** workload) and/or **Windows App SDK C++ Templates** (an installation detail of the **Desktop development with C++** workload), run the Visual Studio Installer to uninstall them before installing the VSIX.
4953
5054
> [!div class="button"]
5155
> [C# Visual Studio 2022 extension](https://aka.ms/windowsappsdk/1.0-preview3/extension/VS2022/csharp)
@@ -55,7 +59,7 @@ The templates are available by installing a Visual Studio extension (VSIX).
5559
5660
### [Visual Studio 2022 version 17.0](#tab/vs-2022-17)
5761

58-
The templates are available by installing a Visual Studio extension (VSIX).
62+
The templates are installed through a Visual Studio extension (VSIX).
5963

6064
> [!NOTE]
6165
> If you have a Windows App SDK Visual Studio extension (VSIX) already installed, then uninstall it before installing a new version. For directions, see [Manage extensions for Visual Studio](/visualstudio/ide/finding-and-using-visual-studio-extensions).
@@ -68,7 +72,7 @@ The templates are available by installing a Visual Studio extension (VSIX).
6872
6973
### [Visual Studio 2019](#tab/vs-2019)
7074

71-
The templates are available by installing a Visual Studio extension (VSIX).
75+
The templates are installed through a Visual Studio extension (VSIX).
7276

7377
> [!NOTE]
7478
> If you have a Windows App SDK Visual Studio extension (VSIX) already installed, then uninstall it before installing a new version. For directions, see [Manage extensions for Visual Studio](/visualstudio/ide/finding-and-using-visual-studio-extensions).
@@ -81,7 +85,7 @@ The templates are available by installing a Visual Studio extension (VSIX).
8185
8286
---
8387

84-
The extensions from the preview channel are available only from the download locations provided above. These extensions are not available via Visual Studio Marketplace or the **Manage Extensions** dialog box in Visual Studio.
88+
The extensions from the preview channel are available only from the download locations provided above. These extensions are not available through the Visual Studio Marketplace or the **Manage Extensions** dialog box in Visual Studio.
8589

8690
> [!NOTE]
8791
> If you install the C# version of the Windows App SDK 1.0 Preview 2 extension for Visual Studio 2019, and you want to use the Single-project MSIX Packaging Tools project template (see [Package your app using single-project MSIX](./single-project-msix.md)), then you must also install the [Single-project MSIX Packaging Tools extension](https://marketplace.visualstudio.com/items?itemName=ProjectReunion.MicrosoftSingleProjectMSIXPackagingTools) separately. The **Blank App, Packaged (WinUI 3 in Desktop)** project template has a known issue that results in a build error unless you also install the single-project packaging tools extension. This issue doesn't affect other versions of the Windows App SDK 1.0 Preview 2 extension.
@@ -90,7 +94,7 @@ The extensions from the preview channel are available only from the download loc
9094

9195
For experimental features, install the latest extension from the experimental release channel. For more info, see [Experimental release channel](experimental-channel.md).
9296

93-
Choose one of these options to install the latest experimental release ([Version 1.0 Experimental (1.0.0-experimental1)](release-notes-archive/experimental-channel-1.0.md#version-10-experimental-100-experimental1)):
97+
Choose one of these options to install the latest experimental release:
9498

9599
* In Visual Studio, click **Extensions** > **Manage Extensions**, search for **Windows App SDK (Experimental)**, and install the latest extension.
96100
* Alternatively, you can download and install the extension directly from Visual Studio Marketplace:

hub/apps/windows-app-sdk/set-up-your-development-environment.md

Lines changed: 21 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,25 @@
11
---
22
title: Install tools for the Windows App SDK
3-
description: Configure your development computer by installing the appropriate tools to develop apps for Windows by using the Windows App SDK.
3+
description: Configure your development computer with the tools required to build Windows apps with the Windows App SDK] and WinUI 3.
44
ms.topic: how-to
5-
ms.date: 07/15/2024
5+
ms.date: 12/18/2024
66
keywords: windows win32, windows app development, Windows App SDK, stable
77
ms.custom:
88
- kr2b-contr-experiment
99
---
1010

1111
# Install tools for the Windows App SDK
1212

13-
Configure your development computer by installing the appropriate tools to develop apps for Windows with the [Windows App SDK](./index.md) and [WinUI 3](/windows/apps/winui/winui3/).
13+
Configure your development computer with the tools required to build Windows apps using the [Windows App SDK](./index.md) (stable release channel) and [WinUI](/windows/apps/winui/winui3/).
1414

15-
> [!NOTE]
16-
> This article is for the stable release channel of the Windows App SDK. See [Windows App SDK release channels](./release-channels.md). For other channels, see [Install tools for preview and experimental channels of the Windows App SDK](./preview-experimental-install.md).
15+
Before installing any tools, see [System requirements for Windows app development](system-requirements.md).
16+
17+
> [!IMPORTANT]
18+
> This article applies only to the [stable release channel](./release-channels.md) of the Windows App SDK. For other release channels, see [Install tools for preview and experimental channels of the Windows App SDK](./preview-experimental-install.md).
1719
1820
## Install tools with winget
1921

20-
To install the required tools and workloads using the command line, enter one of the following commands in the console. This is supported only with Visual Studio 2022 and later. If you already have Visual Studio 2022 or later installed, then the command will open Visual Studio Installer with any missing workloads selected. You can then select **Modify** in the Visual Studio Installer to install the required workloads.
22+
**[Visual Studio 2022 and later]** Install the required tools and workloads using the console and one of the following commands. These commands will open Visual Studio Installer with any missing workloads selected, for which you can select **Modify** to install the required workloads.
2123

2224
### For C# developers
2325

@@ -65,14 +67,14 @@ winget install "Visual Studio Professional 2022" --override "--add Microsoft.V
6567

6668
## Install tools manually
6769

68-
To install the required tools and workloads manually, read the following sections.
70+
The following sections describe how to install the required tools and workloads manually.
6971

7072
## Install Visual Studio
7173

72-
Use these links to install Visual Studio 2022 (recommended) or Visual Studio 2019. You can choose between the free Visual Studio Community Edition, Visual Studio Professional, or Visual Studio Enterprise. Before you begin, see [System requirements for Windows app development](system-requirements.md).
74+
Use the following links to install Visual Studio 2022 (recommended) or Visual Studio 2019. You can choose between the free Visual Studio Community Edition, Visual Studio Professional, or Visual Studio Enterprise. Before installing either, see [System requirements for Windows app development](system-requirements.md).
7375

7476
> [!IMPORTANT]
75-
> Visual Studio 2019 supports only Windows App SDK 1.1 and earlier. Visual Studio 2022 is recommended for developing apps with all versions of the Windows App SDK.
77+
> Visual Studio 2022 is recommended for developing apps using any version of the Windows App SDK (Visual Studio 2019 supports Windows App SDK 1.1 and earlier).
7678
7779
> [!div class="button"]
7880
> [Download Visual Studio 2022](/visualstudio/releases/2022/release-notes)
@@ -82,37 +84,35 @@ Use these links to install Visual Studio 2022 (recommended) or Visual Studio 201
8284
8385
### Required workloads and components
8486

85-
While installing Visual Studio, you have the option to install the workloads and components you want. After installation, you can open Visual Studio Installer and select **Modify** to add workloads and components.
86-
87-
While installing, select the following workloads and components:
87+
During Visual Studio installation, you have the option to install workloads and components (you can also open the Visual Studio Installer and select **Modify** to add workloads and components after installation). We recommend installing the following:
8888

8989
#### [Visual Studio 2022 version 17.1 and later](#tab/vs-2022-17-1-a)
9090

9191
From within the Visual Studio Installer app:
9292

93-
* On the **Workloads** tab of the installation dialog box, select as appropriate:
94-
93+
* On the **Workloads** tab:
94+
9595
* For C# app development using the Windows App SDK, select **.NET Desktop Development**.
9696
* Then in the **Installation details** pane of the installation dialog box, select **Windows App SDK C# Templates** (at the bottom of the list).
9797
* For C++ app development using the Windows App SDK, select **Desktop development with C++**
9898
* Then in the **Installation details** pane of the installation dialog box, select **Windows App SDK C++ Templates** (at the bottom of the list).
99-
* For Universal Windows Platform (UWP) app development, select **Universal Windows Platform development**
99+
* For Universal Windows Platform (UWP) app development, select **Universal Windows Platform development**
100100
* Then in the **Installation details** pane of the installation dialog box for that workload, make sure **C++ (v143) Universal Windows Platform tools** is selected.
101101

102-
* On the **Individual components** tab of the installation dialog box, in the **SDKs, libraries, and frameworks** section, make sure **Windows 10 SDK (10.0.19041.0)** is selected.
102+
* On the **Individual components** tab, in the **SDKs, libraries, and frameworks** section, make sure **Windows 10 SDK (10.0.19041.0)** is selected.
103103

104104
#### [Other Visual Studio versions](#tab/vs-other)
105105

106106
From within the Visual Studio Installer app:
107107

108-
* On the **Workloads** tab of the installation dialog box, select as appropriate:
108+
* On the **Workloads** tab:
109109

110110
* For C# app development using the Windows App SDK, select **.NET Desktop Development**.
111111
* For C++ app development using the Windows App SDK, select **Desktop development with C++**.
112112
* For Universal Windows Platform (UWP) app development, select **Universal Windows Platform development**.
113113
* Then in the **Installation details** pane of the installation dialog box for that workload, make sure either **C++ (v143) Universal Windows Platform tools** (for Visual Studio 2022) or **C++ (v142) Universal Windows Platform tools** (for Visual Studio 2019) is selected.
114114

115-
* On the **Individual components** tab of the installation dialog box, in the **SDKs, libraries, and frameworks** section, make sure **Windows 10 SDK (10.0.19041.0)** is selected.
115+
* On the **Individual components** tab, in the **SDKs, libraries, and frameworks** section, make sure **Windows 10 SDK (10.0.19041.0)** is selected.
116116

117117
---
118118

@@ -122,7 +122,7 @@ The [Windows App SDK](index.md) includes Visual Studio project and item template
122122

123123
### [Visual Studio 2022 version 17.1 and later](#tab/vs-2022-17-1-b)
124124

125-
If you followed the instructions in [Required workloads and components](#required-workloads-and-components) above, then the templates are already installed.
125+
If you followed the instructions in [Required workloads and components](#required-workloads-and-components) above, the templates should already be installed.
126126

127127
Select **C#** or **C++** as the language, **Windows** as the platform, and **WinUI** as the Project type to create a new Windows App SDK project.
128128

@@ -146,15 +146,15 @@ Download the extension directly, and install it:
146146
### [Visual Studio 2019](#tab/vs-2019)
147147

148148
> [!IMPORTANT]
149-
> Visual Studio 2019 supports only Windows App SDK 1.1 and earlier. Visual Studio 2022 is recommended for developing apps with all versions of the Windows App SDK.
149+
> Visual Studio 2019 supports only Windows App SDK 1.1 and earlier. Visual Studio 2022 is recommended for developing apps with any version of the Windows App SDK.
150150
151151
The templates are available by installing a Visual Studio extension (VSIX).
152152

153153
> [!NOTE]
154154
> If you have a Windows App SDK Visual Studio extension (VSIX) already installed, then uninstall it before installing a new version. For directions, see [Manage extensions for Visual Studio](/visualstudio/ide/finding-and-using-visual-studio-extensions).
155155
156156
* You can install the latest stable release VSIX from Visual Studio. Select **Extensions** > **Manage Extensions**, search for *Windows App SDK*, and download the Windows App SDK extension. Close and reopen Visual Studio, and follow the prompts to install the extension.
157-
* Alternatively, you can download the extension directly from Visual Studio Marketplace, and install it:
157+
* Alternatively, you can download the extension directly from Visual Studio Marketplace:
158158

159159
> [!div class="button"]
160160
> [Download latest C# stable release](https://aka.ms/windowsappsdk/stable-vsix-2019-cs)

0 commit comments

Comments
 (0)