{"id":157,"date":"2019-03-02T21:50:16","date_gmt":"2019-03-02T21:50:16","guid":{"rendered":"http:\/\/erdalpekel.de\/?p=157"},"modified":"2019-07-14T12:08:13","modified_gmt":"2019-07-14T12:08:13","slug":"ros-development-with-visual-studio-code","status":"publish","type":"post","link":"https:\/\/erdalpekel.de\/?p=157","title":{"rendered":"ROS development with Visual Studio Code"},"content":{"rendered":"\n

In this post I am going to share my workflow and best practices for using Visual Studio Code<\/a> as a development environment for ROS<\/a>.<\/p>\n\n\n\n

Important note: you need to open the ROS work space with vs code, not only your specific package. Otherwise this guide will not work for you.<\/p>\n\n\n\n

Plugins<\/h2>\n\n\n\n

I will start by specifying the plugins I use in my environment in no particular order.<\/p>\n\n\n\n

C\/C++<\/a><\/h3>\n\n\n\n

This is the standard C\/C++ plugin for utilizing Microsoft’s IntelliSense<\/em> code completion. It requires information about the dependencies that are used in the project. Thankfully, CMake is able to provide this information because it is our build system and finds the dependencies in the first place. It provides this information by exporting a file called compile_commands.json<\/em> which the C\/C++ plugin can work with. You can also specify things like your compiler type (GNU \/ Clang) or the C++ version that the project is built against. All of this information is put in the file c_cpp_properties.json<\/em> in the .vscode<\/em> directory of your ROS workspace:<\/p>\n\n\n\n

{\n    \"configurations\": [\n        {\n            \"name\": \"Linux\",\n            \"includePath\": [\n                \"${workspaceFolder}\/**\"\n            ],\n            \"defines\": [],\n            \"compilerPath\": \"\/usr\/bin\/gcc\",\n            \"cStandard\": \"c11\",\n            \"cppStandard\": \"c++14\",\n            \"intelliSenseMode\": \"gcc-x64\",\n            \"compileCommands\": \"${workspaceFolder}\/build\/compile_commands.json\"\n        }\n    ],\n    \"version\": 4\n}<\/code><\/pre>\n\n\n\n
I will explain how the compile_commands.json<\/em> file is generated with catkin_make \/ cmake<\/em> in the tasks section below.<\/p>\n\n\n\n
CMake<\/a><\/h3>\n\n\n\n
The CMake plugin is useful for auto-completion when modifying the CMakeLists.txt<\/em> file of one of your packages. It shouldn’t be confused with the plugin ‘CMake Tools’ which automates the CMake configuration and build process within vs code. No configuration is needed for this plugin.<\/p>\n\n\n\n
ROS<\/a><\/h3>\n\n\n\n
The ROS plugin provides common ROS tasks like package creation, ROS master monitoring and most important for me .msg<\/em> and .urdf<\/em> file syntax highlighting.<\/p>\n\n\n\n
Clang-Format<\/a><\/h3>\n\n\n\n
This formatter is useful for automatically formatting C++ ROS nodes once they are saved. Clang-format needs to be installed on your Ubuntu system:<\/p>\n\n\n\n
sudo apt-get install clang-format<\/code><\/pre>\n\n\n\n
Also, go to the settings by typing ‘Ctrl + ,’ and search for ‘editor.formatOnSave’ and set it to true. Otherwise the files need to be formatted with manual commands.<\/p>\n\n\n\n
vscode-icons<\/a><\/h3>\n\n\n\n
This plugin swaps the default set of icons for visually more distinct icons so that .launch<\/em>, .xml<\/em> and .cpp<\/em> files can be distinguished from each other when using the file explorer sidebar on the left. Once it is installed press ‘Ctrl + Shift + P’ and type ‘activate icons’ to activate it.<\/p>\n\n\n\n
Visual Studio Code tasks<\/h2>\n\n\n\n
Visual Studio Code provides a powerful interface for automating frequent tasks. In order to use it in a more comfortable manner though we will set keybindings for our most common tasks: catkin_make<\/em> and running arbitrary ROS nodes or launch files. Go to File -> Preferences -> Keyboard Shortcuts and set the following keybindings:<\/p>\n\n\n\n
'Run Build Task': 'Ctrl + Shift + B'\n'Run Task': 'Ctrl + Shift + 3'<\/code><\/pre>\n\n\n\n
After that, create the the file tasks.json<\/em> in the directory .vscode<\/em> and paste the followiong example content in there:<\/p>\n\n\n\n
{\n    \"version\": \"2.0.0\",\n    \"tasks\": [\n        {\n            \"label\": \"catkin_make\",\n            \"type\": \"shell\",\n            \"command\": \"catkin_make\",\n            \"args\": [\n                \"-j4\",\n                \"-DCMAKE_BUILD_TYPE=Release\",\n                \"-DCMAKE_EXPORT_COMPILE_COMMANDS=1\",\n                \"-DCMAKE_CXX_STANDARD=14\"\n            ],\n            \"problemMatcher\": [],\n            \"group\": {\n                \"kind\": \"build\",\n                \"isDefault\": true\n            }\n        },\n        {\n            \"label\": \"panda_simulation\",\n            \"type\": \"shell\",\n            \"command\": \"roslaunch panda_simulation simulation.launch\",\n            \"problemMatcher\": [],\n            \"group\": {\n                \"kind\": \"test\",\n                \"isDefault\": true\n            }\n        }\n    ]\n}<\/code><\/pre>\n\n\n\n
The first task is for building the work space and can be executed with the previously defined shortcut ‘Ctrl + Shift + B’. The second task is an example for launching a launch file and can be executed with the shortcut ‘Ctrl + Shift + 3’ where it can be selected with the arrow keys.<\/p>\n\n\n\n