Bedrud Документация

Десктопный клиент Bedrud - это нативное приложение для Windows и Linux, построенное на Rust и UI-фреймворке Slint. Оно предоставляет такой же базовый интерфейс видеоконференций, как веб- и мобильные клиенты, компилируясь в единый бинарник без зависимостей времени выполнения.

Стек технологий

КомпонентТехнология
ЯзыкRust (stable)
UI-фреймворкSlint 1.x
HTTP-клиентreqwest (async, TLS)
МедиаLiveKit Rust SDK
Хранилищеserde_json + OS keyring (libsecret / Windows Credential Store)
Система сборкиCargo workspace

Поддержка платформ

ПлатформаРендерерБинарник
Windows 10/11Direct3D 11bedrud-desktop.exe
Linux x86_64OpenGL / Vulkan (через EGL/Wayland/X11)bedrud-desktop
macOS(пока недоступно - используйте веб-приложение)-

Структура исходного кода

apps/desktop/
├── Cargo.toml              # Crate definition
├── build.rs                # Slint compile step
├── src/
│   ├── main.rs             # Entry point - initialises app + event loop
│   ├── app.rs              # Top-level AppState and startup logic
│   ├── api/
│   │   ├── client.rs       # Shared HTTP client (base URL, JWT injection)
│   │   ├── auth.rs         # Login, register, refresh
│   │   ├── rooms.rs        # Room list, join, create
│   │   └── admin.rs        # Admin endpoints
│   ├── auth/
│   │   ├── session.rs      # JWT storage and refresh loop
│   │   └── passkey.rs      # FIDO2 passkey stub
│   ├── livekit/
│   │   ├── room.rs         # Room connection lifecycle
│   │   ├── tracks.rs       # Audio/video track management
│   │   └── devices.rs      # Microphone / camera enumeration
│   ├── store/
│   │   ├── instance.rs     # Multi-instance persistence
│   │   └── settings.rs     # User preferences
│   └── ui/
│       ├── mod.rs
│       └── bridge.rs       # Slint ↔ Rust callback wiring
└── ui/
    ├── app.slint            # Root component, page router
    ├── theme.slint          # Colours, typography, spacing tokens
    ├── components/          # Button, Input, Card, Avatar
    ├── auth/                # Login and Register screens
    ├── dashboard/           # Room list, Create-room dialog
    ├── meeting/             # Controls bar, participant tiles, chat
    ├── admin/               # Admin panel, user table
    └── settings.slint       # Settings screen

Архитектура

flowchart TB
    subgraph UI ["Slint UI Layer"]
        direction TB
        SLINT[app.slint<br/>theme.slint<br/>components/ + screens]
    end
 
    subgraph Bridge ["Bridge Layer"]
        BRIDGE[ui/bridge.rs<br/>Slint ↔ Rust wiring]
    end
 
    subgraph Core ["Core Modules"]
        direction TB
        API[api/<br/>client.rs • auth.rs • rooms.rs • admin.rs]
        LIVEKIT[livekit/<br/>room.rs • tracks.rs • devices.rs]
        AUTH[auth/<br/>session.rs • passkey.rs]
        STORE[store/<br/>instance.rs • settings.rs]
    end
 
    SLINT -->|"callbacks /<br/>property bindings"| BRIDGE
    BRIDGE <-->|"async tasks<br/>+ Weak&lt;AppWindow&gt;"| Core
    API <--> LIVEKIT
    AUTH <--> STORE

Ключевые архитектурные решения

  • Компиляция UI во время сборки - файлы .slint компилируются в Rust на этапе сборки через build.rs. Движок разметки во время выполнения отсутствует; UI полностью нативный.
  • bridge.rs как единая граница UI↔логика - все callback-и Slint подключаются в одном месте, что отделяет бизнес-логику от UI-слоя и упрощает аудит моста.
  • Weak<AppWindow> в callback-ах - дескрипторы UI Slint не являются Send, поэтому фоновые задачи обновляют сохранённую Weak-ссылку в UI-потоке для установки свойств, вместо передачи дескриптора между потоками.
  • Несколько экземпляров через store/instance.rs - аналогично мобильным приложениям: экземпляры сериализуются в JSON-файл в конфигурационной директории ОС; каждый экземпляр имеет собственные APIClient и AuthSession.

Локальная сборка

Необходимые компоненты

  • Стабильная версия Rust (rustup toolchain install stable)

  • Linux: libfontconfig, libxkbcommon, libwayland, libgles2, libdbus, libsecret

    sudo apt-get install -y \
      libfontconfig1-dev libxkbcommon-dev libxkbcommon-x11-dev \
      libwayland-dev libgles2-mesa-dev libegl1-mesa-dev \
      libdbus-1-dev libsecret-1-dev \
      libasound2-dev
  • Windows: Visual Studio Build Tools (MSVC) с рабочей нагрузкой C++

Сборка

# Debug build (fast compile, no optimisations)
make dev-desktop          # runs the app immediately after build
 
# Release build
make build-desktop        # → target/release/bedrud-desktop (Linux)
                           # → target/release/bedrud-desktop.exe (Windows)

Или напрямую через Cargo:

cargo build -p bedrud-desktop                          # debug
cargo build -p bedrud-desktop --release                # optimised
cargo run   -p bedrud-desktop                          # run immediately

CI

Десктопное приложение собирается в CI при каждом пуше в main и в pull-реквестах:

ЗадачаСреда выполненияЧто проверяет
Desktop – Build & Testubuntu-latestcargo build, cargo test

Release-сборки создают два артефакта:

АртефактСредаФормат
bedrud-desktop-linux-x86_64.tar.xzubuntu-latesttar.xz
bedrud-desktop-windows-x86_64.zipwindows-latestzip