zSupport

Описание

zSupport - Android-приложение для управления системными настройками автомобильных головных устройств на платформе Zeekr. Приложение предназначено для упрощения доступа к различным системным функциям и настройкам, которые обычно сложно достичь через стандартный интерфейс.

Основные возможности

• Изменение языка системы: быстрое переключение между английским и китайским языками
• Управление часовым поясом: изменение часового пояса системы с возможностью временного или постоянного применения
• Управление приложениями: очистка кэша, данных и принудительная остановка приложений
• Переключение режимов USB: переключение между режимами Host, Peripheral и AUTO
• Выбор клавиатуры: доступ к настройкам клавиатуры системы
• Управление разрешениями: автоматическая выдача системных разрешений для популярных приложений

Требования

• Android 5.0 (API 21) или выше
• Системные права (приложение должно быть установлено как системное с sharedUserId="android.uid.system")
• Целевая платформа - автомобильные головные устройства Zeekr

Установка

Для установки приложения необходимо:

1. Загрузить последнюю версию APK из раздела Releases
2. Установить приложение с системными правами (требуется рут-доступ или установка через инженерное меню)

Архитектура приложения

Приложение построено с использованием следующих компонентов:

• MainActivity - главная активность, содержащая основной UI и инициализацию компонентов
• Helper классы - набор утилитарных классов для работы с различными системными функциями:
  • TimeZoneHelper - управление часовыми поясами
  • SystemHelper - системные функции (перезагрузка, версия приложения)
  • PermissionsHelper - управление разрешениями приложений
  • KeyboardManager - управление клавиатурами
  • SwitchUSBHelper - управление режимами USB
  • AppHelper - функции управления приложениями
  • UIHelper - вспомогательные функции UI

Сборка проекта

Требования для сборки

• Android Studio Chipmunk (2021.2.1) или новее
• Java Development Kit (JDK) 11
• Gradle 7.4.2 или выше

Шаги для сборки

1. Клонировать репозиторий:

   git clone https://github.com/CarWizard/zSupport.git

2. Открыть проект в Android Studio

3. Синхронизировать Gradle

4. Выполнить сборку проекта:

   ./gradlew assembleRelease

5. Готовый APK-файл будет доступен в папке app/build/outputs/apk/release/

Использование

После запуска приложения:

1. Прочитайте и примите соглашение, установив флажок "I Agree"
2. Используйте соответствующие кнопки для выполнения нужных действий:
   • Кнопки "CHINESE" и "ENGLISH" для изменения языка системы
   • Поле выбора часового пояса и кнопка применения для изменения часовой зоны
   • Переключатель USB режимов для изменения поведения USB порта
   • Выпадающий список приложений и кнопки действий для управления ими

Важные технические особенности

• Приложение использует рефлексию для доступа к системным API
• Поддерживается полноэкранный режим и альбомная ориентация
• Реализована обработка событий загрузки устройства для восстановления настроек
• Использует корутины Kotlin для асинхронных операций

Предупреждение

Приложение имеет доступ к системным настройкам и может оказать влияние на работу устройства. Используйте с осторожностью. Некорректное использование может привести к:

• Неправильной работе приложений
• Проблемам с обновлением системы
• Другим непредвиденным последствиям

Вклад в разработку

Вклады в проект приветствуются! Если вы хотите внести улучшения:

1. Сделайте форк репозитория
2. Создайте ветку для вашей функции (git checkout -b feature/amazing-feature)
3. Зафиксируйте ваши изменения (git commit -m 'Add some amazing feature')
4. Отправьте изменения в ваш форк (git push origin feature/amazing-feature)
5. Откройте Pull Request

Лицензия

Этот проект распространяется под лицензией Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0). Эта лицензия позволяет:

• Делиться: копировать и распространять материал на любом носителе и в любом формате
• Адаптировать: ремикшировать, трансформировать и создавать на основе материала

При соблюдении следующих условий:

• Attribution (Атрибуция): Вы должны предоставить соответствующий кредит, указать ссылку на лицензию и указать, были ли внесены изменения.
• NonCommercial (Некоммерческое использование): Вы не можете использовать материал в коммерческих целях.
• ShareAlike (На тех же условиях): Если вы ремикшируете, трансформируете или создаете на основе материала, вы должны распространять ваши материалы под той же лицензией, что и оригинал.

Подробная информация о лицензии доступна по адресу: https://creativecommons.org/licenses/by-nc-sa/4.0/

Контакты

Если у вас есть вопросы или предложения, пожалуйста, откройте issue в этом репозитории.