The ROS 2 Humble Content Sharing extensions

These extensions help you snap ROS 2 applications for the Humble Hawksbill distribution using the content-sharing feature.

Note that this set of extensions are based on the ros2-humble extension. Therefore, they are applied on top of the ros2-humble extension. See ros2-humble for more information.

This extension requires Snapcraft 8.x+.

How to use it

Add extensions: [ ros2-humble-<metapackage> ] to the application definition in your snapcraft.yaml file, where ‘<metapackage>’ is one and only one of:

ros-core
ros-base
desktop

For instance, extensions: [ ros2-humble-ros-core ].

See for a complete tutorial on how to use this extension.

apps:
  apps:
  colcon-ros2-humble-rlcpp-hello:
    command: ros2 run colcon_ros2_rlcpp_hello colcon_ros2_rlcpp_hello
    extensions: [ros2-humble-ros-base]
    ...

What it does for the build-time environment

Everything the ros2-humble extension does.
Adds a content plug mounting the provider snap content at $SNAP/opt/ros/underlay_ws and defines a default provider.
Sets the CMAKE_SYSTEM_PREFIX_PATH variable to point at the mounted system path.
Adds the build snap providing the build-time equivalent of the default content-sharing provider snap to ros-build-snaps. This implies that you can avoid declaring as build-packages all the ROS 2 packages that are found inside the ROS 2 metapackage corresponding to the extension name used above.

What it does for the run-time environment

Everything the ros2-humble extension does.
Expands the runtime environment required by ROS 2 to include the ROS 2 workspace provided by the content-sharing snap. Similar to the typical chaining of ROS 2 workspaces.

Warning:

This extension is currently marked as experimental. We enable experimental extensions by setting the environment variable: SNAPCRAFT_ENABLE_EXPERIMENTAL_EXTENSIONS to 1.