ScuroNeko/Laniakea
1
1
Fork 0
Code Issues 1 Pull Requests Actions Packages Releases 27 Wiki Activity
REPOSITORY / ScuroNeko/Laniakea

Wiki

KNOWLEDGE REPOSITORY
Page: Migration RU
Pages
AGENTS Auto Generated Commands RU Auto Generated Commands Bot Lifecycle RU Bot Lifecycle Bot Options and Configuration RU Bot Options and Configuration Commands and Plugins RU Commands and Plugins Drafts RU Drafts Error Handling RU Error Handling Framework Backlog RU Framework Backlog Getting Started RU Getting Started Home RU Home Inline Keyboards and Payloads RU Inline Keyboards and Payloads Localization RU Localization Logging RU Logging MessageContext RU MessageContext Middleware RU Middleware Migration RU Migration Policies RU Policies Rate Limiting RU Rate Limiting Recipes RU Recipes Rich Messages RU Rich Messages Runners RU Runners Scenes RU Scenes Semver and Releases RU Semver and Releases Sentry Integration RU Sentry Integration Testing Bots with Laniakea RU Testing Bots with Laniakea Update Routing Model RU Update Routing Model V2 Migration Plan RU V2 Migration Plan Webhook Runtime RU Webhook Runtime tgapi Overview RU tgapi Overview
Clone
4
Migration RU
ScuroNeko edited this page 2026-08-19 14:59:10 +03:00
Table of Contents

Migration RU

English version: Migration

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

Как пользоваться этой страницей

Используй ее как карту основных изменений между rc-версиями.

Особенно полезно смотреть вместе с:

Что важно помнить при апгрейде

  • Сначала прочитай CHANGELOG.md.
  • Потом проверь модель выполнения, если затрагивались Bot, плагины или обработчики.
  • После этого отдельно пройди по данным callback, черновикам и генерации команд, если используешь эти части API.

Ключевые изменения последних rc

rc.12

Главный смысл релиза:

  • обработчики стали возвращать error;
  • появились вспомогательные методы для длинных ответов;
  • появился строгий режим обработки данных callback.

Что обычно нужно менять:

  • перевести обработчики на сигнатуру с возвратом error;
  • если длинные ответы могли выходить за Telegram limit, перейти на AnswerLong(...) или KeyboardLong(...);
  • если политика данных callback важна, решить, нужен ли строгий режим.

rc.10

Главные изменения:

  • NewBot[T](opts) теперь возвращает (*Bot[T], error);
  • Run() и RunWithContext(...) возвращают error;
  • AddPlugins(...) стал точкой фиксации конфигурации.

Что обычно нужно менять:

  • добавить error handling после NewBot, Run, RunWithContext;
  • перестать менять плагины после регистрации.

rc.7

На этой стадии заметно укрепился жизненный цикл плагинов:

  • logger APIs;
  • хуки остановки;
  • Plugin.Close().

rc.4

Ранние изменения в основном затрагивали общую структуру API и набор вспомогательных методов.

Практическая стратегия миграции

  1. Сначала собери проект.
  2. Исправь signature-level ошибки.
  3. Проверь поведение во время выполнения: запуск, остановку, плагины.
  4. Отдельно прогоняй callbacks, middleware и длинные ответы.
  5. Добавь regression tests под найденные переломы.

Что читать дальше

Navigation

Start here

Runtime and Architecture

Interaction and Telegram API

Practical Guides

Maintenance