Skip to content

Conversation

Copy link

Copilot AI commented Jan 28, 2026

The installation guide was missing ROS 2 desktop and colcon, causing colcon build to fail with Findament_cmake not found.

Changes

  • Added ROS 2 installation step after stage_ros2 clone, before rosdep:

    sudo apt install ros-humble-desktop python3-colcon-common-extensions

    Note added to skip if already installed.

  • Added environment sourcing before colcon build commands:

    source /opt/ros/humble/setup.bash

    Note added that this must be repeated per terminal session.

  • Updated full example section to include both steps in correct sequence

The installation flow now ensures ROS 2 and colcon are present before attempting workspace builds.

Original prompt

Problem

The installation guide in notes/Stage_Ros2_Installation.md is missing critical ROS 2 build dependencies, causing the colcon build step to fail with an error about not finding Findament_cmake.

Solution Required

Update the installation instructions to include the missing ROS 2 development packages before attempting to build. Specifically:

  1. Add a new step before the "Make sure the python ros development tools are installed" section that installs the core ROS 2 build dependencies:

    sudo apt install ros-humble-desktop python3-colcon-common-extensions
  2. Ensure the ROS 2 environment is sourced before running any colcon commands. Add this instruction:

    source /opt/ros/humble/setup.bash
  3. Update the full example section at the bottom to include these steps in the correct order.

Expected Changes

The updated flow should be:

  1. Install system dependencies (git, cmake, etc.)
  2. Build and install Stage
  3. Install stage_ros2 repository
  4. Install ROS 2 desktop and colcon (NEW)
  5. Source ROS 2 environment (NEW)
  6. Install rosdep and run rosdep install
  7. Build with colcon

File to Modify

  • notes/Stage_Ros2_Installation.md

Additional Context

  • The base branch should be the default branch
  • The ROS 2 distribution appears to be Humble based on the submodule instructions
  • The instructions are for Ubuntu 24.04

This pull request was created from Copilot chat.


💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

Copilot AI and others added 4 commits January 28, 2026 13:36
Co-authored-by: SPauly <43349007+SPauly@users.noreply.github.com>
Co-authored-by: SPauly <43349007+SPauly@users.noreply.github.com>
Co-authored-by: SPauly <43349007+SPauly@users.noreply.github.com>
Co-authored-by: SPauly <43349007+SPauly@users.noreply.github.com>
Copilot AI changed the title [WIP] Update ROS 2 installation guide with missing build dependencies Add missing ROS 2 build dependencies to Stage installation guide Jan 28, 2026
Copilot AI requested a review from SPauly January 28, 2026 13:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants