Files
BotPages/docs/GETTING_STARTED.md

47 lines
1.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Быстрый старт с BotPages
Это руководство поможет быстро запустить demo?приложение с Telegram?адаптером.
Требования
- .NET 8 SDK
- Токен Telegram?бота (для demo)
Сборка
```bash
dotnet build
```
Запуск demo
1. Установите переменную окружения `TELEGRAM_TOKEN`:
```bash
setx TELEGRAM_TOKEN "<token>" # Windows
export TELEGRAM_TOKEN="<token>" # Linux/macOS
```
2. Запустите demo:
```bash
dotnet run --project Demo
```
Пример конфигурации приложения
```csharp
var app = new BotPagesApp(stateStorage, logger)
.AddTelegramAdapter(token)
.AddDefaultPage<WelcomePage>()
.MapCommand<WelcomePage>("/start")
.AddMiddleware(new LoggingMiddleware(logger));
await app.Build(CancellationToken.None);
```
Основные понятия
- `SendRequest` — единый формат запроса на отправку (текст, файлы, кнопки, адаптер?опции). Используйте `PageContext.SendAsync` для отправки.
- `Page` / `StatefulPage` / `SingletonPage` — модели страниц и их жизненный цикл.
- `IPageMiddleware` — middleware выполняется для каждого входящего обновления.
Далее: см. `docs/API_REFERENCE.md` для описания публичных API.