📝ROS2 Build Issue

ros2

build

2025

ROS2 Issue Tracker

Published

January 13, 2025

Issue

Error Message

CMake Error at CMakeLists.txt:5 (find_package):
  By not providing "Findament_cmake.cmake" in CMAKE_MODULE_PATH this project
  has asked CMake to find a package configuration file provided by
  "ament_cmake", but CMake did not find one.

  Could not find a package configuration file provided by "ament_cmake" with
  any of the following names:

    ament_cmakeConfig.cmake
    ament_cmake-config.cmake

  Add the installation prefix of "ament_cmake" to CMAKE_PREFIX_PATH or set
  "ament_cmake_DIR" to a directory containing one of the above files.  If
  "ament_cmake" provides a separate development package or SDK, be sure it
  has been installed.

Solution

This error typically appears when CMake cannot locate ament_cmake. In ROS 2, ament_cmake is a core build system package that you must have installed (and sourced) before building any ament-based packages.

Ensure the ament_cmake package is actually installed. On Ubuntu, for Humble, you’d expect something like:

If you have a minimal or custom ROS 2 installation, you might need to install additional packages to get ament_cmake.

sudo apt-get install ros-humble-ament-cmake

find_package 단계에서 깨지는 다른 사례로, CMake의 FindPython3가 시스템 인터프리터 대신 ~/.local/bin의 다른 파이썬을 잡아 ModuleNotFoundError: No module named 'catkin_pkg'가 나는 경우가 있다. 해결은 ROS 2 멀티스레드 실측 노트의 재현 메모 참고.

colcon build --symlink-install --cmake-args -DPython3_EXECUTABLE=/usr/bin/python3

Issue

Solution

Related