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: hub/apps/windows-app-sdk/preview-experimental-install.md
+18-14Lines changed: 18 additions & 14 deletions
Original file line number
Diff line number
Diff line change
@@ -2,21 +2,23 @@
2
2
title: Install tools for preview and experimental versions of the Windows App SDK
3
3
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).
4
4
ms.topic: article
5
-
ms.date: 08/19/2024
5
+
ms.date: 12/18/2024
6
6
keywords: windows win32, windows app development, Windows App SDK, preview, experimental
7
7
ms.localizationpriority: medium
8
8
---
9
9
10
10
# Install tools for preview and experimental channels of the Windows App SDK
11
11
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/).
13
13
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).
16
18
17
19
## Install Visual Studio
18
20
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.
20
22
21
23
> [!div class="button"]
22
24
> [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
26
28
27
29
### Required workloads and components
28
30
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:
30
34
31
-
* On the **Workloads** tab of the installation dialog, select as appropriate:
35
+
* On the **Workloads** tab:
32
36
* For Universal Windows Platform (UWP) app development, select **Universal Windows Platform development**
33
37
* 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.
34
38
* For C# app development, select **.NET Desktop Development**
35
39
* For C++ app development, select **Desktop development with C++**
36
40
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.
38
42
39
43
## Preview release
40
44
41
45
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).
42
46
43
47
### [Visual Studio 2022 version 17.1 and later](#tab/vs-2022-17-1)
44
48
45
-
The templates are available by installing a Visual Studio extension (VSIX).
49
+
The templates are installed through a Visual Studio extension (VSIX).
46
50
47
51
> [!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.
49
53
50
54
> [!div class="button"]
51
55
> [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).
55
59
56
60
### [Visual Studio 2022 version 17.0](#tab/vs-2022-17)
57
61
58
-
The templates are available by installing a Visual Studio extension (VSIX).
62
+
The templates are installed through a Visual Studio extension (VSIX).
59
63
60
64
> [!NOTE]
61
65
> 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).
68
72
69
73
### [Visual Studio 2019](#tab/vs-2019)
70
74
71
-
The templates are available by installing a Visual Studio extension (VSIX).
75
+
The templates are installed through a Visual Studio extension (VSIX).
72
76
73
77
> [!NOTE]
74
78
> 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).
81
85
82
86
---
83
87
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.
85
89
86
90
> [!NOTE]
87
91
> 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
90
94
91
95
For experimental features, install the latest extension from the experimental release channel. For more info, see [Experimental release channel](experimental-channel.md).
92
96
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:
94
98
95
99
* In Visual Studio, click **Extensions** > **Manage Extensions**, search for **Windows App SDK (Experimental)**, and install the latest extension.
96
100
* Alternatively, you can download and install the extension directly from Visual Studio Marketplace:
Copy file name to clipboardExpand all lines: hub/apps/windows-app-sdk/set-up-your-development-environment.md
+21-21Lines changed: 21 additions & 21 deletions
Original file line number
Diff line number
Diff line change
@@ -1,23 +1,25 @@
1
1
---
2
2
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.
4
4
ms.topic: how-to
5
-
ms.date: 07/15/2024
5
+
ms.date: 12/18/2024
6
6
keywords: windows win32, windows app development, Windows App SDK, stable
7
7
ms.custom:
8
8
- kr2b-contr-experiment
9
9
---
10
10
11
11
# Install tools for the Windows App SDK
12
12
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/).
14
14
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).
17
19
18
20
## Install tools with winget
19
21
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.
21
23
22
24
### For C# developers
23
25
@@ -65,14 +67,14 @@ winget install "Visual Studio Professional 2022" --override "--add Microsoft.V
65
67
66
68
## Install tools manually
67
69
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.
69
71
70
72
## Install Visual Studio
71
73
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).
73
75
74
76
> [!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).
76
78
77
79
> [!div class="button"]
78
80
> [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
82
84
83
85
### Required workloads and components
84
86
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:
88
88
89
89
#### [Visual Studio 2022 version 17.1 and later](#tab/vs-2022-17-1-a)
90
90
91
91
From within the Visual Studio Installer app:
92
92
93
-
* On the **Workloads** tab of the installation dialog box, select as appropriate:
94
-
93
+
* On the **Workloads** tab:
94
+
95
95
* For C# app development using the Windows App SDK, select **.NET Desktop Development**.
96
96
* Then in the **Installation details** pane of the installation dialog box, select **Windows App SDK C# Templates** (at the bottom of the list).
97
97
* For C++ app development using the Windows App SDK, select **Desktop development with C++**
98
98
* 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**
100
100
* Then in the **Installation details** pane of the installation dialog box for that workload, make sure **C++ (v143) Universal Windows Platform tools** is selected.
101
101
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.
103
103
104
104
#### [Other Visual Studio versions](#tab/vs-other)
105
105
106
106
From within the Visual Studio Installer app:
107
107
108
-
* On the **Workloads** tab of the installation dialog box, select as appropriate:
108
+
* On the **Workloads** tab:
109
109
110
110
* For C# app development using the Windows App SDK, select **.NET Desktop Development**.
111
111
* For C++ app development using the Windows App SDK, select **Desktop development with C++**.
112
112
* For Universal Windows Platform (UWP) app development, select **Universal Windows Platform development**.
113
113
* 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.
114
114
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.
116
116
117
117
---
118
118
@@ -122,7 +122,7 @@ The [Windows App SDK](index.md) includes Visual Studio project and item template
122
122
123
123
### [Visual Studio 2022 version 17.1 and later](#tab/vs-2022-17-1-b)
124
124
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.
126
126
127
127
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.
128
128
@@ -146,15 +146,15 @@ Download the extension directly, and install it:
146
146
### [Visual Studio 2019](#tab/vs-2019)
147
147
148
148
> [!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.
150
150
151
151
The templates are available by installing a Visual Studio extension (VSIX).
152
152
153
153
> [!NOTE]
154
154
> 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).
155
155
156
156
* 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:
0 commit comments