2024-11-20 21:07:19 +03:00
# Инструкция по установке фреймворка
2024-12-09 19:50:47 +03:00
**Важно!** Совместимо только с операционной системой Ubuntu 22.04.
2024-12-09 18:22:14 +03:00
2024-12-09 19:50:47 +03:00
Ниже приведена последовательность шагов для настройки фреймворка.
2024-11-20 21:07:19 +03:00
2024-12-09 19:50:47 +03:00
---
2024-11-20 21:07:19 +03:00
2024-12-09 19:50:47 +03:00
## Шаг 1: Установка ROS2 Humble
Для начала установите [ROS2 Humble ](https://docs.ros.org/en/humble/Installation/Ubuntu-Install-Debs.html ).
Рекомендуется минимальная установка `ros-humble-ros-base` , а также пакет `ros-dev-tools` .
---
## Шаг 2: Проверка среды ROS2
Перед продолжением убедитесь, что среда ROS2 активирована. Для этого выполните:
```sh
source /opt/ros/humble/setup.bash
```
---
## Шаг 3: Если Вы этого не делали то сделайте
```sh
sudo rosdep init
rosdep update
```
---
## Шаг 4: Установка фреймворка
```sh
cd
mkdir -p robossembler-ws/src & & cd robossembler-ws/src
git clone --recurse-submodules https://gitlab.com/robossembler/robossembler-ros2.git
```
Далее необходимо собрать [`ros2_control` ](https://github.com/ros-controls/ros2_control ) из исходников, используя этот [форк ](https://github.com/solid-sinusoid/ros2_control/tree/gz-ros2-cartesian-controllers ).
Также доступна альтернатива с использованием [`vsctool` ](https://github.com/dirk-thomas/vcstool ), который входит в состав базовых пакетов ROS2.
Если вы решили использовать `vcstool` , нужные пакеты будут клонированы в тоже рабочее пространство, что и сам фреймворк. Команда для этого выглядит следующим образом:
2024-11-20 21:07:19 +03:00
```sh
vcs import . < robossembler-ros2 / repos / all-deps . repos
```
2024-12-09 19:50:47 +03:00
Вы также можете установить все необходимые библиотеки Python, выполнив команду:
2024-11-20 21:07:19 +03:00
```shell
2024-12-09 18:22:14 +03:00
pip install -r robossembler-ros2/repos/requirements.txt
2024-12-09 19:50:47 +03:00
# Если Вы получили ошибку с установкой Shapely
sudo apt install libgeos-dev
```
> **[!ВНИМАНИЕ]**
> Убедитесь, что у вас установлен `git lfs`. В файле `requirements.txt` указан модуль `rbs_assets_library`, который содержит большие файлы и устанавливается как Python-модуль.
Эти команды нужно выполнять в директории `robossembler-ws/src/` .
Установка зависимостей при помощи `rosdep`
```sh
cd ~/robossembler-ws
rosdep install --from-paths src -y --ignore-src --rosdistro ${ROS_DISTRO}
2024-11-20 21:07:19 +03:00
```
2024-12-09 19:50:47 +03:00
Сборка фреймворка при помощи `colcon`
```sh
colcon build
```
2024-12-01 14:55:07 +03:00
2024-12-09 19:50:47 +03:00
---
## Полная последовательность команд
2024-11-20 21:07:19 +03:00
2024-12-09 19:50:47 +03:00
Ниже приведён полный набор команд для настройки фреймворка:
2024-11-20 21:07:19 +03:00
```sh
cd
2024-12-09 19:50:47 +03:00
mkdir -p robossembler-ws/src & & cd robossembler-ws/src
git clone --recurse-submodules https://gitlab.com/robossembler/robossembler-ros2.git
# Или, если вы предпочитаете Radicle:
git clone --recurse-submodules https://seed.robossembler.org/z46gtVRpXaXrGQM7Fxiqu7pLy7kip.git robossembler-ros2
2024-11-20 21:07:19 +03:00
rad clone rad:z46gtVRpXaXrGQM7Fxiqu7pLy7kip
2024-12-09 19:50:47 +03:00
2024-11-20 21:07:19 +03:00
vcs import . < robossembler-ros2 / repos / all-deps . repos
2024-12-09 19:50:47 +03:00
pip install -r robossembler-ros2/repos/requirements.txt
2024-11-20 21:07:19 +03:00
cd ..
2024-12-09 19:50:47 +03:00
rosdep install --from-paths src -y --ignore-src --rosdistro ${ROS_DISTRO}
colcon build
2024-11-20 21:07:19 +03:00
```