From f89e251174618f24d39cc0581399042dd953bd6c Mon Sep 17 00:00:00 2001 From: yurekami Date: Tue, 1 Sep 2026 22:16:56 +0800 Subject: [PATCH] Document Docker apt index refresh for rosdep installs The Jazzy README currently suggests a clone -> rosdep workflow that is correct on a host machine but can fail in minimal ROS Docker images after their APT lists have been cleared. Document the required apt-get update step and add the first-time contributor NOTICE entry expected by this repository. Constraint: rosdep still resolves curl to libcurl4-openssl-dev, and Ubuntu 24.04 apt does not accept virtual-only libcurl4-dev as an install candidate Rejected: Change ros/rosdistro curl mapping to libcurl4-dev | Noble apt-get -s install libcurl4-dev reports no installation candidate Rejected: Leave the issue to user workaround notes only | the main README currently omits the Docker-specific prerequisite in the build path Confidence: high Scope-risk: narrow Directive: Keep the Docker note adjacent to the generic build steps so future package-manager changes are updated in one place Tested: git diff --check; verified Noble apt simulation for libcurl4-openssl-dev and libcurl4-dev via WSL Ubuntu 24.04.3 Not-tested: upstream GitHub Actions; full micro_ros_setup build Signed-off-by: yurekami --- NOTICE | 2 ++ README.md | 13 +++++++++++++ 2 files changed, 15 insertions(+) diff --git a/NOTICE b/NOTICE index 17a152ed..74ed1ffa 100644 --- a/NOTICE +++ b/NOTICE @@ -33,3 +33,5 @@ Robert Wilbrandt Boston Engineering Connor Lansdale + +yurekami diff --git a/README.md b/README.md index 09556d29..c81e152e 100644 --- a/README.md +++ b/README.md @@ -122,6 +122,19 @@ colcon build source install/local_setup.bash ``` +If you are building inside a minimal Docker image such as `ros:jazzy-ros-core-noble`, +refresh the APT package index in the same `RUN` step before invoking `rosdep install`. +The official ROS images clear `/var/lib/apt/lists/*`, so skipping `apt-get update` +can make `rosdep` fail when it tries to install system packages such as +`libcurl4-openssl-dev`. + +```dockerfile +RUN apt-get update && \ + . /opt/ros/$ROS_DISTRO/setup.sh && \ + rosdep update && \ + rosdep install --from-paths src --ignore-src -y +``` + Once the package is built, the firmware scripts are ready to run. You can find tutorials for moving your first steps with micro-ROS on an RTOS in the [micro-ROS webpage](https://micro-ros.github.io/docs/tutorials/core/first_application_rtos/).