Donutgramплагины
На этой страницеРабочий процесс

Разработка и сборка

Повторяемый цикл изменений, проверки, упаковки и установки на устройстве.

Рабочий процесс

Пишите код на компьютере, проверяйте пакет CLI и устанавливайте собранный документ в Donutgram. Для тестирования логики примеров доступен отдельный mock-хост.

Проверить проект

python tools/dgplugin.py validate my-plugin
python tools/dgplugin.py compatibility my-plugin

Исправляйте ошибки манифеста и файлов до сборки. Статическая проверка не выполняет activate и не подтверждает работу нативного интерфейса.

Собрать архив

python tools/dgplugin.py pack my-plugin my-plugin.dgplugin
python tools/dgplugin.py validate my-plugin.dgplugin

Сохраняйте готовые сборки вне папки исходников плагина. Если положить предыдущий .dgplugin внутрь проекта, он станет неподдерживаемым вложенным архивом.

Установить на устройство

Отправьте документ в избранное и нажмите на него в Donutgram. Проверьте название, описание и версию. Выберите, включать ли плагин после установки.

Настройки, отправка файла в чат и удаление доступны в карточке плагина. Общий переключатель ставит выполнение на паузу, не стирая индивидуальные состояния включения.

Проверить поведение

  • Обычное действие и отсутствие нужного контекста.
  • Выключение, повторное включение и общая пауза.
  • Другой аккаунт, фон приложения и энергосбережение.
  • Большой текст, пустой результат и ошибка нативного метода.
  • Смена темы и размера шрифта для своей страницы.

Обновить пакет

Измените version по SemVer, сохраните id и опишите изменения в changelog. Затем соберите и откройте новый файл. Изменение только build-метаданных версии не делает пакет более новым.

Автоперезагрузка

SDK не предоставляет публичный dev-сервер, ADB-протокол или watch-команду. Повторная упаковка и установка новой версии — поддерживаемый цикл разработки. Не загружайте исполняемый код из сети самостоятельно.