<\/i>Content outdated<\/strong><\/p> For up-to-date documentation see Linux development with C++<\/span><\/span><\/a>.<\/p>\n For an overview of the Visual Studio capabilities described in this article, see Develop C and C++ applications<\/a>.<\/div>This post was updated on December 11, 2020<\/p>\n Visual Studio 2017 introduced the Linux Development with C++ workload<\/a>. We generally recommend Visual Studio\u2019s native support for CMake<\/a> for all C++ Linux development. Visual Studio\u2019s CMake support allows you to target multiple platforms (Windows, a remote Linux system, the Windows Subsystem for Linux, embedded targets\u2026) with a single CMake project. You can learn more about CMake projects in our documentation<\/a> and on our C++ Team Blog<\/a>.<\/p>\n This post describes how to use Visual Studio\u2019s MSBuild-based support to build and debug on a remote Linux system with Visual Studio 2019. If you are looking to target both Windows and Linux with the same project, our recommendation is to use CMake.<\/p>\n In this post, you will learn:<\/p>\n If you are new to using Visual Studio for C++ development, a great starting point is our guide to Getting Started with Visual Studio<\/a>.<\/p>\n Visual Studio 2017 and 2019 include the C\/C++ Linux Development workload. To install it, start the Visual Studio installer and choose to either install or modify an existing installation. Scroll to the bottom. Under the section \u201cOther Toolsets\u201d you will find Linux Development with C++. The workload installs in under 10 minutes. Learn more about installing the Linux development with C++ workload in our documentation<\/a>.<\/p>\n You will need a Linux machine, or you can use the Windows Subsystem for Linux<\/a>.<\/u> You can use any Linux distribution that has SSH, gdb, rsync, zip, and a compiler (clang or GCC) installed. In a Debian-based Linux environment, this is as easy as:<\/p>\n Start SSH with the following command:<\/p>\n Learn more about options for creating a Linux environment in our documentation<\/a>.<\/p>\n To create a new MSBuild-based Linux Console Application in Visual Studio, filter the language to C++, the platform to Linux, and select \u201cConsole Application\u201d.<\/p>\n This project will open a readme with some instructions about its capabilities. We will first select the project\u2019s platform toolset. Right-click on the project in the Solution Explorer<\/strong> and select Properties<\/strong>.<\/p>\n Now we can add a new remote connection to the Connection Manager. Select Tools > Options > Cross Platform > Connection Manager<\/strong> to open the Connection Manager. You can add new connections with either password or private key authentication. Learn more about connecting to a remote Linux system in our documentation<\/a>.<\/p>\n After you enter your information, Visual Studio manages the connection to your Linux system where builds are performed. \u00a0If there are any problems, the build output points you directly to issues found in your code.<\/p>\n The project system synchronizes your sources between Windows and Linux, and provides you with extensive control to manage this yourself if you need it. Right click on the project in Solution Explorer <\/strong>and choose Properties<\/strong>.<\/p>\n Learn more about configuring a MSBuild-based Linux project in our documentation<\/a>.<\/p>\n IntelliSense is provided out of the box for GCC, Clang, and libstdc++. Visual Studio automatically copies the headers referenced by your project<\/a> from your Linux system to Windows to provide IntelliSense. Once you get going with your own code you can really see Visual Studio\u2019s productivity features in action.<\/p>\n Member List<\/strong> and Quick Info<\/strong>, shown in the screenshot below, are just two examples of the powerful IntelliSense features that make writing code easier and faster. Member List<\/strong> shows you a list of valid members from a type or namespace. Typing in \u201c->\u201d following an object instance in the C++ code will display a list of members, and you can insert the selected member into your code by pressing TAB or by typing a space or a period. Quick Info<\/strong> displays the complete declaration for any identifier in your code. In the screenshot below, Visual Studio is showing the list of accessible members of the SimpleServer object and the declaration of the open<\/em> method.<\/p>\n Refactoring, autocomplete, squiggles, reference highlighting, syntax colorization, and code snippets are some of the other useful productivity features that are helpful when you are writing and editing your code.<\/p>\n Navigating in large codebases and jumping between multiple code files can be a tiring task. Visual Studio offers many great code navigation features, including Go To Definition<\/strong>, Go To Line\/Symbols\/Members\/Types<\/strong>, Find All References<\/strong>, View<\/strong> Call Hierarchy<\/strong>, Object Browser<\/strong>, and many more.<\/p>\n The Peek Definition<\/strong> feature, as shown in the screenshot below, shows the definition inline without switching away from the code that you’re currently editing. You can find Peek Definition<\/strong> by placing the insertion point on a method that you want to explore and then right-clicking or pressing Alt+F12. In the screenshot below, the definition of the OpenCV face detection detectMultiScale <\/em>method, in objdetect.hpp<\/em>, is shown in an embedded window in the current .cpp file.<\/p>\n Our Linux support also integrates native Linux tooling like AddressSanitizer. Learn more about enabling ASAN in our documentation<\/a>.<\/p>\n Visual Studio excels at helping you solve your development problems, and you can now use those capabilities with your C++ code on Linux. You can set breakpoints in your C++ code and press F5 to launch the debugger and run your code on your Linux machine. When a breakpoint is hit, you can watch the value of variables and complex expressions in the Autos<\/strong> and Watch<\/strong> tool windows as well as in the data tips on mouse hovering, view the call stack in the Call Stack<\/strong> window, and step in and step out of your code easily. You can also use conditions in your breakpoints to narrow in on specific problems. Likewise, you can set actions to record variable values to the output window. You can also inspect application threads or view disassembly.<\/p>\n If you need to interact with your programs on Linux you can use the Linux Console window from within Visual Studio<\/a>. To activate this window, use the menu Debug<\/strong> > Linux Console<\/strong>. In the screenshot below you can see input being provided to the scanf call on line 24.<\/p>\n You can even attach to processes on your Linux machines to debug problems live. Open the Debug<\/strong> menu and select Attach to Process<\/strong>. As shown in the screenshot below select the SSH Connection type. You can then use the drop-down target menu to select a Linux machine. This will then enumerate the remote connections you have previously created.<\/p>\n See our debugging and diagnostics with C++ page<\/a> to learn more about our general capabilities.<\/p>\n Learn more about cross-platform CMake projects<\/a> and MSBuild-based Linux projects<\/a> in our documentation. Please provide feedback from within Visual Studio by selecting the \u201cSend Feedback\u201d icon in the top right-hand corner of the IDE.<\/p>\n","protected":false},"excerpt":{"rendered":" This post was updated on December 11, 2020 Visual Studio 2017 introduced the Linux Development with C++ workload. We generally recommend Visual Studio\u2019s native support for CMake for all C++ Linux development. Visual Studio\u2019s CMake support allows you to target multiple platforms (Windows, a remote Linux system, the Windows Subsystem for Linux, embedded targets\u2026) with […]<\/p>\n","protected":false},"author":2953,"featured_media":27256,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1,279],"tags":[],"class_list":["post-14225","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-cplusplus","category-linux"],"acf":[],"blog_post_summary":" This post was updated on December 11, 2020 Visual Studio 2017 introduced the Linux Development with C++ workload. We generally recommend Visual Studio\u2019s native support for CMake for all C++ Linux development. Visual Studio\u2019s CMake support allows you to target multiple platforms (Windows, a remote Linux system, the Windows Subsystem for Linux, embedded targets\u2026) with […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/posts\/14225","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=14225"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/posts\/14225\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/media\/27256"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/media?parent=14225"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/categories?post=14225"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/tags?post=14225"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}\n
Install Workload for Linux development with C++<\/h2>\n
![\"Linux](\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/9\/2019\/02\/LinuxWorkload.png\")
<\/a><\/p>\nOpening projects<\/h2>\n
sudo apt update\r\nsudo apt install -y build-essential gdb rsync zip openssh-server<\/pre>\n
sudo service start ssh<\/pre>\n
![\"Image](\"https:\/\/devblogs.microsoft.com\/cppblog\/wp-content\/uploads\/sites\/9\/2017\/04\/Linux_NPD.png\")
<\/a><\/p>\n![\"Visual](\"https:\/\/devblogs.microsoft.com\/cppblog\/wp-content\/uploads\/sites\/9\/2017\/04\/Linux_Toolset.png\")
<\/a>There are four platform toolsets to choose from: GCC for Remote Linux, Clang for Remote Linux, GCC for Windows Subsystem for Linux, and Clang for Windows Subsystem for Linux. Select the toolset that matches your compilers and Linux environment and press OK. The \u201cRemote Linux\u201d toolsets require a SSH connection in the Connection Manager. The \u201cWindows Subsystem for Linux\u201d toolsets use Visual Studio\u2019s native support for WSL<\/a> and do not require SSH. In this tutorial, I\u2019ll use the GCC for Remote Linux toolset. Check out this tutorial<\/a> for more information on our native support for WSL.<\/p>\n![\"The](\"https:\/\/devblogs.microsoft.com\/cppblog\/wp-content\/uploads\/sites\/9\/2017\/04\/Linux_AddNewConnection.png\")
<\/a><\/p>\n\n
![\"C++](\"https:\/\/devblogs.microsoft.com\/cppblog\/wp-content\/uploads\/sites\/9\/2017\/04\/Linux_Linker.png\")
<\/a><\/p>\nUse the full power of Visual Studio productivity features with your Linux C++ code<\/h2>\n
![\"Linux](\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/9\/2019\/02\/LinuxCodeEditing.png\")
<\/a><\/p>\n![\"Linux](\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/9\/2019\/02\/LinuxPeekDefinition.png\")
<\/a><\/p>\nDebugging and diagnosing issues<\/h2>\n
![\"Linux](\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/9\/2019\/02\/LinuxConsoleWindow.png\")
<\/a><\/p>\n![\"Linux](\"https:\/\/devblogs.microsoft.com\/wp-content\/uploads\/sites\/9\/2019\/02\/LinuxAttachToProcess.png\")
<\/a><\/p>\nGet started with Visual Studio Linux C\/C++ Development today<\/h2>\n