🤖 ros-conan

🚀 Conan recipes for building ROS 2 from source — consumable like any other Conan package.

_{End-to-end demo built from Conan packages — ros-kilted (desktop) + OpenCV + TensorFlow Lite. See examples/pose_estimation.}

• 📦 One conan install. Pull ROS 2 and every system dependency from a Conan remote — no rosdep, apt, brew or choco required.
• 🔌 Drop-in for any build system. Plain CMake projects, colcon workspaces, or anything else that speaks CMake's find_package can consume ros-kilted.
• 🔁 Reproducible & cacheable. Profile-pinned binaries, uploaded to Artifactory, resolved deterministically across machines and CI.
• 🐍 Hermetic Python tooling. colcon-*, catkin_pkg, empy, ... ship inside the package via Conan's PyEnv. No global pip pollution.

The recipes follow the official upstream development setup for each platform:

• 🪟 Windows: https://docs.ros.org/en/kilted/Installation/Alternatives/Windows-Development-Setup.html
• 🍎 macOS: https://docs.ros.org/en/kilted/Installation/Alternatives/macOS-Development-Setup.html
• 🐧 Linux: https://docs.ros.org/en/kilted/Installation/Alternatives/Ubuntu-Development-Setup.html

These recipes are not currently available in ConanCenter (or need patches) and are required by ros-kilted or its consumers:

All other third-party libraries (OpenSSL, Boost, Qt, OpenCV, Eigen, spdlog, gtest, ...) are pulled from ConanCenter.

Add this repo as a local-recipes-index remote and install ros-kilted like any other Conan package:

git clone https://github.com/conan-io/ros-conan.git
conan remote add ros-conan ./ros-conan --type=local-recipes-index

conan install --requires=ros-kilted/0.1.0 \
    --build=missing \
    --profile=ros-conan/profiles/windows-msvc

That's it — ros-kilted and the dependency recipes above resolve from this index, every other dependency comes from ConanCenter.

The variant option on ros-kilted selects which subset of ROS 2 packages is built:

Set it on the command line:

conan install --requires=ros-kilted/0.1.0 -o ros-kilted/*:variant=desktop --build=missing

or in a profile (see profiles/windows-msvc and profiles/macos-clang).

Reference profiles for the CI-supported platforms live in profiles/:

Both profiles pin a recent cmake/* as a global tool_requires, default ros-kilted to the desktop variant and disable opencv:with_ffmpeg on Windows to keep the dependency graph small.

Sample projects consuming ros-kilted through Conan. Each has its own readme with build & run steps.

Use Conan's local development flow to iterate the recipe methods independently:

conan source     recipes/ros-kilted/all --version=0.1.0
conan install    recipes/ros-kilted/all --version=0.1.0 --build=missing --profile=profiles/windows-msvc
conan build      recipes/ros-kilted/all --version=0.1.0                 --profile=profiles/windows-msvc
conan export-pkg recipes/ros-kilted/all --version=0.1.0                 --profile=profiles/windows-msvc

Once happy with the result, run conan create to produce a final package and execute its test_package:

conan create recipes/ros-kilted/all --version=0.1.0 --profile=profiles/windows-msvc

The recipe builds the merged install/ of a colcon workspace it materialises under recipes/ros-kilted/all/ros2_ws/ (ignored by git). Build artefacts of the local development flow can be cleared by deleting that directory.

GitHub Actions builds ros-kilted (desktop variant) on windows-latest (MSVC) and macos-latest (apple-clang) for every push to main and every pull request, then runs all examples/*/ci_test_example.py against the freshly produced package. Built binaries that hit the workflow (not those already cached on ConanCenter) are uploaded to a private Artifactory remote. See .github/workflows/conan-create-ros-kilted.yml.

Recipe metadata and supporting files in this repository are licensed under the MIT License — see LICENSE. The upstream ROS 2 archives and the third-party libraries built by these recipes are subject to their own licenses (see the ROS 2 project and each component).