runtime/docs/en/installation.md
2024-12-09 19:11:36 +03:00

1.8 KiB

Framework Installation Guide

Important! Install only with Ubuntu 22.04 operating system

First, you need to install ROS2 Humble. A minimal installation is recommended with ros-dev-tools.

As the second step, you need to build ros2_control from source using this fork. Alternatively, you can use the vcstool method, which is included with the basic ROS2 packages.

If using vcstool, the required packages will be cloned into the same workspace as the framework. The command would look like this:

vcs import . < robossembler-ros2/repos/all-deps.repos

Additionally, you can run the following command to install all required Python libraries:

pip install -r robossembler-ros2/repos/requirements.txt

Important

Note that to run the above command, you need to install git lfs since the requirements.txt file includes the rbs_assets_library module, which contains large files but is installed as a Python module.

Make sure to execute this command in the {robossembler_ws}/src/ directory.

For those who prefer a concise sequence of commands, here it is:

cd 
mkdir -p robossembler-ros2/src && cd robossembler-ros2/src
git clone https://seed.robossembler.org/z46gtVRpXaXrGQM7Fxiqu7pLy7kip.git robossembler-ros2
# Or if you prefer Radicle:
rad clone rad:z46gtVRpXaXrGQM7Fxiqu7pLy7kip
# Or if you prefer Gitlab
git clone https://gitlab.com/robossembler/robossembler-ros2.git
vcs import . < robossembler-ros2/repos/all-deps.repos
pip install -r robossembler-ros2/repos/requirements.txt
cd ..
rosdep install --from-paths src -y --ignore-src
colcon build --symlink-install