To guarantee a seamless remote debugging experience for users, you need some additional dependencies to be copied to the target machine. Luckily, we do that for you and automatically deploy these dependencies alongside the built binaries from your project we deem as needed for debugging. In Windows scenarios specifically, we automatically deploy the Universal CRT library (debug only, as the release version ships with the Windows operating system) as well as VCRuntime libraries which are necessary to run and debug binaries in environments where these libraries are not available on the system.<\/p>\n
For step-by-step instructions of the various remote debug workflows, check out the following tutorials:<\/p>\n
Remote Debug a C++ Project – Visual Studio | Microsoft Docs<\/a><\/p>\n Deploy, run, and debug your Linux MSBuild C++ project in Visual Studio | Microsoft Docs<\/a><\/p>\n Tutorial: Debug a CMake project on a remote Windows machine | Microsoft Docs<\/a><\/p>\n Configure CMake debugging sessions in Visual Studio | Microsoft Docs<\/a><\/p>\n Note:<\/strong> Although with Visual Studio 2019 you can create MSBuild and CMake projects targeting Linux and Windows, CMake is encouraged for Linux development because the same project files can be used in both platforms.<\/p>\n Whether you are targeting Windows or Linux, or using MSBuild or CMake, Visual Studio offers you the flexibility to customize your deployment. We will cover some of these in the sub-sections below.<\/p>\n You can deploy and debug MSBuild projects targeting a remote Windows machine very easily in Visual Studio 2019. In the Property Pages, within the Debugging <\/strong>tab, you will need to specify Remote Command<\/strong>, Working Directory<\/strong>, Remote Server Name<\/strong> and Deployment Directory<\/strong> properties as a minimum. If you want to deploy additional files, you will have to specify them in the Additional Files to Deploy<\/strong> property.<\/p>\n Visual Studio 2019 allows you to specify both debug and release versions of the runtime libraries. To do so, you must set the Deploy Visual C++ Debug Runtime Libraries<\/strong> and Deploy Visual C++ Runtime Libraries<\/strong> properties to Yes<\/strong>.<\/p>\n Once your configuration is set, Visual Studio will take care of deploying all the files (including the ucrt and vcruntime libraries needed) to your remote machine.<\/p>\n When targeting Linux using MSBuild project, you can specify a different machine from your build machine (the default) to deploy to and debug on, as shown below:<\/p>\n By default, only the files necessary for the process to debug will be deployed to the remote debug machine. However, in some cases, you may want more control over your project’s deployment. In these cases, you can append the code MSBuild elements below to your .vcxproj file, making sure to specify the actual source and target paths you want:<\/p>\n You can also specify additional source files in your solution that you want deployed if you: right-click on the source file in solution explorer > select properties > set the Content <\/strong>property to \u201cyes\u201d.<\/p>\n Visual Studio 2019 has support for deploying CMake projects to a remote Windows machine and debugging them with the Visual Studio remote tools.<\/a> You can specify the type <\/strong>and remoteMachineName <\/strong>properties within the launch.vs.json file.<\/p>\n Visual Studio 2019 allows you to specify both debug and release versions of the runtime libraries. To do so, you must set the deployDebugRuntimeLibraries<\/strong> and deployRuntimeLibraries<\/strong> properties to true<\/strong>.<\/p>\n The contents of the project outputs will be deployed automatically to C:\\Windows Default Deploy Directory\\<targetname> in the remote machine. If you want to specify a different location, you can set it up in the deployDirectory <\/strong>property. If you do not want to deploy files at all, you can set disableDeploy <\/strong>to true<\/strong>.<\/p>\n In addition, you can specify individual additional files or entire directories you want to deploy each time in case there are some external source\/content files you want to be deployed. To do this, you add the following block to your launch.vs.json (make sure you replace example.cpp\/exampleDirectory with the actual path to your file\/directory):<\/p>\n When targeting Linux using CMake, you can specify a different machine from your build machine (the default) to deploy to and debug on. To do this, just set the remoteMachineName json filed to one of the established connections in the Connection Manager (IntelliSense will populate the list of all the available options).<\/span><\/p>\n You can also customize the deploy location on the target machine by setting the deployDirectory <\/strong>property in launch.vs.json to the intended directory.<\/span><\/p>\n In addition, if you want complete control over your deployment, you can append the following code block in your launch.vs.json file. For example:<\/span><\/p>\n Download\u00a0the latest Visual Studio 2019 Preview<\/a> today and give it a try. We\u2019d love to hear from you to help us prioritize and build the right features for you. We can be reached via the comments below,\u00a0Developer Community<\/a>, and Twitter (@VisualC<\/a>). The best way to file a bug or suggest a feature is via Developer Community.<\/p>\n Moyo Okeremi and Lisbeth Cardoso Guerra.<\/p>\n","protected":false},"excerpt":{"rendered":" Visual Studio 2019 offers remote debug support for MSBuild and CMake projects targeting Windows and Linux. Thanks to remote debugging, our customers can target a wider, more diverse range of scenarios. We offer the flexibility to customize your deployment and automatically copy any dependencies needed to the target machine.<\/p>\n","protected":false},"author":24915,"featured_media":27665,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1,266,279],"tags":[],"class_list":["post-27664","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-cplusplus","category-cmake","category-linux"],"acf":[],"blog_post_summary":" Visual Studio 2019 offers remote debug support for MSBuild and CMake projects targeting Windows and Linux. Thanks to remote debugging, our customers can target a wider, more diverse range of scenarios. We offer the flexibility to customize your deployment and automatically copy any dependencies needed to the target machine.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/posts\/27664","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\/24915"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/comments?post=27664"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/posts\/27664\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/media\/27665"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/media?parent=27664"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/categories?post=27664"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/tags?post=27664"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}User Customizability of Remote Deploy<\/h2>\n
MSBuild Projects targeting Windows<\/h3>\n
![\"The](\"https:\/\/devblogs.microsoft.com\/cppblog\/wp-content\/uploads\/sites\/9\/2021\/02\/word-image.png\")
<\/p>\nMSBuild Projects targeting Linux<\/h3>\n
![\"The](\"https:\/\/devblogs.microsoft.com\/cppblog\/wp-content\/uploads\/sites\/9\/2021\/02\/graphical-user-interface-text-application-email.png\")
<\/h3>\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
CMake Projects targeting Windows<\/h3>\n
\"configurations\": [ \r\n { \r\n \"type\": \"remoteWindows\", \r\n \"project\": \"CMakeLists.txt\", \r\n \"projectTarget\": \"CMakeProject.exe (CMakeProject\\\\CMakeProject.exe)\", \r\n \"name\": \"CMakeProject.exe (CMakeProject\\\\CMakeProject.exe)\", \r\n \"remoteMachineName\": \"[remote machine\u2019s IP address]: [remote machine\u2019s port number]\", \r\n \"deployDebugRuntimeLibraries\": true, \r\n \"deployRuntimeLibraries\": true, \r\n \"deployDirectory\": \"~\/foo\", \r\n \"disableDeploy\": true, \r\n } \r\n]<\/pre>\n\"deploy\": [ \r\n { \r\n \"sourcePath\": \"~\/example.cpp\", \r\n \"targetPath\": \"~\/test\/example.cpp\", \r\n }, \r\n { \r\n \"sourcePath\": \"~\/exampleDirectory\", \r\n \"targetPath\": \"~\/test\/exampleDirectory\", \r\n }, \r\n]<\/pre>\nCMake Projects targeting Linux<\/h3>\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>\nGive us your feedback<\/h2>\n
Authors<\/h2>\n