You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

51 lines
3.6 KiB
Markdown

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# Развертывание симуляции зоны ЧС в Unity
# 1. Установка UnityHub
Установка лаунчера подробно описано [на официальном сайте](https://docs.unity.com/en-us/hub/install-hub-linux#install-the-hub-on-an-ubuntu-linux-distribution). Дублирую информацию:
1.1 Проверяем наличие или устанавливаем при необходимости утилиту curl:
```
sudo apt install curl
```
1.2 Добавляем публичный ключ для подписи
```
sudo install -d /etc/apt/keyrings
curl -fsSL https://hub.unity3d.com/linux/keys/public | sudo gpg --dearmor -o /etc/apt/keyrings/unityhub.gpg
```
1.3 Добавляем репозиторий Unity Hub (только для x86_64/amd64)
```
echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/unityhub.gpg] https://hub.unity3d.com/linux/repos/deb stable main" | sudo tee /etc/apt/sources.list.d/unityhub.list
```
1.4 Устанавливаем приложение
```
sudo apt update
sudo apt install unityhub
```
# 2. Установка Unity
Заходим в Unityhub и во вкладке `Installs` нажимаем `Install Editor`. В появившимся окне выбираем `Unity 6.0`, проверяем, достаточно ли свободного места на диске, никакие дополнительные модули не ставим и подтверждаем установку. При необходимости модули можно будет доставить потом.
# 3. Развертывание симуляции
1. Склонировать симуляцию из [Gitрепозитория](https://git.robofob.ru/sirius/sirius_unity_sim.git) в любую удобную папку на диске:
```bash
git clone --recurse-submodules https://git.robofob.ru/sirius/sirius_unity_sim.git
```
Если репозиторий уже был склонирован без модуля, то выполнить:
```bash
git submodule init
git submodule update
```
2. Скачиваем модели мира [НазваниеАрхива] и разархивируем ее в папку `Assets`. Должна получится струткура `Assets/НазваниеАрхива`
3. В UnityHub добавляем проект ( Add new project ) и выбираем папку `sirius_unity_sim`.
4. Открываем проект и ждем процесса компиляции проекта. (мне кажется, что тут появился SafeMode, который должен исчезнуть после установки доп.пакетов из п.5)
5. После открытия программы устанавливаемя дополнительные пакеты для организации свзяи ROS+Unity:
> Через интерфейс "+" выбрать `Add package from git URL...` и ввести прикрепленные ниже ссылки
- [ROS-TCP-Connector](https://github.com/Unity-Technologies/ROS-TCP-Connector) - перессылка сообещинй из ROS в Unity и обратно
`https://github.com/Unity-Technologies/ROS-TCP-Connector.git?path=/com.unity.robotics.ros-tcp-connector`.
- Visualizations - визуализация данных ROS-сообщений в Unity в реальном времени
`https://github.com/Unity-Technologies/ROS-TCP-Connector.git?path=/com.unity.robotics.visualizations`
- [URDF-Importer](https://github.com/Unity-Technologies/URDF-Importer)
`https://github.com/Unity-Technologies/URDF-Importer.git?path=/com.unity.robotics.urdf-importer#v0.5.2`