Привет! Наткнулся на интересную , где разработчики из Яндекса рассказывают, как они создали свой пакет для навигации во Flutter. Проблема знакомая: проект растет, появляются табы, вложенные модули, диплинки, а стандартные решения перестают работать. В итоге они написали свое решение и поделились им со всеми.
В чем суть:
Основная идея yx_navigation в том, что состояние навигации - это не стек, а дерево узлов RouteNode. Каждый узел содержит маршрут, параметры и список дочерних узлов. Все просто: добавил узел - экран появился, убрал - исчез.
Какую проблему решает:
Мутация неактивных ветвей. Ключевая фича. Пользователь во вкладке «Сообщения», а в это время прилетает заказ. Его нужно добавить во вкладку «Заказы», но без переключения на нее. В go_router это невозможно - любой переход переключает вкладку. В yx_navigation можно получить контроллер, привязанный к неактивной ветке, и выполнить push из бизнес-логики.
Управление навигацией без BuildContext. Большинство пакетов требуют context для переходов. Интерактор, обрабатывающий push-уведомление, контекста не имеет. В yx_navigation можно создать менеджер состояния заранее и управлять навигацией откуда угодно.
Изоляция фич. Фича подключается одной строкой. Хост не знает о внутренних маршрутах фичи, фича - о хосте. Команды могут работать независимо.
Совместимость с легаси-кодом. Старый код на Navigator.push(), showDialog() продолжает работать. Compatibility Layer адаптирует вызовы к новой модели.
Дружелюбие к разработчику. Встроенная debug-панель показывает дерево состояния в реальном времени, историю мутаций и сериализованное состояние в URL.
Коротко о технике:
Пакет разделен на две части, чтобы бизнес-логика не зависела от Flutter. yx_navigation - это ядро на чистом Dart: описание маршрутов, дерево состояния RouteNode, мутации (добавление и удаление узлов), guards для проверки переходов, сериализация состояния в URL. Все это можно покрыть unit-тестами без запуска приложения. yx_navigation_flutter - Flutter-обвязка, которая превращает состояние в реальные экраны: виджеты-адаптеры, RouterDelegate, RouteInformationParser, PageFactory для кастомных анимаций и переходов.
При этом никакой кодогенерации - не нужно каждый раз запускать build_runner и ждать, пока сгенерируются файлы.
Вывод:
yx_navigation - не очередная обертка над Navigator 2.0, а решение, выросшее из реальных проблем крупного проекта. Пакет подойдет тем, кто уперся в ограничения go_router, кому надоело ждать кодогенерацию в auto_route и кто хочет управлять навигацией без привязки к UI и менять состояние даже в неактивных вкладках.
