¶ Rox Premium — Техническая документация
Версия: 2.1.4 | Платформа: Android 11+ (API 30) | Разработчик: GW Club Team
¶ Описание продукта
Rox Premium — системное приложение для управления мультимедийными головными устройствами автомобилей Rox 01. Приложение работает на уровне системы Android с привилегиями android.uid.system, обеспечивая полный контроль над настройками устройства, управлением приложениями и интеграцией с автомобильными сервисами.
¶ Системные требования
| Параметр | Значение |
|---|---|
| Минимальная версия Android | 11.0 (API 30) |
| Целевой SDK | 35 |
| Архитектура | arm64-v8a |
| Минимальная версия системного патча | 1.6.1.5 |
| Подключение к интернету | Требуется для лицензирования и обновлений |
¶ Архитектура приложения
¶ Паттерн MVVM
Приложение построено на архитектуре MVVM (Model-View-ViewModel) с использованием Android ViewModel и LiveData для реактивного обновления UI.
¶ Многоэкранная поддержка
Rox Premium управляет несколькими дисплеями:
- Экран водителя (Display ID: 0)
- Потолочный экран пассажира (Display ID: 2)
¶ Основные компоненты
¶ Сервисы
| Сервис | Назначение |
|---|---|
DayNightService |
Автоматическое переключение день/ночь по датчику освещённости |
ProxyService |
Координация межкомпонентного взаимодействия |
ClusterService |
Управление приборной панелью (навигация, камеры скорости) |
SystemActivityMonitoringService |
Мониторинг разделённого экрана |
TaskManagerService |
Управление задачами приложений |
¶ BroadcastReceiver
| Ресивер | Назначение |
|---|---|
BootBroadcastReceiver |
Автозапуск при загрузке системы |
InstallReceiver |
Обработка установки/удаления приложений |
ActionsReceiver |
Обработка системных действий |
PackageReceiver |
Отслеживание изменений пакетов |
¶ Модули приложения
¶ Главный экран
Интерфейс разделён на боковую панель навигации (слева) и область содержимого (справа). В RTL-локалях (арабский) раскладка зеркалируется.
¶ 1. Общие настройки
Управление базовыми параметрами системы:
- Режим день/ночь — 4 варианта:
- Датчик света (автоматически по освещённости)
- Как в авто (синхронизация с системой автомобиля)
- День (принудительно светлая тема)
- Ночь (принудительно тёмная тема)
- Громкость поворотников — ползунок регулировки (1–15 уровней)
- Приборная панель — переключатели:
- Вывод навигации на приборную панель
- Показ камер скорости
- Вывод путевой информации
¶ 2. Настройки приложений
Индивидуальная настройка каждого установленного приложения:
- Переопределение плотности экрана (DPI)
- Масштабирование шрифтов
- Политика отображения на экранах
- Игнорирование жестов свайпа
- Загрузка/сохранение профилей на сервер
- Сброс к стандартным преднастройкам
¶ 3. Настройки разделения экрана
Управление профилями разделённого экрана (Split Screen):
- Создание, редактирование и удаление профилей
- Комбинации из 2–3 приложений на переднем экране
- Синхронизация профилей с облачным сервером
- Запуск сплит-профиля одним нажатием
¶ 4. Настройки кнопок и жестов
Конфигурация физических кнопок и сенсорных жестов:
Назначение кнопок:
- Кнопка «Домой» — одиночное, двойное и долгое нажатие
- Кнопка центра управления
- Кнопка настроек автомобиля
Жесты экрана водителя и пассажира:
- Одиночный/двойной тап
- Свайпы вверх/вниз/влево/вправо
- Сведение/разведение 3–4 пальцев (pinch)
Каждому действию можно назначить: запуск приложения, системное действие или сплит-профиль.
¶ 5. Настройки разрешений
Управление разрешениями на системном уровне:
- Глобальный переключатель установки приложений на системном уровне
- Индивидуальные разрешения для каждого приложения (70+ системных операций)
- Управление разрешением на установку из неизвестных источников для каждого приложения
¶ 6. Обновление приложений
Встроенный магазин приложений GW Club:
Категории:
- Системные приложения
- Навигация
- Мультимедиа
- Магазины приложений
- Опции
- Прочее
Возможности:
- Установка, обновление и удаление приложений
- Покупка лицензий через QR-код
- Обновление прошивки системы
¶ 7. Настройки системы
Системные функции:
- Открыть настройки Android
- Откалибровать инклинометр
- Оптимизация системы (DEX-перекомпиляция)
- Отправка системной диагностики
- Перезагрузка системы
¶ 8. Комфорт
Управление пресетами климата («комфорт»):
- Сохранение пресетов — снимок текущего состояния климата в именованный пресет: кондиционер, температура, направление обдува, рециркуляция, обогрев стекла, подогрев/вентиляция/массаж сидений, подогрев руля и зеркал
- Живой редактор — долгое нажатие на пресет открывает редактирование; каждое изменение сразу применяется к климату, а диалог отражает фактическое состояние через слушатель
CarPropertyManager, поэтому аппаратные взаимозависимости (выход из AUTO, подогрев против вентиляции) подтягиваются автоматически - Применение в одно касание — нажатие на пресет применяет его
- Привязка к управлению — пресет можно назначить на кнопку, свайп или жест
- Зеркалирование на приборку и синхронизация — настройки отражаются на приборной панели QNX и синхронизируются с сервером
Тише при звонке — переключатель в Общих настройках, который снижает обдув климата во время телефонного звонка и восстанавливает его по завершении.
ВИМАНИЕ! Данный функционал совместим только с версией ПО Rox 2.0.0. Для версий ПО ROX 1.6.x–1.7.x этот функционал недоступен. Также на данный момент неизвестно, будет ли данный функционал распространяться на массаж и вентиляцию капитанских сидений заднего ряда.
¶ 9. О программе
Информация о приложении и лицензии:
- Версия приложения и серийный номер устройства
- Данные лицензии (дата, email, версия прошивки)
- Список установленных премиум-опций
- Кнопка обновления лицензии
- Установка последнего системного патча
¶ Лицензирование
Приложение использует серверную систему лицензирования:
- При первом запуске отображается QR-код оплаты
- После оплаты лицензия загружается с сервера
gwm-club.ru - Лицензия привязана к серийному номеру устройства
- Дополнительные функции (Audio Pro, Ambient Lights, Voice Assistant) активируются отдельными лицензиями
¶ Серверная интеграция
Базовый URL: https://gwm-club.ru/api/v3/
Синхронизируемые данные:
- Лицензии и покупки
- Профили настроек приложений
- Конфигурации кнопок и жестов
- Профили разделения экрана
- Обновления прошивки и приложений
- Диагностические отчёты
¶ Безопасность
- Нативная библиотека шифрования (C/OpenSSL)
- Системная подпись приложения (
gw.keystore) - Верификация доверенных пакетов
- Лицензионный файл с привязкой к серийному номеру
Rox Premium v2.1.4 | GW Club Team 2024–2025. Все права защищены.