You're reading the documentation for an older, but still supported, version of ROS 2. For information on the latest version, please have a look at Jazzy.

Building a package with Eclipse 2021-06

You cannot create a ROS 2 package with eclipse, you need to create it with commandline tools. Follow the Create a package tutorial.

After you created your project, you can edit the source code and build it with eclipse.

We start eclipse and select a eclipse-workspace.

eclipse_work_dir

We create a C++ project

eclipse_create_c++_project eclipse_c++_project_select_type

We see that we got C++ includes.

eclipse_c++_project_includes

We now import our ROS 2 project. The code is still in the old place.

eclipse_import_project eclipse_import_filesystem

Click the Advanced in the Options and check the Create links in worksapce.

eclipse_import_select_my_package

We see in the source code that the C++ includes got resolved but not the ROS 2 ones.

eclipse_c++_wo_ros_includes eclipse_c++_path_and_symbols

Add include paths of needed packages. (e.g. /opt/ros/iron/include/rclcpp, /opt/ros/iron/include/std_msgs, etc.)

eclipse_c++_add_directory_path

We now see that the ROS 2 includes got resolved too.

eclipse_c++_indexer_ok

Adding Builder colcon, so that we can build with right-click on project and “Build project”.

eclipse_c++_properties_builders eclipse_c++_builder_main

With PYTHONPATH you can also build python projects.

eclipse_c++_builder_env eclipse_c++_properties_builders_with_colcon

Right-click on the project and select “Build Project”.

eclipse_c++_build_project_with_colcon