# ROS VSCode Extension This [Visual Studio Code (VSCode)][vscode] extension provides support for [Robot Operating System (ROS)][ros] development. * [Repository][repo] * [Issues][issues] ## Getting Started The extension will automatically start when you open a catkin workspace, or a folder which is inside a catkin workspace. 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. To start ROS master, use the "ROS: Start Core" command. The "ROS master" indicator in the bottom left will show if the master is currently running, and you can click on this to view parameters etc. If you hit F5 you can create a debug configuration to run a `rosrun` or `roslaunch` command. The first time you open the workspace the extension will automatically create a `catkin_make` build task and update the C++ and Python paths. You can re-run this process later using the appropriate commands. ## Features * Automatic ROS environment configuration. * Allows starting, stopping and viewing the ROS master status. * Run `catkin_make` using standard build command. * Create catkin packages. * Run `rosrun` or `roslaunch` * 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. ## Commands

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.
Show Master Status	`ros.showMasterStatus`	Open a detail view showing details about the ROS master.
Start Core	`ros.startCore`	Spawn a ROS core
Stop Core	`ros.stopCore`	Kill the ROS core
Update Build Tasks	`ros.updateBuildTasks`	Generate a build task to run `catkin_make` in a ROS environment.
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.

[issues]: https://github.com/ajshort/vscode-ros/issues [repo]: https://github.com/ajshort/vscode-ros [ros]: http://ros.org [vscode]: https://code.visualstudio.com