Ivan Fontosh
54 lines
2.7 KiB
Markdown
54 lines
2.7 KiB
Markdown
# Автообновления TTRPG Player
|
||
|
||
## Сборка и публикация
|
||
|
||
- Релизы собираются **локально** (без CI в Gitea).
|
||
- Файлы для выкладки кладутся в одну папку на Windows, затем заливаются на VPS (вручную `scp` или утилита **TTRPG Release Publisher** — в разработке).
|
||
- **Имена файлов без версии** — версия только в `latest*.yml`.
|
||
|
||
## URL feed
|
||
|
||
В `package.json` → `build.publish.url` должен быть реальный HTTPS-origin со **слэшем в конце**, например:
|
||
|
||
`https://updates.mailib.ru/`
|
||
|
||
Пока стоит заглушка `https://updates.invalid.ttrpg/` — автообновление в установленной сборке не заработает, пока не соберёте релиз с правильным URL.
|
||
|
||
## Фиксированные имена артефактов
|
||
|
||
| Платформа | Файлы |
|
||
|-----------|--------|
|
||
| Windows | `latest.yml`, `TTRPGPlayer-Setup.exe`, `TTRPGPlayer-Setup.exe.blockmap` |
|
||
| Linux | `latest-linux.yml`, `TTRPGPlayer-x64.AppImage`, `TTRPGPlayer-arm64.AppImage` |
|
||
| macOS | `latest-mac.yml`, `TTRPGPlayer-x64.dmg`, `TTRPGPlayer-arm64.dmg` (при двух архитектурах) |
|
||
|
||
Номер версии (`1.0.16`) — в поле `version` внутри `latest*.yml`, не в имени файла.
|
||
|
||
## Локальная сборка
|
||
|
||
```bash
|
||
npm ci
|
||
npm run build
|
||
npm run release:info # версия и пример тега vX.Y.Z (тег опционален, для git)
|
||
```
|
||
|
||
| Команда | Где запускать | Результат |
|
||
|---------|---------------|-----------|
|
||
| `npm run pack:win` | Windows | `release/` — Win + `latest.yml` |
|
||
| `npm run pack:linux` | Linux или WSL с зависимостями | `release/` — AppImage x64/arm64 + `latest-linux.yml` |
|
||
| `npm run pack:mac` | macOS | `release/` — dmg + `latest-mac.yml` |
|
||
|
||
Скопируйте нужные файлы из `release/` в папку публикации (например `D:\TTRPG-Release\`).
|
||
|
||
## Сервер обновлений
|
||
|
||
Статический VPS (nginx + HTTPS), каталог `/var/www/ttrpg-updates/`. Подробная пошаговая настройка — в переписке / отдельной инструкции для `updates.mailib.ru`.
|
||
|
||
## Лицензия
|
||
|
||
Проверка обновлений только при активной лицензии. Ключи на клиенте: `TTRPG-…` и устаревшие `DND-…`.
|
||
|
||
## Устаревшая схема
|
||
|
||
Git-репозиторий **`DndGamePlayerUpdates`** и CI-пуш артефактов **не используются**.
|