Установка

На данный момент разработка с Flutter для ОС Аврора доступна для пользователей Linux и macOS ARM (только через Аврора SDK (BT)). Для настройки рабочего места и установки всех необходимых инструментов следует установить:

Основные инструменты
- Аврора SDK (BT)
- Flutter
Дополнительные инструменты
- Platform SDK
- Visual Studio Code

Предварительные требования

Установка Flutter SDK для ОС Аврора поддерживается на следующих операционных системах:

Ubuntu (версии 22.02 LTS - 26.04 LTS);
macOS (версии 15, 26, 27)

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

Aurora SDK версии 5.2.1.200 — основной набор инструментов.

Основные инструменты

Аврора SDK (BT)

Аврора SDK (BT) — набор инструментов для разработки, отладки, сборки и тестирования прикладного ПО для ОС Аврора, использующий инструменты для кросс-компиляции Аврора Build Tools.

Этот компонент отвечает за сборку приложений в установочный RPM пакет. Сборка приложений осуществляется Аврора Build Tools через Flutter CLI.

Установка Аврора SDK (BT) подробно описана в Установка и удаление Аврора SDK.

Аврора SDK содержит эмулятор, на котором можно запускать приложения Flutter.

На macOS ARM Аврора SDK (BT) — единственный поддерживаемый инструмент сборки. Platform SDK на macOS не используется.

Flutter

Flutter — это комплект средств разработки и фреймворк для создания приложений.

Перед установкой Flutter на Linux необходимо установить зависимости:

sudo apt update && sudo apt install curl git git-lfs unzip bzip2 tar netcat-openbsd

git — система контроля версий, используется для загрузки репозитория Flutter SDK;
git-lfs — расширение Git для работы с файлами большого объема. Требуется для загрузки бинарных артефактов Flutter Engine;
bzip2, tar — утилиты для распаковки дистрибутивов SDK;
netcat-openbsd — сетевая утилита, используется инструментами отладки для взаимодействия с эмулятором и устройством.

Процесс установки:

Создать каталог для размещения Flutter SDK:

mkdir -p ~/.local/opt

Получить дистрибутив Flutter для ОС Аврора одним из следующих способов:
- Загрузка и распаковка архива Скачать архив с последней версией Flutter для ОС Аврора (по умолчанию сохраняется в каталог ~/Downloads) и распаковать его в целевую директорию:
```
tar xf ~/Downloads/flutter_aurora_linux_3.41.4.tar.gz -C ~/.local/opt
```
- Клонирование Git-репозитория Склонировать официальный репозиторий проекта непосредственно в целевой каталог:
```
git clone https://hub.mos.ru/auroraos/flutter/flutter/ ~/.local/opt/flutter_aurora_linux
```
Добавить псевдонимы (alias) в конфигурационный файл командной оболочки ~/.bashrc для обеспечения возможности вызова утилит flutter и dart из любой директории:

echo "alias flutter-aurora=$HOME/.local/opt/flutter_aurora_linux/bin/flutter" >> ~/.bashrc
echo "alias dart-aurora=$HOME/.local/opt/flutter_aurora_linux/bin/dart" >> ~/.bashrc

flutter-aurora — основной консольный инструмент для управления проектами. Используется для проверки окружения (flutter-aurora doctor), создания проектов (flutter-aurora create), сборки RPM-пакетов (flutter-aurora build aurora) и запуска приложения на эмуляторе или устройстве (flutter-aurora run);
dart-aurora — интерпретатор и компилятор языка Dart, включенный в Flutter SDK.

Перезагрузить конфигурацию активной сессии командной строки для применения изменений:

source ~/.bashrc

Перед работой рекомендуется сконфигурировать Flutter для использования SDK (BT):

flutter-aurora config --aurora-sdk-dir path/to/sdk

Если ранее был задан путь к Platform SDK, его нужно сбросить, иначе сборка продолжит использовать Platform SDK:

flutter-aurora config --aurora-psdk-dir ""

На Linux также можно использовать Platform SDK:

flutter-aurora config --aurora-psdk-dir {psdk_dir}/sdks/aurora_psdk

{psdk_dir} — путь до Platform SDK.

Во Flutter CLI доступна команда doctor, которая позволяет проверить, все ли необходимые для сборки компоненты установлены верно:

flutter-aurora doctor

Если после выполнения в выводе появится следующее, то Flutter для ОС Аврора готов к работе:

[✓] Aurora toolchain — develop for Aurora OS

Дополнительные инструменты

Platform SDK

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

Platform SDK доступен только на Linux и не поддерживается на macOS.

Platform SDK предназначен для сборки приложений из командной строки и может использоваться в системах CI/CD. Более подробно можно ознакомиться с компонентами в разделе О проекте.

Этот компонент отвечает за сборку приложений в установочный RPM пакет. Сборка приложений осуществляется Platform SDK через Flutter CLI.

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

Названия таргетов должны соответствовать шаблону документации:

AuroraOS-{version}-base-{architecture}

{version} — версия Platform SDK;
{architecture} — архитектура таргета: aarch64 | armv7hl | x86_64.

Visual Studio Code

Рекомендуемый текстовый редактор — VS Code. Этот текстовый редактор имеет расширения Flutter/Dart, которые позволяют работать с таргетами ОС Аврора без модификаций. Весь набор инструментария по работе с Flutter с поддержкой ОС Аврора доступен в этой среде.

Подробная инструкция по установке редактора, расширения Flutter и указанию пути к Flutter SDK приведена в разделе VS Code.