ExodeMiniApp — основной класс клиента. Один экземпляр на приложение. Все методы типизированы и возвращают Promise.
Создание экземпляра
Параметры конфигурации
Идентификатор мини-приложения, передаётся хосту при handshake. Для кастомных страниц
значение выбирается произвольно и нигде не регистрируется: хост доверяет приложению по origin адреса из поля
«URL приложения (iframe)».
Origin страницы школы, внутри которой открыто приложение, — например
https://my-school.exode.biz или ваш
собственный домен школы. SDK отправляет сообщения только на этот origin и принимает ответы только от него.
Если не указан, SDK берёт origin страницы, в которую встроен фрейм (location.ancestorOrigins, в Firefox —
referrer первой загрузки). Только если его не определить, остаётся * (любой origin) и SDK пишет
предупреждение в консоль. В продакшене указывайте origin явно.Таймаут handshake и команд (мс). По умолчанию
10000. Попапы (app.popup) ждут ответа пользователя без таймаута.SDK 0.4+. В приложении на телефоне фрейм уходит под шапку и нижнее меню хоста:
true — SDK даёт <body>
отступы по --exode-inset-*, 'manual' — отступы приложение делает само, false (по умолчанию) — хост кладёт
фрейм между своим хромом. См. Нативный вид.SDK 0.4+. Схема и цвета школы на странице:
color-scheme, класс dark на <html>, фон и цвет текста <body>
(стили приложения сильнее). По умолчанию false; у ExodeMiniAppProvider — true.Инициализация
MiniAppContext. Повторный вызов init() выбросит ошибку.
Если страница открыта без входа (опция «Доступна без входа»), handshake всё равно проходит, но ctx.user.id
равен 0, а персональные поля пустые — проверяйте ctx.user.id > 0, прежде чем показывать данные пользователя.
Если handshake не успел завершиться за
timeout мс — Promise отклоняется. Проверьте, что iframe открыт внутри Exode и targetOrigin корректен.Навигация (app.route)
path — это шаблон маршрута платформы (а не готовый URL), значения подставляются из params:
pageId). Текущий маршрут хоста в том же формате приходит в событии route:changed.
Когда приложение скрыто (пользователь ушёл на другую страницу или свернул окно), хост игнорирует команды
navigate, navigate:back и setTabbarVisible.UI-команды (app.ui)
minimize() работает только для страниц с типом окна «Плавающее окно», «Панель справа» или «Во весь экран»
(см. Кастомные страницы). Свёрнутое окно не выгружается —
приложение получает событие visibility:changed с visible: false и продолжает жить.На кастомных страницах школы команда setHeaderVisible сейчас не обрабатывается хостом и ничего не меняет.Promise команды разрешается, когда хост подтвердил получение. Хост подтверждает и те команды, которые
в текущем контексте ничего не делают, поэтому успешное выполнение Promise не гарантирует видимого эффекта.
Нативный хром (SDK 0.4+)
Хост умеет больше, чем навигация и snackbar: шапка с меню «…», «Назад», главная кнопка, поле ввода с микрофоном, попапы, вибрация, весь экран, ссылки и «Поделиться». В приложении Exode всё это нативное. Что умеет конкретный хост, показываетapp.isSupported(capability).
События (app.on)
Подписка на события хоста. Возвращает функцию отписки.Получение текущего контекста
init() возвращает контекст один раз. Для последующего доступа используйте getContext(): с SDK 0.4 bridge
применяет к нему события theme:changed, user:updated, school:updated, config:updated, viewport:changed и
context:updated, так что объект всегда актуален. Узнать о любом изменении контекста можно через
onContextChange(listener).
Завершение работы
postMessage, очищает обработчики событий. Вызывайте при размонтировании приложения.
Полный пример
Обновлено: 2026-10-22 23:06 UTC