Files
umbrix/UPDATE_SERVER_GUIDE.md
Umbrix Developer 76a374950f feat: mobile-like window size and always-visible stats
- Changed window size to mobile phone format (400x800)
- Removed width condition for ActiveProxyFooter - now always visible
- Added run-umbrix.sh launch script with icon copying
- Stats cards now display on all screen sizes
2026-01-17 13:09:20 +03:00

5.1 KiB
Raw Blame History

🚀 Настройка Собственного Сервера Обновлений

Зачем это нужно?

Если ваш GitHub репозиторий приватный, приложение не может проверять обновления через GitHub API. Решение - использовать собственный сервер для выкатки обновлений.


📂 Где документация?

Вся документация находится в папке update-server/

Быстрый старт:

👉 update-server/QUICK_START.md - настройка за 5 минут

Подробная инструкция:

👉 update-server/README.md - полное руководство

Тестирование:

👉 update-server/TESTING.md - как тестировать локально


⚙️ Что нужно сделать?

Шаг 1: Настроить сервер

# Загрузите эти файлы на хостинг:
update-server/api.php           # главный скрипт
update-server/latest.json       # информация о версии
update-server/.htaccess         # настройки

Шаг 2: Изменить код приложения

Откройте lib/core/model/constants.dart:

// Замените на адрес вашего сервера
static const customUpdateServerUrl = "https://api.umbrix.net/api/latest";

// Включите собственный сервер
static const useCustomUpdateServer = true;

Шаг 3: Пересобрать приложение

flutter build apk --release

🧪 Как протестировать локально?

# Запустите тестовый сервер
cd update-server
./start_test_server.sh

# Сервер запустится на http://localhost:8000
# Для эмулятора используйте: http://10.0.2.2:8000/api.php

Затем:

  1. Откройте приложение
  2. Зайдите в Настройки → О программе
  3. Нажмите "Проверить обновления"

📦 Как выкатить новое обновление?

🎨 Вариант 1: Через веб-панель (проще!)

Есть красивый веб-интерфейс для управления!

  1. Откройте веб-панель:

    https://api.umbrix.net/admin/
    
  2. Заполните форму (все поля с подсказками)

  3. Нажмите "Сохранить обновление"

  4. Готово! 🎉

📖 Подробнее: update-server/admin/README.md


📝 Вариант 2: Вручную (классический способ)

  1. Соберите APK:

    flutter build apk --release
    
  2. Загрузите на сервер в папку downloads/

  3. Обновите файл latest.json:

    {
      "version": "2.5.8",
      "download_url": "https://api.umbrix.net/downloads/umbrix-2.5.8.apk"
    }
    
  4. Готово! Пользователи получат уведомление об обновлении


🔧 Переключение между режимами

Использовать GitHub (публичный репозиторий):

static const useCustomUpdateServer = false;

Использовать собственный сервер (приватный):

static const useCustomUpdateServer = true;

⚠️ После изменения обязательно пересоберите приложение!


📖 Структура файлов

update-server/
├── INDEX.md               ← Навигация по документации
├── README.md              ← Полная инструкция
├── QUICK_START.md         ← Быстрый старт
├── TESTING.md             ← Тестирование
│
├── api.php                ← Серверный скрипт
├── latest.json            ← Информация о версии
├── .htaccess              ← Настройки Apache
└── start_test_server.sh   ← Скрипт для тестирования

Готово!

Теперь вы можете:

  • Выкатывать обновления без магазинов приложений
  • Контролировать процесс релизов
  • Работать с приватным репозиторием
  • Тестировать бета-версии

📞 Нужна помощь?

Смотрите подробную документацию:


🚀 Удачи с обновлениями!