grendervill
72c5189e8f
Три пункта спецификации клиента (docs/client-tauri.md §5), которые оставались открытыми в обёртке: - **Клик по уведомлению → переход в канал.** У `tauri-plugin-notification` на desktop нет колбэка действия, поэтому реализовано лучшее доступное поведение: уведомление, показанное при неактивном окне, запоминается, и когда приложение активируется в течение 10 секунд (окно получило фокус или macOS прислала `RunEvent::Reopen`), окно поднимается и открывается комната из уведомления — `glchat://guild/<id>/channel/<id>`, для личной беседы `glchat://dm/<id>`. Идентификаторы проверяются (только цифры), чтобы из текста уведомления нельзя было собрать произвольный deep link. Ограничение: ОС не сообщает, что активация вызвана именно кликом, поэтому переход сработает и при обычном возврате в приложение в эти 10 секунд — это описано в desktop/README.md; - **Выход при несохранённых изменениях.** Клиент сообщает о правках командой `desktop_set_dirty`; закрытие окна и пункт «Выход» в трее перехватываются (`window::request_close_confirmation`), окно best-effort покачивается (`Window::set_position`, на Wayland молча пропускается), а решение принимает пользователь в диалоге клиента «Сохранить / Выйти без сохранения»; закрывает приложение команда `desktop_close_window`. Раньше выход из трея терял правки молча; - **Ctrl/Cmd+K.** Комбинация регистрируется глобально (`shortcuts.rs`) и при неактивном окне поднимает окно и просит клиент открыть палитру команд (`WebMessage::OpenPalette`); повторы комбинаций с настраиваемыми шорткатами отсекаются по разобранной комбинации, иначе вторая регистрация падала бы. Заодно: `updates.rs` получил тест, который разбирает манифест релиза типом самого `tauri-plugin-updater` (`RemoteRelease`) — он ловит расхождение формата (например, дату не в RFC 3339), из-за которого обновление молча не приходило бы. Проверки: `make desktop-check` (fmt, clippy, 10 тестов).
desktop — desktop-обёртка glchat (Tauri 2)
Тот же веб-клиент из web/, обёрнутый в Tauri 2 (docs/client-tauri.md). Отдельного
UI-кода нет: страница инстанса загружается в системный webview, а обёртка даёт
платформенную интеграцию — трей, нативные уведомления, глобальный push-to-talk,
автозапуск, deep links и автообновление.
desktop/
└── src-tauri/ # Rust-проект обёртки
├── src/ # окно, трей, шорткаты, уведомления, deep links, обновления
├── capabilities/ # allowlist IPC: локальная страница настроек и домен инстанса
├── ui/ # локальная страница настроек обёртки (tauri://localhost)
├── icons/ # иконки приложения (сгенерированы из web/public/icons)
└── tauri.conf.json # конфигурация сборки и плагинов
Сборка и запуск
make desktop-check # cargo fmt --check, clippy, тесты (кэш в .cache/)
make desktop-build # бандлы текущей ОС (macOS: .app и .dmg)
open desktop/src-tauri/target/release/bundle/macos/glchat.app
Требуется Rust 1.77+ и Node 22 (Tauri CLI ставится через npx). Кэши cargo и
npm держатся в .cache/ — как у остальных инструментов проекта.
Сборка релиза с артефактами автообновления использует ключ подписи:
# ключ и пароль не коммитятся: приватный ключ живёт в CI-секретах,
# локально — в build/desktop-keys/ (каталог build/ в .gitignore)
npx @tauri-apps/cli@^2 signer generate -w build/desktop-keys/glchat-updater.key -p '…'
make desktop-build
Публичный ключ уже вписан в src-tauri/tauri.conf.json и в UPDATER_PUBKEY
(src/updates.rs). Без локального ключа make desktop-build собирает бандл без
артефактов обновления, чтобы сборка не падала у тех, у кого ключа нет.
Аргументы командной строки
| Аргумент | Что делает |
|---|---|
--instance <url> |
адрес инстанса вместо сохранённого (--instance=https://… тоже работает) |
--minimized |
запуск свёрнутым в трей (используется автозапуском) |
--settings |
сразу открыть страницу настроек обёртки |
--autostart on|off |
включить или выключить автозапуск при установке скриптом |
Настройки
Хранятся в settings.json каталога конфигурации приложения
(~/Library/Application Support/su.mhspx.glchat/ на macOS):
| Ключ | Смысл |
|---|---|
instanceUrl |
адрес клиента, по умолчанию https://gl.mhspx.su |
closeToTray |
закрытие окна сворачивает приложение в трей |
autostart |
запуск при входе в систему (--minimized) |
notifications |
показывать системные уведомления |
pttShortcut, muteShortcut, deafenShortcut |
глобальные комбинации (пусто — выключено) |
Меняются из меню трея и со страницы настроек обёртки (трей → «Настройки обёртки…»). Сессия и токены живут только в cookie webview: обёртка их не хранит.
Deep links
Схема glchat:// (регистрируется бандлом):
glchat://invite/<code>→ страница приглашения;glchat://guild/<guildId>/channel/<channelId>→ сервер и комната.
Ссылка, пришедшая до загрузки клиента (холодный старт), ждёт в очереди и
доставляется после desktop_ready.
Что не сделано (открытые пункты Фазы 6)
- Манифест обновлений на сервере:
GET /updates/{target}/{arch}/{current_version}ещё не публикуется — нужна статика на стороне инстанса (Caddy) и релизный контур с приватным ключом в CI. Клиентская часть готова: подпись проверяется, downgrade отклоняется, при недоступном манифесте ошибка только логируется. - Клик по уведомлению → открытие канала: у
tauri-plugin-notificationнет колбэка действия на desktop, нужен свой мост кUNUserNotificationCenter. - Аватары в уведомлениях (thumb/буква) и группировка — сейчас иконка приложения.
- Захват экрана и микрофон: разрешения macOS выдаёт webview, отдельных экранов-инструкций у обёртки нет.
- Подпись и нотаризация сборки macOS/Windows: Developer ID/EV только в CI.
- Windows/Linux-бандлы: конфигурация кросс-платформенная, но собирались и проверялись только macOS-arm64.