Update README.md

This commit is contained in:
Vitya Zhusovoj 2021-03-01 06:08:08 +00:00
parent ff05dd35b2
commit a575abd6b1

248
README.md
View file

@ -1,45 +1,45 @@
# Universal Android Debloater
# Универсальный Android Debloater
**DISCLAIMER**: Use this script at your own risk. I am not responsible for anything that could happen to your phone.
** ОТКАЗ ОТ ОТВЕТСТВЕННОСТИ **: используйте этот скрипт на свой страх и риск. Я не несу ответственности ни за что, что может случиться с вашим телефоном.
## Summary
I try to maintain a universal tool which removes bloatwares on any Android phones by using ADB.
## Резюме
Я стараюсь поддерживать универсальный инструмент, который удаляет вредоносное ПО с любых телефонов Android с помощью ADB.
The main goal is to improve battery performance and privacy by removing unnecessary and obscure system apps. This can also contribute to improve security by reducing [the attack surface](https://en.wikipedia.org/wiki/Attack_surface). The script has a menu that lets you choose what debloat list you want to use. I strongly encourage you to take a look at the lists because the default selection may not suit you. All packages are as well documented as possible in order to provide a better understanding of what you can delete or not.
Основная цель - улучшить производительность аккумулятора и конфиденциальность, удалив ненужные и непонятные системные приложения. Это также может способствовать повышению безопасности за счет уменьшения [поверхности атаки] (https://en.wikipedia.org/wiki/Attack_surface). В скрипте есть меню, в котором вы можете выбрать, какой список деблокирования вы хотите использовать. Я настоятельно рекомендую вам взглянуть на списки, потому что выбор по умолчанию может вам не подойти. Все пакеты максимально хорошо документированы, чтобы лучше понять, что вы можете удалить, а что нет.
This script *should* be safe with the default selection. The worse thing which could happen is preventing an essential system process to be loaded during boot causing then an unfortunate bootloop. If you used the non-root solution, after about 5 failed system boots, the phone will automatically reboot in recovery mode and you'll have to perform a FACTORY RESET. So make a backup!
Этот сценарий * должен * быть безопасным с выбором по умолчанию. Худшее, что может случиться, - это предотвратить загрузку важного системного процесса во время загрузки, что приведет к неудачной загрузке. Если вы использовали решение без полномочий root, после примерно 5 неудачных загрузок системы телефон автоматически перезагрузится в режиме восстановления, и вам придется выполнить ЗАВОДСКОЙ СБРОС. Так что сделайте резервную копию!
If you have a rooted device you can also physically delete the apks. Ironically this solution is safer because the script saves the apks before their removal. In case of bootloop you just need to run the script from a recovery with ADB support (e.g TWRP) and restore them.
Если у вас есть рутированное устройство, вы также можете физически удалить файлы apks. По иронии судьбы это решение более безопасно, потому что скрипт сохраняет файлы apks перед их удалением. В случае bootloop вам просто нужно запустить скрипт из рекавери с поддержкой ADB (например, TWRP) и восстановить их.
In any case, you can NOT brick your device with this script! That's the main thing, right?
В любом случае, вы НЕ МОЖЕТЕ блокировать свое устройство этим скриптом! Это главное, правда?
## Features
* [X] Quick search among all the packages of an android device
* [X] Uninstallation of system/user packages (manually or with the debloat lists)
* [X] Reinstallation of system packages (manually or with the debloat lists)
* [X] ADB backup/restore (not really reliable, see the [FAQ](https://gitlab.com/W1nst0n/universal-android-debloater/-/wikis/FAQ))
* [X] Device brand detection and auto-selection of the appropriate manufacturer debloat list
* [X] Logging:`debloated_packages.txt`, `remaining_packages.txt`, `deleted_apks.txt` (for root users)
* [X] Root support
* [ ] Installation of alternative open-source apps replacing stock apps (list in the WIKI section) (WIP)
## Функции
* [X] Быстрый поиск среди всех пакетов Android-устройства
* [X] Удаление системных / пользовательских пакетов (вручную или с помощью списков деблоутов)
* [X] Переустановка системных пакетов (вручную или со списками деблоутов)
* [X] Резервное копирование / восстановление ADB (не очень надежно, см. [FAQ] (https://gitlab.com/W1nst0n/universal-android-debloater/-/wikis/FAQ))
* [X] Обнаружение марки устройства и автоматический выбор соответствующего списка деблокирования производителя.
* [X] Ведение журнала: `debloated_packages.txt`,` Остающийся_пакет.txt`, `deleted_apks.txt` (для пользователей root)
* [X] Поддержка root
* [] Установка альтернативных приложений с открытым исходным кодом, заменяющих стандартные приложения (список в разделе WIKI) (WIP)
NB : The non-root method is NOT a real uninstallation for system apps (see the [FAQ](https://gitlab.com/W1nst0n/universal-android-debloater/-/wikis/FAQ))
NB: метод без полномочий root НЕ ЯВЛЯЕТСЯ реальным удалением системных приложений (см. [FAQ] (https://gitlab.com/W1nst0n/universal-android-debloater/-/wikis/FAQ))
## Universal debloat lists
* [X] GFAM (Google/Facebook/Amazon/Microsoft)
## Универсальные списки деблотов
* [X] GFAM (Google / Facebook / Amazon / Microsoft)
* [X] AOSP
* [X] Manufacturers (OEM)
* [X] Mobile carriers
* [X] Qualcomm / Mediatek / Miscellaneous
* [X] Производители (OEM)
* [X] Операторы мобильной связи
* [X] Qualcomm / Mediatek / Разное
## Manufacturers debloat lists
* [ ] Archos
## Списки деблокирования производителей
* [] Archos
* [X] Asus
* [ ] Blackberry
* [ ] Gionee
* [ ] Ежевика
* [] Джиони
* [X] LG
* [X] Google
* [ ] HTC
* [] HTC
* [X] Huawei
* [X] Motorola
* [X] Nokia
@ -47,144 +47,144 @@ NB : The non-root method is NOT a real uninstallation for system apps (see the [
* [X] Oppo
* [X] Samsung
* [X] Sony
* [ ] TCL
* [ ] Wiko
* [] TCL
* [] Wiko
* [X] Xiaomi
* [ ] ZTE
* [] ZTE
## Mobile carriers debloat lists
| Country | Carriers |
|-----------------|-----------------------------------|
| France | Orange, SFR, Free, Bouyges/Sosh |
| USA | T-Mobile, Verizon, Sprint, AT&T |
| Germany | Telekom |
## Списки деблокировавших операторов мобильной связи
| Страна | Перевозчики |
| ----------------- | ------------------------------- ---- |
| Франция | Апельсин, SFR, Бесплатно, Буйж / Сош |
| США | T-Mobile, Verizon, Sprint, AT&T |
| Германия | Телеком |
## How to use it
- **Read the [FAQ](https://gitlab.com/W1nst0n/universal-android-debloater/-/wikis/FAQ)!**
- **Do a proper backup of your data! You can never be too careful!**
- Enable *Developer Options* on your smartphone.
- Turn on *USB Debugging* from the developper panel.
- From the settings, disconnect from any OEM accounts (when you delete OEM account package it could lock you on the lockscreen because the phone can't associate your identity anymore)
## Как это использовать
- ** Прочтите [FAQ] (https://gitlab.com/W1nst0n/universal-android-debloater/-/wikis/FAQ)! **
- ** Сделайте надлежащее резервное копирование ваших данных! Никогда нельзя быть слишком осторожным! **
- Включите * Параметры разработчика * на вашем смартфоне.
- Включите * USB Debugging * на панели разработчика.
- В настройках отключитесь от любых учетных записей OEM (когда вы удаляете пакет учетных записей OEM, он может заблокировать вас на экране блокировки, потому что телефон больше не может связывать вашу личность)
<p>
<details>
<summary>LINUX</summary>
<подробности>
<summary> LINUX </summary>
- Install *Android platform tools* and *qpdf* on your PC :
- Установите * инструменты платформы Android * и * qpdf * на свой компьютер:
Debian Base:
```bash
$ sudo apt install android-sdk-platform-tools qpdf
```
Arch-Linux Base:
```bash
База Debian:
Баш
$ sudo apt установить android-sdk-platform-tools qpdf
`` ''
База Arch-Linux:
Баш
$ sudo pacman -S android-tools qpdf
```
Red Hat Base:
```bash
$ sudo yum install android-tools qpdf
```
`` ''
База Red Hat:
Баш
$ sudo yum установить android-tools qpdf
`` ''
</details>
</p>
<p>
<details>
<summary>MAC OS</summary>
<подробности>
<summary> ОС MAC </summary>
- Install [Homebrew](https://brew.sh/)
- Install *Android platform tools* and *qpdf*
- Установите [Homebrew] (https://brew.sh/)
- Установите * инструменты платформы Android * и * qpdf *
You will also need to upgrade bash because Apple ships a very old bash version (3.2.57) due to licencing issues.
Вам также потребуется обновить bash, потому что Apple поставляет очень старую версию bash (3.2.57) из-за проблем с лицензированием.
```bash
Баш
$ brew install android-platform-tools qpdf bash
```
`` ''
You have to make the new bash version your default:
Вам нужно сделать новую версию bash по умолчанию:
```bash
$ sudo echo "/usr/local/bin/bash" >> /etc/shells
$ chsh -s /usr/local/bin/bash
```
Check if it works:
Баш
$ sudo echo "/ usr / local / bin / bash" >> / etc / shells
$ chsh -s / usr / local / bin / bash
`` ''
Проверяем, работает ли:
```bash
$ echo $BASH_VERSION
```
Баш
$ echo $ BASH_VERSION
`` ''
</details>
</p>
<p>
<details>
<summary>WINDOWS</summary>
<подробности>
<summary> ОКНА </summary>
Windows can't natively run bash script. Choose a workaround:
Windows не может изначально запускать bash-скрипт. Выберите обходной путь:
## Method 1: Live Linux USB
Create a Linux Live USB. Boot your computer on it and follow the instructions of the `LINUX` section. If you are a new to Linux, this will be a good opportunity to discover this wonderful OS. I recommend Linux Mint: [Instructions](https://itsfoss.com/install-linux-mint/)
## Метод 1: Live Linux USB
Создайте Linux Live USB. Загрузите на нем свой компьютер и следуйте инструкциям раздела «LINUX». Если вы новичок в Linux, это будет хорошей возможностью познакомиться с этой замечательной ОС. Я рекомендую Linux Mint: [Инструкции] (https://itsfoss.com/install-linux-mint/)
**Note:** Just in case, I recall that you don't need to install Linux on your computer. You can do whatever your want direclty on the Live USB.
** Примечание: ** На всякий случай напомню, что вам не нужно устанавливать Linux на свой компьютер. Вы можете делать все, что захотите, прямо на Live USB.
## Method 2: WSL (W10 only)
This method consists of installing WSL, a compatibility layer for running Linux binary executables natively on Windows 10.
## Метод 2: WSL (только W10)
Этот метод состоит из установки WSL, уровня совместимости для запуска двоичных исполняемых файлов Linux изначально в Windows 10.
For now, there is no USB support in the WSL. This means you need to install both Windows and Linux platform-tools and force the use of Windows adb server.
На данный момент в WSL нет поддержки USB. Это означает, что вам необходимо установить инструменты платформы Windows и Linux и принудительно использовать сервер Windows adb.
- Download [android platform tools](https://dl.google.com/android/repository/platform-tools-latest-windows.zip) and unzip it somewhere. [Add the folder to your PATH](https://www.architectryan.com/2018/03/17/add-to-the-path-on-windows-10/).
- [Install USB drivers of your device](https://developer.android.com/studio/run/oem-usb#Drivers)
- Check your device is detected:
```batch
> adb devices
```
- Загрузите [инструменты платформы Android] (https://dl.google.com/android/repository/platform-tools-latest-windows.zip) и распакуйте его куда-нибудь. [Добавьте папку в свой PATH] (https://www.architectryan.com/2018/03/17/add-to-the-path-on-windows-10/).
- [Установите USB-драйверы вашего устройства] (https://developer.android.com/studio/run/oem-usb#Drivers)
- Убедитесь, что ваше устройство обнаружено:
партия
> устройства adb
`` ''
- Install [WSL2 (Windows Subsystem for Linux)](https://itsfoss.com/install-bash-on-windows/) in order to be able to run bash scripts.
- Install *Android platform tools* and *qpdf* from the Debian/Ubuntu shell
```bash
- Установите [WSL2 (Подсистема Windows для Linux)] (https://itsfoss.com/install-bash-on-windows/), чтобы иметь возможность запускать сценарии bash.
- Установите * инструменты платформы Android * и * qpdf * из оболочки Debian / Ubuntu
Баш
$ sudo apt update && sudo apt upgrade
$ sudo apt install android-sdk-platform-tools qpdf
```
- Check the version of ADB on Linux & Windows
```bash
adb version
```
You need the same version otherwise it will not work. It's very likely your Ubuntu/Debian ADB version is older than the Windows one.
Download the lastest linux platform tools from Google and replace your adb binaries with the new ones :
```bash
$ sudo apt установить android-sdk-platform-tools qpdf
`` ''
- Проверьте версию ADB в Linux и Windows.
Баш
версия adb
`` ''
Вам нужна такая же версия, иначе она не будет работать. Скорее всего, ваша версия ADB для Ubuntu / Debian старше, чем версия для Windows.
Загрузите новейшие инструменты платформы Linux от Google и замените свои двоичные файлы adb новыми:
Баш
$ wget https://dl.google.com/android/repository/platform-tools-latest-linux.zip
$ unzip platform-tools-latest-linux.zip
$ sudo cp platform-tools/adb /usr/bin/adb
$ sudo chmod 755 /usr/bin/adb
$ adb version
```
Kill the WSL adb server:
```bash
Платформа-инструменты $ sudo cp / adb / usr / bin / adb
$ sudo chmod 755 / usr / bin / adb
версия $ adb
`` ''
Убиваем сервер adb WSL:
Баш
$ adb kill-server
```
And start the ADB server on Windows:
```batch
> adb kill-server
> adb start-server
> adb devices
```
Note: You can access your Windows files under `/mnt/c/`
`` ''
И запускаем сервер ADB в Windows:
партия
> убить сервер adb
> стартовый сервер adb
> устройства adb
`` ''
Примечание. Вы можете получить доступ к своим файлам Windows в каталоге / mnt / c /.
</details>
</p>
- Download [the lastest release of Android Universal Debloater](https://gitlab.com/W1nst0n/universal-android-debloater/-/releases)
- Browse through the debloat lists to be sure the default selection suits you.
- Run `debloat_script.sh` from a Unix terminal
```bash
- Загрузите [самый последний выпуск Android Universal Debloater] (https://gitlab.com/W1nst0n/universal-android-debloater/-/releases)
- Просмотрите списки деблокирования, чтобы убедиться, что выбор по умолчанию вам подходит.
- Запустите `debloat_script.sh` из терминала Unix
Баш
$ bash debloat_script.sh
```
`` ''
**NOTE:** Chinese phones users may need to use the AOSP list for removing some stock apps because those chinese manufacturers (especially Xiaomi and Huawei) have been using the name of AOSP packages for their own (modified & closed-source) apps.
** ПРИМЕЧАНИЕ. ** Пользователям китайских телефонов может потребоваться использовать список AOSP для удаления некоторых стандартных приложений, поскольку эти китайские производители (особенно Xiaomi и Huawei) использовали названия пакетов AOSP для своих собственных (модифицированных и закрытых) приложений. .
**IMPORTANT NOTE:** You will have to run this script whenever your OEM push an update to your phone as some *uninstalled* system apps could be reinstalled.
** ВАЖНОЕ ПРИМЕЧАНИЕ. ** Вам нужно будет запускать этот сценарий всякий раз, когда ваш OEM-производитель отправляет обновление на ваш телефон, поскольку некоторые * удаленные * системные приложения могут быть переустановлены.
## How to contribute
## Как внести свой вклад
Hey-hey-hey! Don't go away so fast! This is a community project. That means I need you! I'm sure you want to make this project better anyway.
Эй Эй Эй! Не уходи так быстро! Это общественный проект. Значит, ты мне нужен! Я уверен, что вы все равно хотите улучшить этот проект.
==> [How to contribute](https://gitlab.com/W1nst0n/universal-android-debloater/-/wikis/home#how-to-contribute)
==> [Как внести свой вклад] (https://gitlab.com/W1nst0n/universal-android-debloater/-/wikis/home#how-to-contribute)