199 lines
14 KiB
Markdown
199 lines
14 KiB
Markdown
<p align="center">
|
||
<a href="https://vtosters.app/">
|
||
<picture>
|
||
<source media="(prefers-color-scheme: dark)" srcset="https://cdn.discordapp.com/attachments/918864618116481029/1002916719595106344/VT_Fill_Logo_Dark.svg">
|
||
<img src="https://cdn.discordapp.com/attachments/918864618116481029/1002916719381201036/VT_Fill_Logo_Light.svg">
|
||
</picture>
|
||
</a>
|
||
<br>
|
||
<br>
|
||
<a href="https://t.me/s/vtosters">
|
||
<img src="https://img.shields.io/badge/-Telegram-blue?style=for-the-badge&logo=telegram&color=2AABEE"/>
|
||
</a>
|
||
<a href="https://vk.com/vtosters_official">
|
||
<img src="https://img.shields.io/badge/-VK-blue?style=for-the-badge&logo=vk&color=0077FF"/>
|
||
</a>
|
||
<a href="https://discord.gg/j9CAt3uYXj">
|
||
<img src="https://img.shields.io/badge/-Discord-blue?style=for-the-badge&logo=discord&color=5865F2&logoColor=FFFFFF"/>
|
||
</a>
|
||
<br>
|
||
<a href="https://github.com/vtosters/lite/issues">
|
||
<img src="https://img.shields.io/github/issues/vtosters/lite?style=flat-square"/>
|
||
</a>
|
||
<a href="https://github.com/vtosters/lite/network/members">
|
||
<img src="https://img.shields.io/github/forks/vtosters/lite?style=flat-square"/>
|
||
</a>
|
||
<a href="https://github.com/vtosters/lite/stargazers">
|
||
<img src="https://img.shields.io/github/stars/vtosters/lite?style=flat-square"/>
|
||
</a>
|
||
</p>
|
||
|
||
**ВТостерс Lite** — это модифицированный клиент официального ВКонтакте, основанный на версии **5.56.1 (4838)**
|
||
|
||
* Вы можете предложить свои идеи/сообщить о багах в [Issues](https://github.com/vtosters/lite/issues)
|
||
|
||
* Скачивать самые актуальные версии можно с [Actions](https://github.com/vtosters/lite/actions)
|
||
<sup><sub>(могут содержать баги)</sub></sup>
|
||
|
||
* Стабильные сборки находятся в [Releases](https://github.com/vtosters/lite/releases)
|
||
|
||
Зеркало на нашем [<img src="https://git.maki.su/assets/img/logo.svg" align="center" width="20" height="20"/> Git](https://git.maki.su/gdlbo/lite)
|
||
|
||
### Быстрая навигация
|
||
|
||
* [Функционал](#функционал)
|
||
* [Отладка приложения](#отладка-приложения)
|
||
* [Разработка](#разработка)
|
||
* [Всё необходимое для сборки и компиляции](#всё-необходимое-для-сборки-и-компиляции)
|
||
* [Необходимые зависимости](#необходимые-зависимости)
|
||
* [Linux/macOS](#linuxmacos)
|
||
* [Windows](#windows)
|
||
|
||
|
||
## Функционал
|
||
|
||
* Лента
|
||
* Блокировка рекламы в ленте
|
||
* Блокировка постов через фильтры
|
||
* Возможность добавлять в вайтлист фильтров группы, чтобы в них не удалялись посты
|
||
* Возможность отключить рекомендации от ВК
|
||
* Редактор докбара
|
||
* Редактор элементов Superapp
|
||
* Медиаконтент
|
||
* Округление дат
|
||
* 1 января в 4:20
|
||
* 1 января в 4:20:00
|
||
* 1 января 2000 в 4:20:00
|
||
* Округление чисел
|
||
* Сокращение постов **(Показать полностью)**
|
||
* Результаты опросов без участия
|
||
* Возможность указывать папку для загрузки фото/видео/музыки/всего
|
||
* Интеграция с <a href="https://www.last.fm/">LAST.FM</a> (а также возможность скробблинга)
|
||
* Возможность скачивать видео, очищать историю просмотра видео
|
||
* Возможность найти фотографию через поисковые системы
|
||
* Интеграция с <a href="https://vkx.app/">VK X</a>
|
||
* Возможность кешировать треки в приложении
|
||
* Сообщения
|
||
* Обои в сообщениях
|
||
* Возможность выключения кнопки записи голосовых сообщений
|
||
* Возможность скрыть блок рекомендаций в сообщениях
|
||
* Режим **VK Me**
|
||
* Возможность вернуть вкладку уведомлений для режима VK Me
|
||
* Встроенный переводчик текста для сообщений
|
||
* Возможность выбрать язык перевода
|
||
* Автоматический перевод ваших сообщений на выбранный язык
|
||
* Альтернативный дизайн эмодзи меню
|
||
* Возможность использовать системные эмодзи
|
||
* Возможнсть использовать Enter с аппаратной клавиатуры
|
||
* Панель ввода из приложения ВК для IOS
|
||
* Активность
|
||
* Возможность видеть удаленные сообщения
|
||
* Функционал, позволяющий оставаться в «оффлайне» (принудительный оффлайн/не отправлять статус онлайна и т.п.)
|
||
* Нечиталка/неписалка для ЛС/бесед/ботов/групп
|
||
* Возможность отключить информацию о том, что вы просмотрели историю/прослушали голосовое сообщение
|
||
* Возможность видеть онлайн пользователей, если у вас скрыт онлайн через VK Messenger
|
||
* Возможность сохранять настройки бесшумных сообщений/сообщений-бомбочек
|
||
* Отключить уведомление о том, что вы сделали скриншот в беседе
|
||
* Отключение редиректа через away.php
|
||
* Отключение отправки метрики
|
||
* Внешний вид
|
||
* **Milkshake** тема (дизайн новых версий ВК)
|
||
* Название заголовков в докбаре
|
||
* Возможность использовать акцент для иконок
|
||
* Возможность отключить счётчики в докбаре
|
||
* Смена иконки приложения (содержит много уникальных иконок для донатеров)
|
||
* Возможность покрасить панель навигации, веб-страницы
|
||
* Telegram Стикеры
|
||
* Возможность загружать свои стикерпаки из Telegram во ВКонтакте
|
||
* Интерфейс
|
||
* Возможность отключить блок историй наверху ленты
|
||
* Возможность отключить боковую камеру в разделе «Новости»
|
||
* Возможность отключить блок «Что у вас нового?» в разделе «Новости»
|
||
* Возможность показывать лайки у постов справа
|
||
* Возможность менять стартовый раздел при запуске приложения
|
||
* Анимации фрагментов
|
||
* Возможность изменять размер закругления картинок (аватарок и прочего)
|
||
* Возможность отключить редизайн видеопостов
|
||
* Возможность отключить блок миниаппов/VK Pay/Superapp
|
||
* Возможность отключить сокращение названий разделов в меню
|
||
* Возможность скрыть блок рекомендаций друзей в разделе «Друзья»
|
||
* Возможность скрыть подписи в настройках
|
||
* Прокси
|
||
* Поддержка сторонних прокси, таких как: Zaborona, VikaMobile, рандомные прокси и прочие
|
||
* Возможность использовать **HTTP/HTTPS/SOCKS** прокси, менять домены **API/OAuth/Static**
|
||
* Другое
|
||
* Очистка кеша приложения (**всё/стикеры/изображения/видео/сообщения/WebView**)
|
||
* Автоочистка кеша при достижении указанного вами значения (**100/500 MB, 1/2/5 GB**)
|
||
* Функционал для **дебага приложения/бэкап возможности/верификации VTosters**
|
||
|
||
А также:
|
||
* Галочки, которые видны только пользователям приложения **ВТостерс Lite** (подробнее тут: [vtosters.app](https://vtosters.app) ➝ Пожертвования)
|
||
* Оптимизация приложения VK (удаление ненужных библиотек, которые встроены в оригинальный VK)
|
||
|
||
И многое другое!
|
||
|
||
## Отладка приложения
|
||
|
||
Для отладки с помощью <a href="#"><img src="https://i.imgur.com/cPvvFDP.png" align="center" width="20" height="23"/></a> 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]** <sup>(работает только при использовании внутреннего логгера!)</sup>
|
||
|
||
* Для использования внутреннего логгера необходимо включить функцию **[Запись логов в файл]**
|
||
|
||
Сразу после нажатия на запись приложение начнет записывать **все ваши действия** по пути `/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`
|
||
|
||
### Необходимые зависимости
|
||
<a href="https://www.oracle.com/java/technologies/downloads/"><img src="https://i.imgur.com/z8ZN19a.png" align="center" width="20" height="23"/> **JDK**</a> >11 версии
|
||
|
||
<a href="https://developer.android.com/studio"><img src="https://i.imgur.com/cPvvFDP.png" align="center" width="20" height="23"/> **Android Studio**</a>
|
||
|
||
### Linux/macOS
|
||
Для сборки используется файл `./build.sh`
|
||
|
||
<img src="https://i.imgur.com/8BMX8lG.png" width="550" height="368"/>
|
||
|
||
### Windows
|
||
Для сборки используется файл `build.bat`
|
||
|
||
<img src="https://i.imgur.com/iZSUKJ6.png" width="550" height="368"/>
|