{"id":24310,"date":"2019-05-10T17:13:54","date_gmt":"2019-05-10T17:13:54","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/cppblog\/?p=24310"},"modified":"2020-01-27T16:43:38","modified_gmt":"2020-01-27T16:43:38","slug":"linux-development-with-c-in-visual-studio-2019-wsl-asan-for-linux-separation-of-build-and-debug","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/cppblog\/linux-development-with-c-in-visual-studio-2019-wsl-asan-for-linux-separation-of-build-and-debug\/","title":{"rendered":"Linux Development with C++ in Visual Studio 2019: WSL, ASan for Linux, Separation of Build and Debug"},"content":{"rendered":"

In Visual Studio 2019 you can target both Windows and Linux from the comfort of a single IDE. In Visual Studio 2019 version 16.1 Preview 3<\/a> we announced several new features specific to the Linux Workload<\/a>: native support for the Windows Subsystem for Linux (WSL)<\/a>, AddressSanitizer integration<\/a>, and the ability to separate build and debug targets. If you\u2019re just getting started with cross-platform development, I recommend trying our native support for WSL<\/a>.<\/p>\n

Native support for the Windows Subsystem for Linux (WSL)<\/h4>\n

Visual Studio now provides native support for using C++ with WSL<\/a>. WSL lets you run a lightweight Linux environment directly on Windows, including most command-line tools, utilities, and applications. In Visual Studio you no longer need to add a remote connection or configure SSH in order to build and debug on your local WSL installation. Check out our post on native support for WSL in Visual Studio<\/a> to learn more and follow a step-by-step guide on getting started.<\/p>\n

<\/p>\n

AddressSanitizer for the Linux Workload<\/h4>\n

In Visual Studio 2019 version 16.1 Preview 3 we have integrated AddressSanitizer<\/a> (ASan) into Visual Studio for Linux projects. ASan is a runtime memory error detector for C\/C++. You can enable ASan for MSBuild-based Linux projects<\/a> and CMake projects<\/a> that target a remote Linux machine or WSL. Check out our post on AddressSanitizer for the Linux Workload in Visual Studio<\/a> for more information.<\/p>\n

<\/p>\n

Separate build and debug targets for Linux projects<\/h4>\n

Update 1\/27\/2020: In Visual Studio 2019 version 16.5 and later you can leverage Visual Studio’s native support for WSL when separating your build system from your remote deploy system<\/a>.<\/strong><\/p>\n

You can now separate your remote build machine from your remote debug machine for both MSBuild-based Linux projects<\/a> and CMake projects<\/a> 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.<\/p>\n

For a MSBuild-based Linux project, you can specify a new remote debug machine in the project\u2019s Property Pages (Configuration Properties > Debugging > Remote Debug Machine). By default, this value is synchronized with your remote build machine (Configuration Properties > General > Remote Build Machine). <\/p>\n

The drop-down menu is populated with all established remote connections. To add a new remote connection<\/a>, navigate to Tools > Options > Cross Platform > Connection Manager or search for \u201cConnection Manager\u201d in the search bar at the top of your screen. You can also specify a new remote deploy directory in the project\u2019s Property Pages (Configuration Properties > General > Remote Deploy Directory).<\/p>\n

By default, only the files necessary for the process to debug will be deployed to the remote debug machine. You can view\/configure which source files will be deployed via the Solution Explorer. When you click on a source file, you will see a preview of its File Properties directly below the Solution Explorer. You can also right-click on a source file and select \u201cProperties.\u201d<\/p>\n

<\/p>\n

The \u201cContent\u201d property specifies whether the file will be deployed to the remote debug machine. You can also disable deployment entirely by navigating to Property Pages > Configuration Manager and unchecking \u201cDeploy\u201d for the desired configuration.<\/p>\n

If you want complete control over your project\u2019s deployment (e.g. some files you want to deploy are outside of your solution or you want to customize your remote deploy directory per file\/directory), then you can append the following code block(s) to your .vcxproj file:<\/p>\n

<ItemGroup>\r\n   <RemoteDeploy Include=\"__example.cpp\">\r\n<!-- This is the source Linux machine, can be empty if DeploymentType is LocalRemote -->\r\n      <SourceMachine>$(RemoteTarget)<\/SourceMachine>\r\n      <TargetMachine>$(RemoteDebuggingTarget)<\/TargetMachine>\r\n      <SourcePath>~\/example.cpp<\/SourcePath>\r\n      <TargetPath>~\/example.cpp<\/TargetPath>\r\n<!-- DeploymentType can be LocalRemote, in which case SourceMachine will be empty and SourcePath is a local file on Windows -->\r\n      <DeploymentType>RemoteRemote<\/DeploymentType>\r\n<!-- Indicates whether the deployment contains executables -->\r\n      <Executable>true<\/Executable>\r\n   <\/RemoteDeploy>\r\n<\/ItemGroup><\/pre>\n
For CMake projects that target a remote Linux machine, you can specify a new remote debug machine via launch.vs.json<\/a>. By default, the value of \u201cremoteMachineName\u201d will be synchronized with the \u201cremoteMachineName\u201d property in CMakeSettings.json<\/a>, which corresponds to your remote build machine. These properties no longer need to match, and the value of \u201cremoteMachineName\u201d in launch.vs.json will dictate the remote machine used for deploy and debug.<\/p>\n
<\/p>\n
IntelliSense will suggest all a list of all established remote connections, but you can add a new remote connection<\/a> by navigating to Tools > Options > Cross Platform > Connection Manager or searching for \u201cConnection Manager\u201d in the search bar at the top of your screen.<\/p>\n
If you want complete control over your deployment, you can append the following code block(s) to launch.vs.json:<\/p>\n
\"disableDeploy\": false,\r\n\"deployDirectory\": \"~\\foo\",\r\n\"deploy\" : [\r\n   {\r\n      \"sourceMachine\": \"127.0.0.1 (username=example1, port=22, authentication=Password)\",\r\n      \"targetMachine\": \"192.0.0.1 (username=example2, port=22, authentication=Password)\",\r\n      \"sourcePath\": \"~\/example.cpp\",\r\n      \"targetPath\": \"~\/example.cpp\",\r\n      \"executable\": \"false\"\r\n   }\r\n]<\/pre>\n
Resolved issues<\/h4>\n
The best way to report a problem or suggest a feature to the C++ team is via Developer Community<\/a>. The following feedback tickets related to C++ cross-platform development have been recently resolved in Visual Studio 2019 16.1 Preview 2 or Preview 3:<\/p>\n
No configurations when using CppProperties.json<\/a><\/p>\n
Unable to attach process of linux vm<\/a><\/p>\n
cmake linux binary deployment fails with WSL<\/a><\/p>\n
Infobar appears when open existing CMake cache fails<\/a><\/p>\n
VS2017 crashes if SSH has connection error while building remote Linux CMake project<\/a><\/p>\n
CTest timeout feature doesn’t work in test explorer<\/a><\/p>\n
CMake: Any minor change to CMakeLists.txt triggers a full cache regeneration<\/a><\/p>\n
CMake + Intellisense: Preprocessor definitions in CMakeLists do not work with quoted strings<\/a><\/p>\n
Intellisense problem for Linux Makefile project<\/a><\/p>\n
Talk to us!<\/h4>\n
Do you have feedback on our Linux tooling in Visual Studio? Pick a time to chat with the C++ cross-platform team<\/a> and share your experiences \u2013 the good and the bad \u2013 to help us prioritize and build the right features for you! We can also be reached via the comments below, email (visualcpp@microsoft.com<\/a>), and Twitter (@<\/a>VisualC<\/a>) and (@erikasweet_<\/a>).<\/p>\n","protected":false},"excerpt":{"rendered":"
In Visual Studio 2019 you can target both Windows and Linux from the comfort of a single IDE. In Visual Studio 2019 version 16.1 Preview 3 we announced several new features specific to the Linux Workload: native support for the Windows Subsystem for Linux (WSL), AddressSanitizer integration, and the ability to separate build and debug […]<\/p>\n","protected":false},"author":2953,"featured_media":24313,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[270,1,266,239,317,279,230],"tags":[],"class_list":["post-24310","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-announcement","category-cplusplus","category-cmake","category-diagnostics","category-iot","category-linux","category-new-feature"],"acf":[],"blog_post_summary":"
In Visual Studio 2019 you can target both Windows and Linux from the comfort of a single IDE. In Visual Studio 2019 version 16.1 Preview 3 we announced several new features specific to the Linux Workload: native support for the Windows Subsystem for Linux (WSL), AddressSanitizer integration, and the ability to separate build and debug […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/posts\/24310","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/users\/2953"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/comments?post=24310"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/posts\/24310\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/media\/24313"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/media?parent=24310"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/categories?post=24310"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/tags?post=24310"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}