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

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

Установка

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

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

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

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

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

• Windows 10 (далее — Windows) не ниже версии сборки 17063 с архиватором tar, для корректной работы плагина примеров;
• Oracle VM VirtualBox версии не ниже 6.1.14 (далее — VirtualBox).
• Git;
• Docker. Инструкция по установке Docker для различных ОС находится в разделе установка Docker.

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

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

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

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

В ходе установки Аврора 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.

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

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

1. Запустить мастер установки. 1. Открыть папку с предварительно загруженным инструментом установки. 2. Запустить установочный файл {имя_установочного_файла}.exe.

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

   

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

   

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

   

5. В Windows появится окно для выбора приложения-интерпретатора Bash как пути к ssh-keygen.exe. В случае git bash путь по умолчанию выглядит следующим образом: C:/Users/{имя пользователя}/AppData/Local/Programs/Git/usr/bin/ssh-keygen.exe. Данный шаг установки появится только для Windows.

   

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

   

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

   

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

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

   

9. В Windows появится окно Ярлыки меню Пуск. Выбрать существующую папку в меню Пуск или создать новую для размещения ярлыков программы. После нажать кнопку Далее.

   

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

    

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

    

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

    

Настройка виртуализации в Windows

Если для среды сборки выбран тип контейнеризации Docker, то во время запуска VirtualBox и Docker на Windows могут возникнуть некоторые ошибки.

В различных обновлениях Windows есть риск возникновения конфликтов между компонентами виртуализации системы и VirtualBox. Для настройки параметров эмулятора необходимо изменить количество процессоров, оно должно быть больше одного. Если эмулятору предоставляется только один процессор, он не будет загружаться в BIOS.

Количество процессоров можно узнать с помощью команды sfdk emulator show. Например:

C:\AuroraOS\bin\sfdk.exe emulator show

Значение vm.cpuCount — это количество процессоров, оно должно быть больше 1 (см. рисунок). Установить количество процессоров можно с помощью команды sfdk emulator set. Например:

C:\AuroraOS\bin\sfdk.exe emulator set vm.cpuCount=2

Работа с символическими ссылками в Windows

При разработке проектов для ОС Аврора на хосте с ОС Windows могут возникать ошибки из-за символических ссылок. Чтобы их избежать, можно выполнить один из следующих пунктов:

• включить режим разработчика в Windows
• включить в Windows политику, разрешающую создание ссылок

Если нужны символические ссылки в файле RPM, можно создать их в разделе %install файла SPEC следующим образом:

mv%{buildroot}/%{_libdir}/libfoo.so %{buildroot}/{_libdir}/libfoo.so.1.0.0
ln -s -t %{buildroot}/%{_libdir}/libfoo.so.1.0.0 %{buildroot}/%{_libdir}/libfoo.so
ln -s -r %{buildroot}/%{_libdir}/libfoo.so.1.0.0 %{buildroot}/%{_libdir}/libfoo.so.1
ln -s -r %{buildroot}/%{_libdir}/libfoo.so.1.0.0 %{buildroot}/%{_libdir}/libfoo.so.1.0

Если проблема возникла для примера, следует обратиться за решением к их документации.

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

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

Для запуска Аврора IDE необходимо ввести в строке поиска Аврора IDE и выбрать соответствующее приложение.

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

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

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

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

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

Удаление

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

1. Запустить средство установки и удаления SDKMaintenanceTool. Его можно найти в поиске SDKMaintenanceTool или вручную перейти в расположение средства установки и удаления C:\AuroraOS\SDKMaintenanceTool.exe.

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

   

3. Прочитать предупреждение перед удалением и нажать кнопку Удалить.

   

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

   

   

Возможные ошибки

При работе Аврора SDK совместно с VirtualBox 7 в Windows могут не запуститься виртуальные машины даже из VirtualBox с ошибкой о некорректной установке драйверов.

Данная проблема находится на уровне VirtualBox. Её можно решить с помощью следующих действий:

1. Полностью удалить VirtualBox (включая директорию .VirtualBox в домашней директории).

2. Удалить драйверы, относящиеся к VirtualBox, из директории C:\Windows\System32\drivers.

   del C:\Windows\System32\drivers\VBoxNetAdp6.sys
   

   del C:\Windows\System32\drivers\VBoxNetLwf.sys
   

   del C:\Windows\System32\drivers\VBoxSup.sys
   

   del C:\Windows\System32\drivers\VBoxUSBMon.sys
   

   или использовать маску

   del C:\Windows\System32\drivers\VBox*.sys
   

3. Перезапустить компьютер.

4. Запустить командную строку от имени администратора и отключить проверку подписей драйверов с помощью команды:

   bcdedit.exe /set nointegritychecks on
   

5. Установить VirtualBox 7.

6. После переустановки ещё раз перезагрузить компьютер.

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

   bcdedit.exe /set nointegritychecks off