Автоматизированные установка и удаление Аврора Platform SDK

Процесс установки Аврора Platform SDK может быть автоматизирован с помощью скрипта.

• Синтаксис и параметры команды
• Примеры команд
• Установка
• Установка вне домашней директории пользователя
• Удаление

Синтаксис и параметры команды

Синтаксис скрипта install_aurora_psdk.sh:

./install_aurora_psdk.sh \
  {--input-url URL | --input-dir DIR} \
  [--toolchain-suffix {base|MB2|base-extended|base-hw|base-pu|MB2-extended|MB2-hw|MB2-pu}] \
  [--install-dir PATH] \
  [--allowed-targets {...,}] \
  [--ignore-md5-checks] \
  [--custom-prompt-prefix PROMPT_PREFIX] \
  [--ubuchroot-{url | tar}]

Параметры:

• --input-url — (обязательный параметр) URL, откуда при необходимости скачиваются архивы с образами;

• --input-dir — (обязательный параметр) путь к директории, куда предварительно скачаны архивы с образами;

• --toolchain-suffix — (необязательный параметр) суффикс для установки специальных версий tooling и target (по умолчанию MB2). Обязателен для версий tooling и target ниже 5.2.0.

• --allowed-targets — (необязательный параметр) список архитектур таргетов, разрешённых для установки (по умолчанию aarch64,armv7hl,x86_64, т. е. будут устанавливаться таргеты всех поддерживаемых на текущий момент архитектур). Список задаётся через запятую без пробелов;

• --install-dir — (необязательный параметр) путь к директории, в которую будет установлен Аврора Platform SDK. По умолчанию установка будет выполнена в директорию ~/AuroraPlatformSDK. Если установка планируется в директории, отличной от домашней директории пользователя, (например, на смонтированный внешний диск /mnt/external_drive/AuroraPlatformSDK), то в этом случае перед установкой необходимо текущего пользователя сделать владельцем родительской директории установки, например:

  sudo chown $(id -un):$(id -gn) /mnt/external_drive
  

  Скрипт установки проверит владельца данной директории и прервёт свою работу в случае невыполнения условия.

• --ignore-md5-checks — (необязательный параметр) игнорирование ошибок несовпадения контрольных сумм установочных архивов. По умолчанию при возникновении несовпадения скрипт аварийно завершает работу.

• --custom-prompt-prefix — (необязательный параметр) пользовательское значение префикса командной строки, которое отображается после входа в Аврора Platform SDK. По умолчанию используется префикс [AuroraPlatformSDK].

В качестве обязательного входного параметра следует указывать либо --input-url, либо --input-dir, но не оба вместе.

В качестве значения --input-dir можно указывать относительный или абсолютный путь к директории.

Скрипт оптимизирован для работы с Аврора 5.0, где по умолчанию присутствуют таргеты aarch64, armv7hl и x86_64.

Для версий 4.X таргет aarch64 отсутствует, а вместо x86_64 по-прежнему используется i486. Чтобы корректно использовать скрипт установки для 4 версии, нужно добавить входной параметр --allowed-targets armv7hl,i486.

Необязательные параметры --ubuchroot-{url | tar} выполняют настройку окружения для работы с Ubuntu Chroot. Архив с Ubuntu Chroot задаётся одним из следующих способов:

• --ubuchroot-url — (необязательный параметр) URL, откуда скачивается архив с Ubuntu Chroot с последующей его распаковкой и настройкой окружения;
• --ubuchroot-tar — (необязательный параметр) путь к архиву с Ubuntu Chroot с последующей его распаковкой и настройкой окружения.

После успешной установки попасть в Ubuntu Chroot можно с помощью команды habusdk из Аврора Platform SDK.

Примеры команд

Версии PSDK для онлайн-установки можно выбрать по ссылке.

Команды приводятся для Unix-совместимого терминала. В Linux и macOS можно использовать стандартный терминал, в Windows необходимо использовать Git Bash.

Скачивание образов и установка в пользовательскую директорию:

./install_aurora_psdk.sh --input-url https://sdk-repo.omprussia.ru/sdk/installers/5.1.1/5.1.1.55-release/PlatformSDK --toolchain-suffix base --install-dir ~/MyPSDKDir

Аналогичная команда для одной из версий ОС Аврора 4. Устанавливаются только таргеты с архитектурами armv7hl и i486:

