UI Kit

UI Kit "Aurora Controls" предоставляет разработчикам возможность делать интерфейс приложений более похожим на нативный. Пакет для Flutter реализует компоненты, описанные в разделе Проектирование и дизайн. Функционал разделен между двумя проектами:

• "Aurora Controls", который содержит в себе набор компонентов, иконок и тем для приложения.
• "Aurora Window Manager", в составе которого содержится интерфейс для работы с прозрачностью окна и реакцией на изменение атмосферы.

Примечание: на иконки в составе пакета Aurora Controls распространяется отдельная лицензия, которая находится в пакете Aurora Controls по следующему пути: /packages/aurora-controls/assets/icons/LICENSE. При использовании иконок необходимо учитывать, что они могут быть видны пользователю только в версии приложения для ОС Аврора. Подробнее см. в разделе Использование иконок.

Состав UI Kit

Текущая версия UI Kit включает в себя:

• Набор готовых базовых компонентов, таких как:
  • текстовые поля: AuroraTextField, AuroraTextFormField, AuroraSearchField;
  • интерактивные элементы: AuroraButton, AuroraSwitch, AuroraSlider, AuroraNavigationIndicatorButton, AuroraAppBarButton;
  • индикаторы: AuroraProgressCircle, AuroraProgressBar, AuroraBusyIndicator;
  • навигационные и декоративные элементы: AuroraPageRoute, AuroraScrollbar, AuroraScrollBehavior, AuroraSectionHeader;
  • верхнее меню AuroraAppBar;
  • всплывающее меню _AuroraPopupMenu, которое можно вызвать функцией openAuroraPopup.
• Возможности работы с темой приложения:
  • показать/спрятать нативный задний фон;
  • реагировать на смену атмосфер;
  • получать информацию о текущей атмосфере;
  • виджеты AuroraApp и AuroraTheme.
• Набор иконок и стилей для приложения.
• Демо-приложение со всеми реализованными компонентами.

Установка и использование

Чтобы использовать готовые компоненты в своем проекте, необходимо добавить пакет Aurora Controls в pubspec.yaml:

dependencies:
  aurora_controls: ^0.0.1

Чтобы получить доступ к платформенному функционалу, необходимо добавить плагин Aurora Window Manager в pubspec.yaml:

dependencies:
  aurora_window_manager: ^1.0.0

Сами пакеты располагаются в следующих директориях:

• Aurora Controls: /packages/aurora-controls
• Aurora Window Manager: /packages/aurora-window-manager

Использование иконок

Как было сказано выше, на иконки распространяется отдельная лицензия, которая ограничивает их использование. Подробнее с ней можно ознакомиться в пакете Aurora Controls по пути /assets/icons/LICENSE. Ввиду этих ограничений, для удобства разработчиков реализован следующий способ работы с ними:

• Класс AuroraIcons предоставляет возможность получить иконки как объекты типа IconData. Также он возвращает иконки из состава ОС Аврора, но только в том случае, если приложение запущено на ОС Аврора.
• Дополнительно можно настроить, какие иконки должен видеть пользователь, в случае, если приложение запущено на другой ОС.

Такое решение позволит разработчикам не волноваться, что они случайно нарушат правила использования ресурсов при разработке.

Демонстрационное приложение

Для более детального ознакомления с возможностями UI Kit, в пакете Aurora Controls присутствует демо-приложение. В нём можно протестировать компоненты и ознакомиться с их функциональностью. Приложение находится в директории example пакета Aurora Controls, найти его можно по пути /packages/aurora-controls/example.