Visual Studio Code Extension for ROS

The Visual Studio Code Extension for ROS[^1] provides support for Robot Operating System (ROS) development for ROS1 and ROS2 on Windows and Linux.

Features

• Automatic ROS environment configuration.
• Allows starting, stopping and viewing the ROS core status.
• Automatically create catkin_make or catkin build build tasks.
• Create catkin packages using catkin_create_pkg script or catkin create pkg.
• Run rosrun or roslaunch
• Resolve dependencies with rosdep shortcut
• Syntax highlighting for .msg, .urdf and other ROS files.
• Automatically add the ROS C++ include and Python import paths.
• Format C++ using the ROS clang-format style.
• Preview URDF and Xacro files.
• Debug a single ROS node (C++ or Python) by attaching to the process.
• Debug ROS nodes (C++ or Python) launched from a .launch file.

Commands

You can access the following commands from the Visual Studio Code command pallet, typically accessed by pressing ctrl + shift + p and typing the command name you'd like to use from the table below.

Tutorials and Walkthroughs

Getting Started

The VSCode ROS extension will attempt to detect and automatically configure the workspace for the appropriate ROS Distro.

The extension will automatically start when you open a catkin or colcon workspace. The build system (e.g. catkin_make or catkin build) will automatically be confirmed from the hidden files associated with each system.

Launch Debugging

The Visual Studio Code extension for ROS supports launch debugging for ROS 1 and ROS 2 nodes, written in Python and C++. The ROS node or nodes to be debugged must be placed in a ROS launch file with the extension .launch for ROS1 or ROS2 or with the extension .py for ROS2.

Automatic creation of a launch.json with ROS Launch support

.vscode/launch.json is a file which defines a debug launch configuration within VSCode.

To create a .vscode/launch.json with ROS debugging support

1. C++ or Python file is selected, vscode uses the selected file to seed the launch creation UI.
2. Click the Run and Debug tab on the left sidebar
3. Select the link to create a .vscode/launch.json file.
4. VSCode will drop down from the command pallet with a list of options, which includes 'ROS'. Select this option.
5. In the next dialog, type the name of the ROS package containing a launch file you'd like to debug.
6. Then find the launch file.

Once this is created, you can use the play button in the title bar, or the "start debugging" accelerator key, or from the command palle (CTRL-SHIFT-P), select Debug: Start Debugging.

NOTE: Other VSCode extensions may interfere with the selection list. If you do not see ROS in the first drop down list, you'll need to create a new file called .vscode/launch.json, then use the manual option described below.

Other Notes:

• Create a new ROS launch file with just the nodes you'd like to debug, and a separate ROS launch file with all other ROS nodes.
• Debugging a launch file with Gazebo or rviz is not supported as this time. Please split these out into separate launch files.
• ROS Run is not supported.
• Traditional XML launch files are supported for ROS1, and python based launch files are supported for ROS2.

Manually adding a launch file to an existing launch.json

If you have an existing launch.json file (or if there is an extension conflict as mentioned above), you can manually add a launch configuration by adding a new block like this.

{
    "version": "0.2.0",
    "configurations": [
      {
          "name": "ROS: Launch my file",
          "request": "launch",
          "target": "<full path to your launch.py or launch file>",
          "launch": ["rviz", "gz", "gzserver", "gzclient"],
          "type": "ros"
      }
    ]
}  

Be sure to include the full path to your launch file, including file extension.

ROS Launch Configuration options

The ROS Launch configuration block supports the following configuration:

Workspace and Global Settings

The ROS extension supports the following global settings, which can be overridden in the workspace.

Workspace example:

└── .vscode
    ├── launch.json
    ├── settings.json
    └── tasks.json

settings.json

{
    "ros.distro": "foxy",
    "ros.rosSetupScript": "/opt/ros/foxy/install/setup.bash",
    "ros.isolateEnvironment": "false"
}

Reporting Security Issues

Security issues and bugs should be reported privately, via email, to the Microsoft Security Response Center (MSRC) at secure@microsoft.com. You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message.

Further information, including the MSRC PGP key, can be found in the Security TechCenter.

Data and Telemetry

This extension collects usage data and sends it to Microsoft to help improve our products and services. Read our privacy statement to learn more.

This extension respects the telemetry.enableTelemetry setting, learn more about this option.

Contribution

Contributions are always welcome! Please see our contributing guide for more details!

A big Thank you! to everyone that have helped make this extension better!

• Andrew Short (@ajshort), original author
• James Giller (@JamesGiller)
• PickNikRobotics (@PickNikRobotics) for code formatting

ROS Web Tools

This extension leverages ROS Web Tools for URDF Previewing.

Russell Toris, Julius Kammerl, David Lu, Jihoon Lee, Odest Chadwicke Jenkins, Sarah Osentoski, Mitchell Wills, and Sonia Chernova. Robot Web Tools: Efficient Messaging for Cloud Robotics. In Proceedings of the IEEE/RSJ International Conference on Intelligent Robots and Systems (IROS), 2015

[^1]: ROS is a trademark of Open Robotics.