Установка и удаление Аврора SDK для Linux

• Установка
  • Подготовка рабочего места
  • Ограничения
  • Загрузка установочного файла
  • Известные проблемы с установщиком
  • Работа с мастером установки
  • Запуск Аврора IDE
• Удаление Аврора SDK
  • Подготовительные действия к удалению
  • Удаление

Установка

Подготовка рабочего места

Перед установкой Аврора SDK нужно убедиться, что компьютер разработчика удовлетворяет минимальным требованиям.

Требования к персональному компьютеру разработчика:

• процессор на архитектуре x86_64;
• не менее 45 Гб свободного дискового пространства;
• если установка планируется на ОС Альт, то размер каталога /tmp должен быть не менее 6-8 Гб, об особенностях работы с /tmp можно узнать в документации Альт;
• 16 или более Гб оперативной памяти (рекомендуется);
• поддержка аппаратной виртуализации (рекомендуется для быстрой работы виртуальных машин);
• подключение к сети Интернет, так как зависимости из репозиториев могут загружаться по сети при сборке и установке приложений. Тем не менее возможна установка и работа с SDK полностью офлайн.

На компьютере разработчика должно быть установлено следующее программное обеспечение:

• рекомендуется одна из следующих операционных систем:
  • Ubuntu LTS не ниже версии 20.04;
  • Альт Рабочая станция 10;
• Oracle VM VirtualBox версии не ниже 6.x (далее — VirtualBox);
  • для Linux с версией ядра 5.15.0-112 и выше необходим VirtualBox не ниже 7.x, узнать версии можно с помощью команд uname и vboxmanage;
• Docker. Инструкция по установке Docker для различных ОС находится в разделе установка Docker.

Примечание. Технология виртуализации Docker не входит в offline- и online-установщик.

В зависимости от того, offline- или online-установщик будет выбран, работа с технологией виртуализации будет отличаться.

Есть ли доступ в Интернет при установке	Тип установщика	Выбор технологии
Да	online, offline	Можно выбрать Docker или VirtualBox
Нет	offline	Можно выбрать только VirtualBox
Нет	online	Установщик не сможет работать

Процесс установки VirtualBox может быть различным в зависимости от операционной системы. Установочные пакеты для различных операционных систем доступны на сайте VirtualBox. Однако для дистрибутивов Linux рекомендуется использовать пакет из репозиториев, настроенных в операционной системе.

В ходе установки Аврора SDK могут быть установлены следующие компоненты в зависимости от комплекта поставки:

• Aurora SDK MB2:
  • Aurora Build Engine (VirtualBox) и Aurora Emulator (VirtualBox);
  • Aurora Build Engine (Docker) и Aurora Emulator (VirtualBox).
• Aurora SDK BT:
  • Aurora Build Tools (Docker) и Aurora Emulator (VirtualBox).

Среда сборки обеспечивает сборку приложений, не зависящую от системы разработчика, эмулятор позволяет выполнять приложения в окружении Аврора ОС аналогично работе на мобильных устройствах.

Ограничения

• Инструкция актуальна для установки первого SDK.
• Для установки нескольких разных версий Аврора SDK следует воспользоваться инструкцией.
• Повторно установить SDK одной и той же версии можно, только если перед повторной установкой удалить уже установленную версию.

Загрузка установочного файла

Ссылки на установочные файлы различных версий Аврора SDK см. в разделе Загрузка Аврора SDK.

Выбирать подходящую версию инструмента разработки следует по следующим критериям:

• для разработки под сертифицированную версию ОС Аврора нужно использовать версию SDK, совместимую с сертифицированной версией;
• номер версии SDK должен совпадать с номером версии целевой ОС Аврора с точностью до первых двух чисел;
• установочный файл должен соответствовать ОС на ПК: Linux, Windows или macOS.

Известные проблемы с установщиком

Начиная с Ubuntu 22.04, запуск установщика SDK приводит к ошибке error while loading shared libraries: libxcb-xinerama.so.0: cannot open shared object file: No such file or directory.

Проблема решается установкой пакета libxcb-xinerama0:

sudo apt install libxcb-xinerama0

Работа с мастером установки

Установочный файл позволяет запустить мастер установки — приложение с графическим интерфейсом, которое выглядит и работает схоже во всех ОС. Для установки Аврора SDK необходимо выполнить следующие действия:

1. Запустить мастер установки. 1. Открыть терминал. 2. Предоставить разрешение на выполнение для установочного файла:
   chmod +x {путь_к_установочному_файлу}. 3. Запустить установочный файл от имени обычного пользователя (не от суперпользователя root).

2. В приветственном окне мастера установки нажать кнопку Далее.

   

3. В следующем окне выбрать каталог, в который будет установлена среда разработки, и нажать кнопку Далее.

   

4. В следующем окне выбрать технологию виртуализации: VirtualBox или Docker.

   

5. В появившемся окне выбрать папку рабочего пространства, отличную от каталога для установки, для размещения проектов и нажать кнопку Далее. Выбранный каталог будет использоваться сборочным движком для сборки проектов.

   

6. В открывшемся окне выбрать необходимые для установки компоненты и нажать кнопку Далее. По умолчанию выбраны все компоненты. Рекомендуется ничего не отключать, если нет необходимости.

   

7. В окне о лицензионном соглашении следует установить переключатель в поле Я согласен(а) с лицензией и нажать кнопку Далее.

   При выборе пункта Я не согласен(а) с лицензией произойдет отмена всех пройденных ранее этапов и выход из мастера установки.

   

8. В окне Всё готово к установке нажать кнопку Установить.

   

9. В окне Установка Aurora SDK дождаться окончания процесса установки. Для просмотра подробностей о процессе установки необходимо нажать кнопку Показать детали.

   

   Примечание. При длительной работе системы, можно проверить в динамике изменение размера установочной директории с помощью команды:

   watch 'du -s ~/AuroraOS'
   

   Размер каталога должен изменяться.

10. В окне Завершение установки Аврора SDK следует отметить пункт Запустить Аврора IDE для запуска Аврора SDK сразу после завершения процесса установки. Нажать кнопку Завершить.

    

Запуск Аврора IDE

После установки запуск IDE будет возможен по значку Аврора IDE в системном меню.

Для запуска Аврора IDE необходимо:

• ввести Аврора IDE в панели запуска и выбрать соответствующий значок;
• указать полный путь к файлу в командной строке.

После установки Аврора SDK можно перейти к созданию приложения для ОС Аврора.

Удаление Аврора SDK

SDK для ОС Аврора поставляется с инструментом обслуживания под названием SDKMaintenanceTool, который нужно использовать для полного удаления программы. Его можно найти через системное меню дистрибутива или непосредственно в установленном каталоге, например, в Linux — ~/AuroraOS.

Подготовительные действия к удалению

Перед удалением необходимо выключить Аврора IDE (Qt Creator).

Удаление

Для удаления Аврора SDK необходимо выполнить следующие действия:

1. Запустить средство установки и удаления SDKMaintenanceTool. Для этого в терминале необходимо ввести ~/AuroraOS/SDKMaintenanceTool.

2. В окне SDKMaintenanceTool выбрать пункт Удаление всех компонентов и нажать кнопку Далее.

   

3. Прочитать предупреждение перед удалением и нажать кнопку Удалить. Также по желанию можно отметить пункт Удалить все кэш файлы.

   

4. Дождаться завершения удаления и нажать кнопку Завершить.