umbrix/BUILD_REPORT.md

📦 Umbrix v1.7.0 - Professional Build Report

Дата сборки: 17 января 2026
Версия: 1.7.0+170
LibCore: Custom v1.7.0 (49MB) с полным FFI интерфейсом

---

✅ Собранные пакеты

📱 Portable Bundle

• Расположение: build/linux/x64/release/bundle/
• Запуск: ./run-umbrix.sh или ./bundle/umbrix
• Размер: ~52MB (распакованный)
• Компоненты:
  • ✓ umbrix (24KB) - исполняемый файл
  • ✓ libcore.so (49MB) - кастомный с parse() функцией
  • ✓ HiddifyCli (1.5MB) - CLI утилита
  • ✓ umbrix.png (296KB) - иконка приложения
  • ✓ data/ - директория для БД и конфигов
  • ✓ lib/ - все Flutter и plugin библиотеки

📦 DEB Package (Debian/Ubuntu)

• Файл: dist/1.7.0+170/umbrix-1.7.0+170-linux.deb
• Размер: 28MB
• Установка: sudo dpkg -i umbrix-*.deb
• Расположение после установки: /usr/share/umbrix/
• Десктоп файл: /usr/share/applications/umbrix.desktop
• Проверка libcore: ✅ 49MB (кастомный)

📦 RPM Package (Fedora/RedHat/CentOS)

• Файл: dist/1.7.0+170/umbrix-1.7.0+170-linux.rpm
• Размер: 35MB
• Установка: sudo rpm -i umbrix-*.rpm
• Расположение: /usr/share/umbrix/
• Проверка libcore: ✅ 49MB (кастомный)

📦 AppImage (Универсальный)

• Файл: dist/1.7.0+170/umbrix-1.7.0+170-linux.AppImage
• Размер: 37MB
• Запуск: chmod +x umbrix-*.AppImage && ./umbrix-*.AppImage
• Преимущества:
  • Один файл
  • Не требует установки
  • Работает на любом Linux с FUSE
• Проверка libcore: ✅ 49MB (кастомный)

---

🔧 Технические детали

Кастомный LibCore

• Источник: Собран из libcore/ v1.7.0
• Функции: parse(), parseCli() - полный FFI интерфейс
• Интеграция: Автоматически заменяется во всех пакетах
• Проверка: strings libcore.so | grep -i "parse\|ffi"

База данных

• Расположение: ~/.local/share/umbrix/ (при первом запуске)
• ExtensionData: Опциональная (не вызывает ошибок при отсутствии)
• Структура: LevelDB формат

Иконка и Desktop Entry

• Иконка: ic_launcher_playstore.png (512x512)
• Desktop файл: umbrix.desktop
• Категории: Network
• MIME типы: x-scheme-handler/clash, x-scheme-handler/sing-box

---

🚀 Способы установки

1. Portable (без установки)

cd ~/dorod/hiddify-umbrix-v1.7.0
./run-umbrix.sh

2. DEB (Ubuntu/Debian)

sudo dpkg -i dist/1.7.0+170/umbrix-1.7.0+170-linux.deb
umbrix

3. RPM (Fedora/RedHat)

sudo rpm -i dist/1.7.0+170/umbrix-1.7.0+170-linux.rpm
umbrix

4. AppImage (любой Linux)

chmod +x dist/1.7.0+170/umbrix-1.7.0+170-linux.AppImage
./umbrix-1.7.0+170-linux.AppImage

---

✨ Особенности сборки

Профессиональная упаковка

• ✅ Кастомный libcore во всех форматах
• ✅ Правильная структура директорий
• ✅ Desktop integration (иконка, MIME types)
• ✅ Опциональная БД (без ошибок при отсутствии)
• ✅ Скрипт автозапуска (run-umbrix.sh)

UI Improvements

• ✅ Мобильный размер окна (400×800)
• ✅ Статистика трафика всегда видна
• ✅ Phone-like вертикальный layout

Исправленные проблемы

• ✅ "undefined symbol: parse" - решено через кастомный libcore
• ✅ ExtensionData спам (100 retry) - сделано опциональным
• ✅ Отсутствие статистики - всегда отображается
• ✅ Широкое окно - изменено на узкое (телефон)

---

📋 Команды для разработчиков

Пересборка всех пакетов

./build-all-packages.sh

Только Flutter bundle

flutter build linux --release

Проверка libcore в пакетах

# DEB
dpkg-deb -x dist/1.7.0+170/*.deb /tmp/test && du -h /tmp/test/usr/share/umbrix/lib/libcore.so

# RPM
rpm2cpio dist/1.7.0+170/*.rpm | cpio -idm && du -h usr/share/umbrix/lib/libcore.so

# AppImage
dist/1.7.0+170/*.AppImage --appimage-extract && du -h squashfs-root/lib/libcore.so

---

🎯 Итог

Все форматы собраны профессионально:

• ✅ DEB - 28MB - готов к установке
• ✅ RPM - 35MB - готов к установке
• ✅ AppImage - 37MB - готов к запуску
• ✅ Portable Bundle - готов к запуску

Кастомный libcore 49MB интегрирован во все пакеты!

База данных создаётся автоматически при первом запуске.

Запуск без установки: ./run-umbrix.sh или AppImage