The Visual Studio Code Extension for ROS provides support for Robot Operating System (ROS) development. Providing an easier and more stream-lined developer experience.
The extension will automatically start when you open a catkin workspace. The build system (e.g. catkin_make or catkin build) will automatically be confirmed from the hidden files associated with each system. The ROS distro will automatically be confirmed from the parent environment, or you will be prompted to select a ROS distro if this can't be done automatically.
You must build the catkin workspace at least once before the extension will recognise it.
To start ROS core, use the "ROS: Start Core" command. The "ROS Core" indicator in the bottom left will show if the core is currently running, and you can click on this to view parameters etc.
The first time you open the workspace the extension will automatically create build and test tasks and update the C++ and Python paths. You can re-run this process later using the appropriate commands.
- Automatic ROS environment configuration.
- Allows starting, stopping and viewing the ROS core status.
- Automatically discover
catkin_makeorcatkin buildbuild tasks. - Create catkin packages using
catkin_create_pkgscript orcatkin create pkg. - Run
rosrunorroslaunch(breakpoints currently not supported). - Syntax highlighting for
.msg,.urdfand other ROS files. - Automatically add the ROS C++ include and Python import paths.
- Format C++ using the ROS
clang-formatstyle. - 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
.launchfile.
| Name | Command | Description |
|---|---|---|
| Create Catkin Package | ros.createCatkinPackage |
Create a catkin package. You can right click on a folder in the explorer to create it in a specific location. |
| Create Terminal | ros.createTerminal |
Create a terminal with ROS sourced. |
| Show Core Status | ros.showCoreStatus |
Open a detail view showing ROS core runtime status. |
| Start Core | ros.startCore |
Spawn a ROS core |
| Stop Core | ros.stopCore |
Terminate the ROS core |
| Update C++ Properties | ros.updateCppProperties |
Update the C++ include path to include ROS. |
| Update Python Path | ros.updatePythonPath |
Update the Python path to include ROS. |
| Preview URDF | ros.previewUrdf |
Preview URDF and Xacro files. Updates after changes are saved. |
Project roadmap and workitems are located on the vscode-ros github projects page. Future projects include:
- Support for ROS2 build tool and CLI commands
- Support for debugging C++ & Python from
roslaunch
The lastest unreleased changes could be added by installing the extension's latest build manually.
To get the latest build (.vsix built from the latest commit), access our build pipeline by clicking on the build badge attached above.
In the build status page, the generated .vsix could be downloaded as an artifact:
The downloaded .vsix package could be installed with the Extensions: Install from VSIX... command from the Command Palette (Ctrl+Shift+P), or by choosing the Install from VSIX... option in the Extensions tab from any Visual Studio Code instance.
Security issues and bugs should be reported privately, via email, to the Microsoft Security Response Center (MSRC) at [email protected]. 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.
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.
A big Thank you! to everyone that have helped make this extension better!
- Andrew Short (@ajshort), original author
- James Giller (@JamesGiller)
Contributions are always welcome! Please see our contributing guide for more details!