Обновления VK Mini Apps Router: новые версии VK Bridge, VKUI и улучшения навигации

Что нового в VK Mini Apps Router?

Последние обновления VK Mini Apps Router привнесли ряд улучшений, направленных на повышение стабильности и расширение возможностей навигации в VK Mini Apps. Основные изменения включают:

Поддержка новых версий: Добавлена совместимость с @vkontakte/vkbridge версии v3.0.0 и @vkontakte/vkui версий v8.0.0, v7.0.0, v6.0.0.

Улучшения навигации: Исправлены ошибки, связанные с обработкой прямых ссылок, в том числе на корень приложения без hashфрагмента, а также проблемы с использованием прямых ссылок на страницы с hashParamRouter.

Управление состоянием: Метод showModal теперь поддерживает опциональный параметр state для передачи дополнительных данных при открытии модального окна. Значения ключей showModal и blockForwardNavigation в state устанавливаются автоматически.

Работа с историей: Устранены проблемы с заполнением истории при переходах на промежуточные маршруты и при многократном использовании хука useParams с жестом SwipeBack.

Новые возможности API: Добавлен хук useHistoryManager для доступа к интерфейсу истории переходов. Метод hideModal расширен для открытия модального окна без добавления записи в историю. Реализована возможность блокировки перехода со страницы с помощью RouteNavigator.block(onLeave: BlockerFunction).

Настройка обработки 404: Расширены возможности настройки поведения при отсутствии маршрута: теперь можно выбирать между показом 404страницы или переходом на указанный путь (notFoundRedirectPath).

Смена доменных имен: Все адреса изменены с vk.com на vk.ru (dev.vk.com → dev.vk.ru).

Важные изменения и исправления:

v1.8.6: Обновлены peer зависимости, добавлена поддержка @vkontakte/vkbridge v3.0.0.

v1.8.5: Обновлены peer зависимости, добавлена поддержка @vkontakte/vkui v8.0.0.

v1.8.4: Исправлена обработка прямых ссылок на корень приложения без hashфрагмента.

v1.8.1: Адреса изменены с vk.com на vk.ru.

v1.8.0: Метод showModal теперь принимает опциональный параметр state.

v1.7.6: Устранены проблемы с заполнением истории при переходах на промежуточные маршруты.

v1.7.5: Устранены проблемы c использованием прямых ссылок на страницы с hashParamRouter.

v1.7.2: Устранены проблемы, связанные с работой runSync при большом количестве переходов.

v1.7.0: Добавлен хук useHistoryManager.

v1.6.0: Расширены параметры метода hideModal.

v1.5.0: Добавлена возможность передавать hash и параметры поиска, усилена валидация.

v1.4.6: Устранены проблемы с работой runSync.

v1.4.5: Исправлена проблема с синхронизацией состояния роутера.

v1.4.4: Добавлен экспорт типа SetURLSearchParams.

v1.4.3: Добавлена проверка платформы в useEnableSwipeBack, обновлены props типы у RouterLink.

v1.4.2: Обновлены peer зависимости, добавлена поддержка @vkontakte/vkui v6.0.0.

v1.4.0: Избавление от UNSAFE методов @remixrun/router, добавлен useBlocker.

v1.3.2: Исправлена навигация при использовании тега base и совместимость с Vite NX.

v1.3.1: Исправлена проблема UNSAFEgetPathContributingMatches.

v1.3.0: Починен скролл при возврате по истории.

v1.2.0: Добавлена возможность блокировать переход (RouteNavigator.block), пробрасывать state в NavigationOptions, настроить обработку 404маршрутов.

v1.1.0: Добавлен createHashParamRouter для навигации по параметрам хэша, что полезно для UTMметок.

v1.0.9: Добавлен компонент для генерации ссылок .

Актуальная документация доступна по адресу: https://dev.vk.ru/libraries/router.

Полезно: документация или схема помогают быстрее заметить новые возможности и уточнения API.

Риск: изменение контракта может потребовать правок в интеграции, генерации типов или пользовательских сценариях.