Команда adb sideload — один из немногих способов установить ZIP-пакет, когда смартфон не загружается в систему или накопитель недоступен из recovery. Метод используется для прошивки OTA-обновлений, кастомных прошивок, пакетов Magisk и патчей через stock recovery или TWRP.
В отличие от обычной установки с SD-карты, здесь архив не копируется на устройство: компьютер передаёт его по USB напрямую в режиме sideload. Ниже разберём подготовку, пошаговую процедуру, типовые ошибки и их решения.
Что такое ADB sideload и когда он нужен
ADB sideload — это режим, при котором recovery принимает ZIP-архив с компьютера через протокол ADB. Устройство выступает получателем, а ПК отправляет файл командой adb sideload имя_файла.zip. После передачи recovery самостоятельно проверяет подпись пакета и начинает установку.
Метод применяется в нескольких сценариях. Во-первых, когда внутренняя память недоступна или зашифрована, и recovery не видит файлы. Во-вторых, для установки официальных OTA-обновлений вручную — многие производители публикуют такие пакеты именно для sideload. В-третьих, при прошивке кастомных ROM, когда удобнее отправить архив с ПК, чем копировать его на устройство.
Подготовка: драйверы, ADB и файл прошивки
До подключения устройства необходимо установить на компьютер Android SDK Platform Tools — официальный пакет от Google, содержащий утилиты adb и fastboot. Архив распаковывается в любую папку, команды выполняются из неё через командную строку или терминал.
На Windows дополнительно могут потребоваться USB-драйверы производителя смартфона, иначе устройство не определится в режиме sideload. На Linux и macOS драйверы обычно не нужны, но на Linux иногда требуется настройка правил udev для доступа к устройству без прав root.
- 📦 Скачайте Platform Tools с официального сайта для разработчиков Android
- 🔌 Установите USB-драйверы производителя смартфона (для Windows)
- 📄 Подготовьте ZIP-файл, предназначенный именно для установки через recovery
- 🔋 Зарядите устройство — прерывание прошивки из-за разряда опасно
- 💾 Сделайте резервную копию данных, если устройство загружается
⚠️ Внимание: устанавливайте только тот ZIP, который собран конкретно под вашу модель и регион устройства. Прошивка пакета от другой модели или несовместимой ревизии может привести к окирпичиванию. Сверяйте кодовое имя устройства и версию прошивки до начала установки.
Проверка подключения устройства
Перед входом в recovery убедитесь, что компьютер видит смартфон. Откройте командную строку в папке Platform Tools и выполните:
adb devices
Если устройство загружено в систему и отладка по USB включена, в списке появится серийный номер со статусом device. Для работы sideload включать отладку в системе не обязательно — recovery использует собственный ADB-интерфейс, но предварительная проверка помогает убедиться, что драйверы и кабель исправны.
Пошаговая установка ZIP через adb sideload
Сама процедура занимает несколько минут, если подготовка выполнена правильно. Порядок действий одинаков для большинства устройств, но пункты меню recovery могут отличаться — сверяйтесь с документацией к вашей модели или к используемому кастомному recovery.
☑️ Порядок установки ZIP через ADB
Комбинация кнопок для входа в recovery зависит от производителя: обычно это сочетание клавиш питания и громкости, которое нужно удерживать при включении. Точную комбинацию для вашей модели уточните в официальной инструкции — универсального варианта не существует.
В стоковом recovery ищите пункт Apply update from ADB, в TWRP — раздел Advanced → ADB Sideload, где перед стартом нужно провести свайп подтверждения. После активации режима устройство ожидает передачу файла.
Далее на компьютере выполняется основная команда. Путь к архиву проще указать, перетащив файл в окно терминала:
adb sideload update.zip
Во время передачи в терминале отображается прогресс. На устройстве после получения архива начинается проверка и установка — этот этап может занять заметно больше времени, чем сама передача. Прерывать процесс нельзя.
Типичные ошибки и их решение
Чаще всего пользователи сталкиваются с сообщением error: device not found. Причины: не установлены драйверы, неисправен кабель, устройство не переведено в режим sideload либо используется порт USB-концентратора. Проверьте каждый пункт по очереди и повторите команду adb devices — в режиме sideload статус устройства отображается как sideload.
Ошибка cannot read 'update.zip' означает, что терминал не находит файл по указанному пути. Убедитесь, что команда запущена из папки с архивом, либо укажите полный путь к файлу. Имя файла не должно содержать пробелов — либо заключите путь в кавычки.
| Ошибка | Вероятная причина | Решение |
|---|---|---|
| device not found | Драйверы, кабель или режим sideload не активен | Переустановить драйверы, сменить кабель и порт, проверить режим |
| cannot read file | Неверный путь к ZIP-архиву | Указать полный путь или запустить команду из папки с файлом |
| Установка останавливается на ~47% | Особенность отображения прогресса в терминале | Это норма: смотрите на экран устройства, а не на проценты в консоли |
| Signature verification failed | Пакет не подписан или предназначен для другого устройства | Использовать корректный пакет; в TWRP отключить проверку подписи |
| Передача обрывается | Неисправный кабель, порт или разряд устройства | Сменить кабель/порт, зарядить устройство, повторить |
Отдельно стоит упомянуть ситуацию, когда прогресс в терминале замирает примерно на середине. Это штатное поведение: счётчик в консоли отображает только передачу данных, а фактическая установка продолжается на устройстве. Ориентируйтесь на экран смартфона, а не на проценты в командной строке.
⚠️ Внимание: не отключайте кабель и не перезагружайте устройство, пока на его экране не появится сообщение о завершении установки. Обрыв на этапе записи разделов может повредить системный раздел.
Почему sideload останавливается на 47%
Утилита adb показывает прогресс только передачи файла в буфер устройства. После этого recovery сам распаковывает и устанавливает архив, а консоль об этом не сообщает. Процесс завершён, когда recovery выводит сообщение об успехе и возвращается в меню.
Особенности для разных recovery
В стоковом recovery действует проверка цифровой подписи: установить можно только пакеты, подписанные производителем. Поэтому через стоковый режим прошиваются официальные OTA, а кастомные модификации будут отклонены с ошибкой проверки подписи.
TWRP и другие кастомные recovery позволяют отключить проверку подписи и ставить любые совместимые ZIP. Однако набор функций и названия пунктов меню различаются между версиями и портами под конкретные устройства — ориентируйтесь на инструкцию к вашему recovery.
- 🛡️ Стоковый recovery — только подписанные производителем пакеты
- 🛠️ TWRP — любые совместимые ZIP, проверку подписи можно отключить
- 🔄 Некоторые прошивки требуют sideload дважды: для обоих слотов A/B-разметки
Что делать после установки
После сообщения об успешной установке выберите в recovery пункт Reboot system now. Первая загрузка после прошивки обычно длится дольше обычного — система оптимизирует приложения и обновляет кэш. Это нормально, прерывать процесс не нужно.
Если устройство не загружается в систему спустя разумное время, возможные причины — несовместимый пакет, необходимость сброса данных (Wipe data/factory reset) или незавершённая прошивка второго слота на A/B-устройствах. Конкретные шаги восстановления зависят от модели, поэтому действуйте по инструкции для вашего устройства.
Часто задаваемые вопросы
Можно ли установить через adb sideload любой ZIP-файл?
Нет. Пакет должен быть собран для установки через recovery и соответствовать вашей модели устройства. Стоковый recovery дополнительно требует корректной цифровой подписи производителя.
Нужна ли разблокировка загрузчика для adb sideload?
Для официальных OTA-пакетов через стоковый recovery разблокировка обычно не требуется. Для кастомных прошивок и TWRP разблокированный загрузчик, как правило, необходим — зависит от устройства.
Удалятся ли данные при установке через sideload?
Установка OTA-обновления данные не удаляет. Прошивка кастомного ROM часто требует сброса данных — это указывается в инструкции к конкретной прошивке. Резервная копия перед любыми операциями обязательна.
Что означает ошибка signature verification failed?
Recovery не смог подтвердить подпись пакета: либо файл предназначен для другого устройства, либо не подписан производителем. Проверьте, что архив соответствует вашей модели, или используйте кастомный recovery с отключённой проверкой.
Работает ли adb sideload без включённой отладки по USB?
Да. Режим sideload в recovery использует собственный интерфейс ADB и не зависит от настройки отладки в системе Android. Отладка нужна только для команд, выполняемых при загруженной ОС.