./install_aurora_psdk.sh --input-url https://sdk-repo.omprussia.ru/sdk/installers/4.0.2/PlatformSDK/4.0.2.303 --toolchain-suffix base --install-dir ~/MyPSDKDir --allowed-targets armv7hl,i486

Следует обратить внимание, что для разных версий ОС Аврора будут отличаться пути для скачивания образов и доступные специальные версии, указываемые в --toolchain-suffix. Пример команды для ОС Аврора 5.1.3, когда устанавливается версия MB2 (вариант по умолчанию у опции --toolchain-suffix):

./install_aurora_psdk.sh --input-url https://sdk-repo.omprussia.ru/sdk/installers/5.1.3/5.1.3.51-release/AuroraPSDK --install-dir ~/MyPSDKDir

Если планируется офлайн-установка, то компоненты Platform SDK следует предварительно скачать в одну директорию.

Установка из скачанных образов:

./install_aurora_psdk.sh --input-dir ~/Downloads/SDK_Installers/Platform_SDK/5.1.1.55 --toolchain-suffix base

Установка

1. После скачивания и распаковки архива скрипт можно сразу запустить для онлайн-установки:

   ./install_aurora_psdk.sh --input-url https://sdk-repo.omprussia.ru/sdk/installers/5.1.3/5.1.3.51-release/AuroraPSDK --install-dir ~/MyPSDKDir
   

   На первом этапе в каталог со скриптом будут загружены архивы для установки Аврора Platform SDK: Chroot, тулинг, таргеты с архитектурой aarch64, armv7hl и x86_64.

2. На втором этапе будет создан каталог MyPSDKDir в домашней директории, имя которого задано в команде запуска. Туда будут распакованы и установлены компоненты Platform SDK. Для успешной установки Аврора Platform SDK Chroot необходимо ввести пароль суперпользователя:

   2.3. Extracting Аврора Platform SDK Chroot tarball
   [sudo] пароль для user: 
   ...............................................................
   

3. На третьем этапе будет установлен Аврора Platform SDK toolchain и таргеты.

После установки можно войти в Platform SDK:

aurora_psdk

Выйти из Platform SDK можно с помощью команды:

exit

В Platform SDK можно собирать проекты.

Установка вне домашней директории пользователя

В инструкции предполагается, что раздел внешнего диска доступен по пути /dev/sda1. Установить Platform SDK вне домашней директории пользователя можно следующим образом:

1. Смонтировать диск:

   sudo mkdir -p /mnt/external_drive
   sudo mount -t ext4 /dev/sda1 /mnt/external_drive
   

2. Cделать текущего пользователя владельцем точки монтирования:

   sudo chown $(id -un):$(id -gn) /mnt/external_drive
   

3. Запустить установку с указанием пути установки внутри смонтированной директории через ключ --install-dir:

   ./install_aurora_psdk.sh \
   	--input-url https://sdk-repo.omprussia.ru/sdk/installers/4.0.2/PlatformSDK/4.0.2.303/ \
   	--custom-prompt-prefix "[PSDK_4.0.2.303_release]" \
   	--allowed-targets i486,armv7hl \
   	--toolchain-suffix base \
   	--install-dir /mnt/external_drive/AuroraPlatformSDK
   

Удаление

В ходе выполнения скрипта установки install_aurora_psdk.sh в его директории будет сгенерирован скрипт удаления uninstall_aurora_psdk.sh. Он запускается без параметров:

./uninstall_aurora_psdk.sh

Скрипт удаляет директории и очищает конфигурационные файлы, созданные и изменённые в процессе установки и использования Аврора Platform SDK.

Пример вывода скрипта:

Removed '/home/user/MyPSDKDir' directory
Removed '/home/user/.scratchbox2' directory
Cleared '/home/user/.bashrc' file
Cleared '/home/user/.bashrc' file
Cleared '/home/user/.bashrc' file
Cleared '/home/user/.mkshrc' file
Cleared '/home/user/.mkshrc' file
Cleared '/home/user/.mkshrc' file
Cleared '/home/user/.zshrc' file
Cleared '/home/user/.zshrc' file
Cleared '/home/user/.zshrc' file

После работы скрипт uninstall_aurora_psdk.sh можно удалить. Он будет сгенерирован заново при следующей установке Аврора Platform SDK с помощью скрипта install_aurora_psdk.sh.