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/build-insights/reference/vcperf-commands.md
+5-4Lines changed: 5 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,16 +8,17 @@ helpviewer_keywords: ["C++ Build Insights", "throughput analysis", "build time a
8
8
9
9
::: moniker range="<=msvc-150"
10
10
11
-
The C++ Build Insights tools are available in Visual Studio 2019. To see the documentation for that version, set the Visual Studio **Version** selector control for this article to Visual Studio 2019. It's found at the top of the table of contents on this page.
11
+
The C++ Build Insights tools are available starting in Visual Studio 2019 and later. To see the documentation for that version, set the Visual Studio **Version** selector control for this article to Visual Studio 2019 or later. It's found at the top of the table of contents on this page.
12
12
13
13
::: moniker-end
14
-
::: moniker range="msvc-160"
14
+
::: moniker range=">=msvc-160"
15
15
16
-
This article lists and describes the commands available in *vcperf.exe*, and how to use them.
16
+
This article lists and describes the commands available in *`vcperf.exe`*, and how to use them.
17
17
18
18
## Commands to start and stop traces
19
19
20
-
*IMPORTANT: the following commands all require administrative privileges.*
20
+
> [!IMPORTANT]
21
+
> The following commands all require administrative privileges.
Copy file name to clipboardExpand all lines: docs/build-insights/tutorials/vcperf-and-wpa.md
+7-6Lines changed: 7 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,18 +8,18 @@ helpviewer_keywords: ["C++ Build Insights", "throughput analysis", "build time a
8
8
9
9
::: moniker range="<=msvc-150"
10
10
11
-
The C++ Build Insights tools are available in Visual Studio 2019. To see the documentation for this version, set the Visual Studio **Version** selector control for this article to Visual Studio 2019. It's found at the top of the table of contents on this page.
11
+
The C++ Build Insights tools are available in Visual Studio 2019 and later. To see the documentation for this version, set the Visual Studio **Version** selector control for this article to Visual Studio 2019 or later. It's found at the top of the table of contents on this page.
12
12
13
13
::: moniker-end
14
-
::: moniker range="msvc-160"
14
+
::: moniker range=">=msvc-160"
15
15
16
-
In this tutorial, you'll learn how to use *vcperf.exe* to collect a trace of your C++ build. You'll also learn how to view this trace in Windows Performance Analyzer.
16
+
In this tutorial, you'll learn how to use *`vcperf.exe`* to collect a trace of your C++ build. You'll also learn how to view this trace in Windows Performance Analyzer.
17
17
18
18
## Step 1: Install and configure Windows Performance Analyzer
19
19
20
20
WPA is a trace viewer available in the Windows Assessment and Deployment Kit (ADK). It's a separate utility that's not part of the components you can install with the Visual Studio installer.
21
21
22
-
A version of WPA that supports C++ Build Insights is currently only available in the most recent versions of the Windows ADK, 10.1.19041.0 or later.
22
+
A version of WPA that supports C++ Build Insights is only available in versions of the Windows ADK numbered 10.1.19041.0 or later.
23
23
24
24
### To download and install WPA
25
25
@@ -42,10 +42,11 @@ Viewing C++ Build Insights traces in WPA requires a special add-in. Follow these
1. Copy the `perf_msvcbuildinsights.dll` file into your WPA installation directory.
45
-
1. In Visual Studio 2019 version 16.6 and above, this file is located here: `C:\Program Files (x86)\Microsoft Visual Studio\2019\{Edition}\VC\Tools\MSVC\{Version}\bin\Host{Architecture}\{Architecture}`.
45
+
1. In Visual Studio 2019 version 16.6 and above, this file is located here: `C:\Program Files (x86)\Microsoft Visual Studio\{Year}\{Edition}\VC\Tools\MSVC\{Version}\bin\Host{Architecture}\{Architecture}`.
46
46
1. In the C++ Build Insights NuGet package, this file is located here: `wpa\{Architecture}`.
47
47
1. In the paths above, replace the variables surrounded by curly brackets as follows:
48
-
1.`{Edition}` is your Visual Studio 2019 edition such as Community, Professional, or Enterprise.
48
+
1.`{Year}` is your Visual Studio product year, such as 2019 or 2022.
49
+
1.`{Edition}` is your Visual Studio edition such as Community, Professional, or Enterprise.
49
50
1.`{Version}` is your MSVC version. Choose the highest one available.
50
51
1.`{Architecture}`: choose `x64` if you have a 64-bit version of Windows. Otherwise, choose `x86`.
51
52
1. The WPA installation directory is typically: `C:\Program Files (x86)\Windows Kits\10\Windows Performance Toolkit`.
Copy file name to clipboardExpand all lines: docs/build/clang-support-cmake.md
+18-8Lines changed: 18 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -9,23 +9,33 @@ helpviewer_keywords: ["Clang support for C++ CMake projects"]
9
9
10
10
::: moniker range="<=msvc-150"
11
11
12
-
Clang support is available in Visual Studio 2019.
12
+
Clang support is available starting in Visual Studio 2019.
13
13
14
14
::: moniker-end
15
-
16
-
::: moniker range="msvc-160"
15
+
::: moniker range=">=msvc-160"
17
16
18
17
You can use Visual Studio with Clang to edit and debug C++ CMake projects that target Windows or Linux.
19
18
20
-
**Windows**: Visual Studio 2019 version 16.1 includes support for editing, building, and debugging with Clang/LLVM in CMake projects targeting Windows.
19
+
**Windows**: Starting in Visual Studio 2019 version 16.1, Visual Studio includes support for editing, building, and debugging with Clang/LLVM in CMake projects targeting Windows.
21
20
22
21
**Linux**: For Linux CMake projects, no special Visual Studio support is required. You can install Clang using your distro's package manager, and add the appropriate commands in the CMakeLists.txt file.
23
22
24
23
## Install
25
24
26
-
For best IDE support in Visual Studio, we recommend using the latest Clang compiler tools for Windows. If you don't already have those, you can install them by opening the Visual Studio Installer and choosing **C++ Clang compiler for Windows** under **Desktop development with C++** optional components. When using a custom Clang installation, check the **C++ Clang-cl for v142 build tools** component.
25
+
::: moniker-end
26
+
::: moniker range="msvc-160"
27
+
28
+
For the best IDE support in Visual Studio, we recommend using the latest Clang compiler tools for Windows. If you don't already have those, you can install them by opening the Visual Studio Installer and choosing **C++ Clang compiler for Windows** under **Desktop development with C++** optional components. When using a custom Clang installation, check the **C++ Clang-cl for v142 build tools** component.
29
+
30
+
::: moniker-end
31
+
::: moniker range="msvc-170"
32
+
33
+
For the best IDE support in Visual Studio, we recommend using the latest Clang compiler tools for Windows. If you don't already have those, you can install them by opening the Visual Studio Installer and choosing **C++ Clang compiler for Windows** under **Desktop development with C++** optional components. When using a custom Clang installation, check the **C++ Clang-cl for v143 build tools** component.

29
39
30
40
## Create a new configuration
31
41
@@ -35,11 +45,11 @@ To add a new Clang configuration to a CMake project:
35
45
36
46
1. Under **Configurations**, press the **Add Configuration** button:

39
49
40
50
1. Choose the desired Clang configuration (note that separate Clang configurations are provided for Windows and Linux), then press **Select**:

43
53
44
54
1. To make modifications to this configuration, use the **CMake Settings Editor**. For more information, see [Customize CMake build settings in Visual Studio](customize-cmake-settings.md).
Copy file name to clipboardExpand all lines: docs/linux/create-a-new-linux-project.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -36,7 +36,7 @@ To create a new Linux project in Visual Studio 2017, follow these steps:
36
36
37
37
::: moniker-end
38
38
39
-
::: moniker range="msvc-160"
39
+
::: moniker range=">=msvc-160"
40
40
41
41
First, make sure you have the **Linux Development Workload** for Visual Studio installed. For more information, see [Download, install, and set up the Linux workload](download-install-and-setup-the-linux-development-workload.md).
42
42
@@ -46,7 +46,7 @@ If you have an existing Windows Visual Studio solution that you would like to ex
46
46
47
47
## Create a new Linux project
48
48
49
-
To create a new Linux project in Visual Studio 2019, follow these steps:
49
+
To create a new Linux project in Visual Studio, follow these steps:
50
50
51
51
1. Select **File > New Project** in Visual Studio, or press **Ctrl + Shift + N**. The Create a new project dialog appears.
52
52
1. In the **Search for templates** textbox, enter **Linux** to list the available templates for Linux projects.
Copy file name to clipboardExpand all lines: docs/linux/deploy-run-and-debug-your-linux-project.md
+7-7Lines changed: 7 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,9 +13,9 @@ Linux support is available in Visual Studio 2017 and later. To see the documenta
13
13
14
14
Once you've created a MSBuild-based Linux C++ project in Visual Studio and you've connected to the project using the [Linux Connection Manager](connect-to-your-remote-linux-computer.md), you can run and debug the project. You compile, execute, and debug the code on the remote target.
15
15
16
-
::: moniker range="msvc-160"
16
+
::: moniker range=">=msvc-160"
17
17
18
-
**Visual Studio 2019 version 16.1** You can target different Linux systems for debugging and building. For example, you can cross-compile on x64 and deploy to an ARM device when targeting IoT scenarios. For more information, see [Specify different machines for building and debugging](#separate_build_debug) later in this article.
18
+
**Visual Studio 2019 version 16.1**and later: You can target different Linux systems for debugging and building. For example, you can cross-compile on x64 and deploy to an ARM device when targeting IoT scenarios. For more information, see [Specify different machines for building and debugging](#separate_build_debug) later in this article.
19
19
20
20
::: moniker-end
21
21
@@ -29,19 +29,19 @@ There are several ways to interact with and debug your Linux project.
29
29
30
30
1. Select debugging mode in the **Debugging** property page.
31
31
32
-
::: moniker range="msvc-160"
32
+
::: moniker range=">=msvc-160"
33
33
34
34
GDB is used to debug applications running on Linux. When debugging on a remote system (not WSL) GDB can run in two different modes, which can be selected from the **Debugging Mode** option in the project's **Debugging** property page:
35
35
36
-

36
+

37
37
38
38
::: moniker-end
39
39
40
40
::: moniker range="msvc-150"
41
41
42
42
GDB is used to debug applications running on Linux. GDB can run in two different modes, which can be selected from the **Debugging Mode** option in the project's **Debugging** property page:
43
43
44
-

44
+

The **AttachOptionsForConnection** has most of the attributes you might need. The example above shows how to specify a location to search for additional .so libraries. The child element **ServerOptions** enables attaching to the remote process with gdbserver instead. To do that, you need to specify a local gdb client (the one shipped in Visual Studio 2017 is shown above) and a local copy of the binary with symbols. The **SetupCommands** element enables you to pass commands directly to gdb. You can find all the options available in the [LaunchOptions.xsd schema](https://github.com/Microsoft/MIEngine/blob/master/src/MICore/LaunchOptions.xsd) on GitHub.
120
120
121
-
::: moniker range="msvc-160"
121
+
::: moniker range=">=msvc-160"
122
122
123
123
## <aname="separate_build_debug"></a> Specify different machines for building and debugging in MSBuild-based Linux projects
124
124
125
-
In Visual Studio 2019 version 16.1, you can separate your remote build machine from your remote debug machine for both MSBuild-based Linux projects and CMake projects that target a remote Linux machine. For example, you can now cross-compile on x64 and deploy to an ARM device when targeting IoT scenarios.
125
+
You can separate your remote build machine from your remote debug machine for both MSBuild-based Linux projects and CMake projects that target a remote Linux machine. For example, you can now cross-compile on x64 and deploy to an ARM device when targeting IoT scenarios.
126
126
127
127
By default, the remote debug machine is the same as the remote build machine (**Configuration Properties** > **General** > **Remote Build Machine**). To specify a new remote debug machine, right-click on the project in **Solution Explorer** and go to **Configuration Properties** > **Debugging** > **Remote Debug Machine**.
Copy file name to clipboardExpand all lines: docs/overview/overview-of-cpp-development.md
+7-7Lines changed: 7 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -20,15 +20,15 @@ Visual Studio provides support for any project system or custom build tools that
20
20
21
21
-**MSBuild** is the native project system for Visual Studio. When you select **File** > **New** > **Project** from the main menu, you see many kinds of MSBuild *project templates* that get you started quickly developing different kinds of C++ applications.
22
22
23
-
::: moniker range="msvc-160"
23
+
::: moniker range=">=msvc-160"
24
24
25
-

25
+

26
26
27
27
::: moniker-end
28
28
29
29
::: moniker range="<=msvc-150"
30
30
31
-

31
+

32
32
33
33
::: moniker-end
34
34
@@ -42,23 +42,23 @@ Visual Studio provides support for any project system or custom build tools that
42
42
43
43
Source control enables you to coordinate work among multiple developers, isolate in-progress work from production code, and backup your source code. Visual Studio supports Git and [Team Foundation Version Control \(TFVC\)](/azure/devops/repos/tfvc/) through its **Team Explorer** window.
44
44
45
-
::: moniker range="msvc-160"
45
+
::: moniker range=">=msvc-160"
46
46
47
-

47
+

48
48
49
49
::: moniker-end
50
50
51
51
::: moniker range="<=msvc-150"
52
52
53
-

53
+

54
54
55
55
::: moniker-end
56
56
57
57
For more information about Git integration with repos in Azure, see [Share your code with Visual Studio 2017 and Azure Repos Git](/azure/devops/repos/git/share-your-code-in-git-vs-2017). For information about Git integration with GitHub, see [GitHub Extension for Visual Studio](https://visualstudio.github.com/).
58
58
59
59
## Obtain libraries
60
60
61
-
Use the [vcpkg](https://vcpkg.io/) package manager to obtain and install third-party libraries. Over 900 open-source libraries are currently available in the catalog.
61
+
Use the [vcpkg](https://vcpkg.io/) package manager to obtain and install third-party libraries. Over 1700 open-source library packages are currently available in the catalog.
0 commit comments