RTKar

RTKar — это Android-приложение для управления устройствами Ростелеком Ключ (двери, шлагбаумы), адаптированное для мультимедиа системы автомобиля Voyah Free

Требования

• Минимальный SDK: Android 9.0 (API 28)
• Целевой SDK: Android 14 (API 36)
• Java: JDK 11
• Gradle: 8.13.1

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

app/
├── src/
│   ├── main/
│   │   ├── java/com/ngerasimov/rtkar/
│   │   │   ├── data/              # Слой данных
│   │   │   │   ├── api/           # Модели API и обёртка
│   │   │   │   ├── repository/    # Реализация паттерна Repository
│   │   │   │   └── StorageManager.kt
│   │   │   ├── di/                # Модули внедрения зависимостей
│   │   │   ├── ui/                # Слой пользовательского интерфейса
│   │   │   │   ├── control/       # Экран управления
│   │   │   │   ├── login/         # Экран входа
│   │   │   │   └── settings/      # Экран настроек
│   │   │   ├── util/              # Вспомогательные классы
│   │   │   ├── MainActivity.kt
│   │   │   └── RTKarApplication.kt
│   │   └── res/                   # Ресурсы
│   ├── test/                      # Модульные тесты
│   └── androidTest/               # Инструментальные тесты
└── scripts/                       # Скрипты установки

Настройка

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

   git clone <repository-url>
   cd RTKar

2. Открыть в Android Studio

   • Откройте Android Studio
   • Выберите "Open an Existing Project"
   • Перейдите в директорию RTKar

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

   • Android Studio должен автоматически синхронизировать Gradle
   • Если нет, нажмите "Sync Now" при появлении запроса

4. Собрать проект

   ./gradlew build

Сборка

Отладочная сборка

./gradlew assembleDebug

Релизная сборка

./gradlew assembleRelease

Релизная сборка:

• Создаст APK с именем rtkar.apk
• Скопирует скрипты установки в выходную директорию (app/build/outputs/apk/release/)

Установка

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

1. Подключите Android-устройство через USB
2. Включите отладку по USB на устройстве
3. Запустите приложение из Android Studio (Shift+F10 или кнопка Run)

Использование скрипта установки (macOS/Linux)

1. Соберите релизный APK:

   ./gradlew assembleRelease

2. Перейдите в директорию с релизной сборкой:

   cd app/build/outputs/apk/release

3. Запустите скрипт установки:

   ./install_on_device.sh

   Примечание: Скрипт требует:

   • Включённую отладку по USB на устройстве
   • Совместимый USB-кабель (рекомендуется кабель A-A для Mac)
   • Инструмент ADB (включён в директорию scripts)

Конфигурация

Конечные точки API настроены в app/build.gradle.kts:

• Базовый URL API: https://household.key.rt.ru/
• URL реферера API: https://key.rt.ru/
• URL входа: https://key.rt.ru/main/pwa/dashboard

Для изменения этих параметров отредактируйте записи buildConfigField в блоке defaultConfig.

Лицензия

Лицензировано под Apache License, Version 2.0 (далее "Лицензия"); вы не можете использовать этот файл, кроме как в соответствии с Лицензией. Вы можете получить копию Лицензии по адресу

http://www.apache.org/licenses/LICENSE-2.0

Если это не требуется применимым законодательством или не согласовано в письменной форме, программное обеспечение, распространяемое по Лицензии, распространяется на условиях "КАК ЕСТЬ", БЕЗ ГАРАНТИЙ И УСЛОВИЙ ЛЮБОГО РОДА, явных или подразумеваемых. См. Лицензию для получения подробной информации о правах и ограничениях.