**ВТостерс Lite** — это модифицированный клиент официального ВКонтакте, основанный на версии **5.56.1 (4838)**
* Вы можете предложить свои идеи/сообщить о багах в [Issues](https://github.com/vtosters/lite/issues)
* Скачивать самые актуальные версии можно с [Actions](https://github.com/vtosters/lite/actions)
(могут содержать баги)
* Стабильные сборки находятся в [Releases](https://github.com/vtosters/lite/releases)
Зеркало на нашем [ Git](https://git.maki.su/gdlbo/lite)
### Быстрая навигация
* [Функциональность](#функциональность)
* [Отладка приложения](#отладка-приложения)
* [Разработка](#разработка)
* [Всё необходимое для сборки и компиляции](#всё-необходимое-для-сборки-и-компиляции)
* [Необходимые зависимости](#необходимые-зависимости)
* [Linux/macOS](#linuxmacos)
* [Windows](#windows)
## Функциональность
* Дизайн из новых версий ВК (Milkshake)
* Нет рекламы и ограничений на ленту и музыку
* Интеграция с <а href="https://vkx.app/">VKX и LAST.FM
* Кеширование и скачивание треков
* Обои в сообщениях
* Редактор докбара
* Возможность загружать свои стикеры из Telegram
* Отключение редиректа через away.php
* Поддержка сторонних прокси
* Галочки, которые видны только пользователям приложения **
* Оптимизация приложения VK (удаление ненужных библиотек, которые встроены в ВК)
Все функции модификации описаны [здесь](https://github.com/vtosters/lite/blob/main/.github/features.md)
## Отладка приложения
Для отладки с помощью Android Studio необходимо пройти в `/smali/AndroidManifest.xml` и изменить значение `android:debuggable`:
`android:debuggable="false"` ➝ `android:debuggable="true"`
Настройки, необходимые для **отладки** вне Android Studio, находятся по этой ссылке: [vk.com/vt/debug](https://vk.com/vt/debug)
* Для дополнительной отладки ответов и логов необходимо включить **[Режим разработчика]**
* Для просмотра SSL-трафика необходимо **отключить** функцию **[SSL Pinning]**
* Для логгирования внутренних запросов к API необходимо включить функцию **[Логгирование API]** (работает только при использовании внутреннего логгера!)
* Для использования внутреннего логгера необходимо включить функцию **[Запись логов в файл]**
Сразу после нажатия на запись приложение начнет записывать **все ваши действия** по пути `/Download/VK/logs/com.vtosters.lite/`
При следующем открытии приложения оно автоматически сохранит логи и отправит вам в [**Документы** ВК](https://vk.com/docs), откуда вы можете скачать архив логов и работать с ними.
## Разработка
Для понимания работы декомпилированного кода требуется использовать **Dex to Java** декомпилятор [jadx](https://github.com/skylot/jadx) или же сторонние варианты как [Fernflower](https://github.com/fesh0r/fernflower)
При нахождении решения каких-либо проблем ждем вас в [Pull Requests](https://github.com/vtosters/lite/pulls)
* Рекомендуется установка **ADB** в систему ([гайд](https://technastic.com/system-wide-adb-fastboot-windows-10))
* Для индексации декомпилированного кода в Studio используется [dex2jar](https://github.com/pxb1988/dex2jar)
Сгенерированные библиотеки из .dex файлов находятся в `/app/libs`
При чистой перекомпиляции .dex в .jar может сломаться некоторая индексация файлов, исправляйте ручками что попадется (К примеру какие-то функции в дексах изменены с **private** на **public**)
Для сборки декомпилированного кода и ресурсов используется [Apktool](https://github.com/iBotPeaches/Apktool)
### Всё необходимое для сборки и компиляции
```diff
- Не меняйте имя пакета во избежание проблем с приложением
- Некоторые функции, связанные с музыкой не будут работать в пересобранном приложении
```
* Весь декомпилированный код клиента находится в `/smali`
* Весь исходный код модификации находится в `/app`
* Все необходимые скрипты/.jar файлы для компиляции APK, его подписывании и не только находятся в `/scripts`
### Необходимые зависимости
**JDK** >11 версии
**Android Studio**
### Linux/macOS
Для сборки используется файл `./build.sh`
### Windows
Для сборки используется файл `build.bat`