Files
umbrix/update-server/QUICK_START.md

114 lines
3.1 KiB
Markdown
Raw Normal View History

# ⚡ Быстрый Старт - 5 минут
Минимальная инструкция для тех, кто хочет запустить быстро.
## 🎯 Что делать (по шагам)
### 1⃣ Загрузите файлы на хостинг
Через FTP/панель хостинга загрузите эти 4 файла:
```
📁 Ваша папка на сервере (например: /var/www/updates/)
├── api.php ← главный файл
├── latest.json ← информация о версии
├── .htaccess ← настройки
└── downloads/ ← создайте пустую папку
```
---
### 2⃣ Настройте домен
В панели хостинга:
1. Создайте поддомен: `api.umbrix.net` (или любое имя)
2. Укажите папку: `/var/www/updates`
3. Включите SSL (Let's Encrypt бесплатно)
---
### 3⃣ Измените `latest.json`
Откройте файл `latest.json` и замените:
```json
{
"version": "2.5.7",
"download_url": "https://api.umbrix.net/downloads/umbrix-2.5.7.apk",
↑↑↑ замените на свой домен
```
---
### 4⃣ Измените код приложения
Откройте файл `lib/core/model/constants.dart`:
```dart
// Было:
static const customUpdateServerUrl = "https://your-server.com/api/updates/latest";
// Стало (ваш домен):
static const customUpdateServerUrl = "https://api.umbrix.net/api/latest";
// Включаем собственный сервер:
static const useCustomUpdateServer = true;
```
---
### 5⃣ Пересоберите приложение
```bash
flutter build apk --release
```
---
### 6⃣ Загрузите APK на сервер
1. Найдите APK: `build/app/outputs/flutter-apk/app-release.apk`
2. Переименуйте в: `umbrix-2.5.7.apk`
3. Загрузите в папку `downloads/` на сервере
---
### 7⃣ Проверьте
Откройте в браузере:
```
https://api.umbrix.net/api/latest
```
Должны увидеть JSON с версией.
---
## ✅ Готово!
Теперь когда выйдет новая версия:
1. Соберите новый APK
2. Загрузите в `downloads/`
3. Обновите `latest.json` (версию и URL)
4. Всё! Пользователи получат уведомление
---
## ❓ Не работает?
### Проверьте:
- ✅ HTTPS включен
- ✅ Файлы загружены в правильную папку
- ✅ URL в `constants.dart` правильный (с `https://`)
- ✅ Приложение пересобрано после изменений
### Частые ошибки:
- Забыли пересобрать приложение
- Опечатка в URL
- Нет SSL сертификата
- Версия в `latest.json` меньше или равна текущей
---
**📖 Подробная инструкция:** см. файл `README.md`