Команда adb sideload filename завершается ошибкой «cannot read 'filename'» или «no such file or directory» чаще всего из-за того, что вместо реального имени ZIP-архива пользователь вводит буквально слово «filename» либо указывает путь, который система не находит. Параметр filename — это не часть синтаксиса, а placeholder, на место которого нужно подставить полное имя файла прошивки, например update.zip или lineage-20-20260115-nightly.zip.
Ниже разберём, как работает команда adb sideload, какие требования предъявляются к имени и расположению файла, как подготовить устройство и устранить типичные ошибки при передаче архива через Android Debug Bridge. Инструкция ориентирована на стандартный recovery с поддержкой sideload — конкретные пункты меню могут отличаться в зависимости от модели устройства и версии рекавери.
Что означает параметр filename в команде adb sideload
Общий синтаксис команды выглядит так:
adb sideload <путь_к_файлу>.zipСлово filename в документации и шпаргалках — это условное обозначение аргумента. Вместо него подставляется реальное имя ZIP-архива с прошивкой, включая расширение .zip. Если файл лежит не в текущей папке терминала, указывается полный путь.
Простой пример: архив update.zip находится в папке platform-tools, а командная строка открыта в этой же папке. Тогда достаточно короткой формы:
adb sideload update.zipЕсли же архив лежит, например, в «Загрузках», путь придётся указать целиком. В Windows это может выглядеть как adb sideload C:\Users\Имя\Downloads\update.zip, а в Linux или macOS — adb sideload ~/Downloads/update.zip. Пути, содержащие пробелы, следует заключать в кавычки.
- 📦 Имя файла указывается полностью, вместе с расширением
.zip. - 📂 При запуске из другой папки нужен полный путь к архиву.
- 🔤 Пробелы в пути заключаются в кавычки.
- 🚫 Слово «filename» само по себе не является рабочим аргументом.
Как подготовить файл и устройство к sideload
До ввода команды нужно выполнить несколько условий: на компьютере установлены ADB-драйверы и пакет platform-tools, на устройстве запущен recovery с функцией sideload, а архив прошивки загружен из доверенного источника и не повреждён.
В стандартном Android Recovery режим обычно называется Apply update from ADB — его выбирают кнопками громкости и питания. В кастомных рекавери вроде TWRP пункт может находиться в разделе Advanced → ADB Sideload. Точное расположение зависит от версии рекавери, поэтому при расхождениях стоит свериться с документацией конкретной прошивки.
☑️ Подготовка к adb sideload
⚠️ Внимание: sideload устанавливает именно тот архив, который вы передаёте. Прошивка, не предназначенная для вашей модели или региона устройства, может привести к незагружающейся системе. Перед установкой сверьте кодовое имя устройства с тем, для которого собран архив.
Пошаговая инструкция: от подключения до установки
Последовательность действий одинакова для большинства устройств, отличаются лишь пункты меню рекавери. Сначала подключите смартфон кабелем к компьютеру и загрузитесь в recovery. Затем активируйте режим sideload — на экране устройства появится сообщение вроде «Now send the package you want to apply».
Далее на компьютере проверьте, что ADB видит устройство:
adb devicesВ списке должно появиться устройство со статусом sideload. Если вместо этого отображается unauthorized или пустой список, проблема в драйверах или кабеле — об этом ниже. Когда устройство определено, вам нужно запустить передачу архива:
adb sideload update.zipВо время передачи в терминале отображается прогресс в процентах. Важный нюанс: на некоторых версиях ADB индикатор останавливается примерно на 47%, хотя передача и установка продолжаются на устройстве. Это известная особенность отображения, а не зависание — дождитесь сообщения об успешной установке на экране самого устройства.
После завершения установки устройство обычно возвращается в меню рекавери, откуда можно перезагрузиться в систему командой Reboot system now.
Типичные ошибки с именем файла и их решение
Большинство сбоев при adb sideload связано именно с аргументом команды — путём или именем архива. Ниже таблица частых ошибок и способов их устранения.
| Ошибка | Вероятная причина | Решение |
|---|---|---|
| cannot read 'update.zip' | Файл не в текущей папке терминала | Указать полный путь или перейти в папку командой cd |
| no such file or directory | Опечатка в имени или путь с пробелами без кавычек | Проверить имя, заключить путь в кавычки |
| error: closed | Устройство вышло из режима sideload | Повторно активировать «Apply update from ADB» |
| error: protocol fault | Сбой соединения, кабель или порт | Сменить кабель, подключиться к другому USB-порту |
| signature verification failed | Архив не подписан или не подходит устройству | Использовать корректную прошивку; проверить источник |
Отдельно стоит упомянуть скрытые расширения в Windows. Если в проводнике отключено отображение расширений, файл может реально называться update.zip.zip — команда с именем update.zip тогда не сработает. Проверить точное имя можно командой dir в командной строке в папке с архивом.
Как упростить ввод пути к файлу
Постоянно вписывать длинный путь неудобно, и есть несколько легальных способов этого избежать. Самый простой — открыть командную строку прямо в папке с архивом: в проводнике Windows можно вписать cmd в адресную строку папки и нажать Enter. Тогда в команде достаточно одного имени файла.
Второй способ — перетащить файл мышью в окно терминала после набранного adb sideload (с пробелом в конце). Большинство терминалов автоматически подставят полный путь, при необходимости обернув его в кавычки. Это исключает опечатки.
Почему sideload принимает только ZIP
Механизм sideload в Android-рекавери рассчитан на OTA-пакеты — ZIP-архивы со скриптом установки внутри. Образы .img через sideload не устанавливаются: для них используется fastboot flash. Если у вас файл .img, .tar или .md5 — это прошивка для другого инструмента (fastboot, Odin и т.п.), и зависит это от устройства.
Также полезно переименовать длинные имена архивов во что-то короткое вроде fw.zip — на саму прошивку имя файла не влияет, проверяется содержимое и подпись пакета.
⚠️ Внимание: не переименовывайте и не распаковывайте архив до установки, если инструкция к прошивке прямо этого не требует. Изменение структуры пакета нарушает проверку подписи, и установка завершится ошибкой.
Если устройство не определяется в режиме sideload
Когда adb devices показывает пустой список, начните с простого: смените USB-порт (лучше порт напрямую на материнской плате), затем кабель — часть кабелей поддерживает только зарядку без передачи данных. На Windows проверьте в Диспетчере устройств, не висит ли устройство с восклицательным знаком; если да, возможно, потребуется установить или обновить драйвер ADB.
На Linux может понадобиться запуск adb devices с правами sudo или настройка правил udev. Если устройство видно в обычном режиме Android, но пропадает в recovery — это нормально для части моделей: в режиме sideload меняется идентификатор USB-устройства, и система должна распознать его заново.
Часто задаваемые вопросы
Можно ли указать файл без расширения .zip?
Нет. Имя файла должно совпадать с реальным именем на диске, включая расширение. Если файл называется update.zip, то и в команде пишется adb sideload update.zip.
Что делать, если в пути к файлу есть кириллица?
Как правило, кириллица в пути не мешает, но в отдельных средах возможны проблемы с кодировкой. Надёжнее переместить архив в папку с латинским именем, например C:\adb\update.zip.
Почему прогресс завис на 47%?
Это известная особенность вывода прогресса в ADB: передача фактически завершена, и дальше установка идёт на самом устройстве. Ориентируйтесь на сообщения на экране recovery, а не на проценты в терминале.
Можно ли через sideload установить файл .img?
Нет, sideload работает с ZIP-пакетами OTA. Образы разделов (.img) прошиваются через fastboot flash, если устройство это поддерживает.
Удалит ли sideload мои данные?
Установка официального OTA-обновления через sideload обычно сохраняет данные. Однако при переходе между разными прошивками может потребоваться сброс. Перед любыми действиями сделайте резервную копию важных данных.