Установка Apktool чаще всего завершается ошибкой 'apktool' is not recognized или сообщением Unable to access jarfile — причина почти всегда в том, что Java не добавлена в PATH либо JAR-файл лежит не в той папке, откуда запускается команда. Обе проблемы решаются за несколько минут, если выполнить установку в правильном порядке.
Apktool — это консольная утилита для обратной разработки Android-приложений: она декомпилирует APK-файлы в читаемые ресурсы и smali-код, а также собирает их обратно. Инструмент бесплатный, распространяется в виде JAR-файла и требует установленной Java. Ниже разберём установку на Windows, Linux и macOS, а также типичные ошибки запуска.
Что нужно подготовить перед установкой
Перед скачиванием Apktool убедитесь, что на компьютере установлена Java Runtime Environment (JRE) версии 8 или новее. Проверить это можно командой в терминале или командной строке:
java -versionЕсли команда возвращает версию — всё готово. Если система отвечает, что команда не найдена, сначала установите Java с официального сайта или через пакетный менеджер вашей ОС. Без Java Apktool не запустится в принципе, так как это Java-приложение.
- ☕ Установленная Java 8+ (JRE или JDK)
- 📦 Скачанный файл
apktool.jarс официального ресурса проекта - 📁 Отдельная папка для инструмента, например
C:\apktool - 🔧 Права на запись в выбранную папку и выполнение скриптов
Установка Apktool на Windows
На Windows установка сводится к размещению двух файлов — apktool.jar и bat-обёртки apktool.bat — в одной папке и добавлении этой папки в переменную окружения PATH. Bat-файл нужен, чтобы не писать каждый раз длинную команду запуска через java -jar.
Порядок действий следующий. Создайте папку C:\apktool и поместите в неё скачанный JAR-файл, переименовав его в apktool.jar (уберите версию из имени). Затем создайте bat-файл — его содержимое публикуется на официальной странице установки проекта. После этого откройте Система → Дополнительные параметры системы → Переменные среды и добавьте путь C:\apktool в переменную Path.
☑️ Установка Apktool на Windows
После изменения PATH обязательно перезапустите командную строку — уже открытые окна не видят обновлённые переменные окружения. Проверьте результат:
apktool --version⚠️ Внимание: скачивайте Apktool только с официального сайта проекта (ibotpeaches.github.io/Apktool) или из репозитория на GitHub. Сторонние сайты иногда распространяют модифицированные сборки, безопасность которых никто не гарантирует.
Установка на Linux
В Linux логика та же: JAR-файл плюс скрипт-обёртка apktool, который вызывает его через Java. Оба файла принято размещать в /usr/local/bin, чтобы команда была доступна из любого каталога без настройки PATH вручную.
Скачайте файлы и сделайте их исполняемыми:
sudo mv apktool.jar /usr/local/bin/
sudo mv apktool /usr/local/bin/
sudo chmod +x /usr/local/bin/apktool
В некоторых дистрибутивах пакет доступен и через пакетный менеджер, однако версия там может отставать от актуальной. Если нужна свежая версия с поддержкой новых версий Android, предпочтительнее ручная установка с официального сайта.
Установка на macOS
На macOS процедура аналогична Linux: JAR-файл и скрипт-обёртка помещаются в /usr/local/bin, после чего скрипту выдаются права на исполнение. Java при этом должна быть установлена заранее — проверьте её той же командой java -version.
Альтернативный вариант — установка через пакетный менеджер Homebrew, если он у вас уже используется. Такой способ проще в обновлении, но актуальность версии зависит от репозитория. Проверьте после установки версию командой apktool --version, чтобы убедиться, что всё встало корректно.
Сравнение способов установки
| Параметр | Ручная установка | Пакетный менеджер |
|---|---|---|
| Версия Apktool | Всегда актуальная | Может отставать |
| Сложность | Требует настройки PATH | Одна команда |
| Обновление | Замена JAR-файла вручную | Через менеджер пакетов |
| Контроль источника | Полный, файлы с официального сайта | Зависит от репозитория |
Ручной способ предпочтителен, когда важна свежая версия: декомпиляция приложений, собранных под новые версии Android, часто требует последних обновлений инструмента. Пакетный менеджер удобен для быстрого старта и тех, кто не хочет возиться с переменными окружения.
Типичные ошибки и их решение
Разберём проблемы, с которыми пользователи сталкиваются чаще всего. Если команда apktool не распознаётся системой — папка с инструментом не добавлена в PATH (Windows) либо файлы лежат не в том каталоге (Linux/macOS). Проверьте путь и перезапустите терминал.
Ошибка Unable to access jarfile означает, что скрипт-обёртка не находит apktool.jar рядом с собой. Проверьте, что JAR-файл назван именно apktool.jar без номера версии и лежит в той же папке, что и bat-файл или скрипт. Если при запуске появляется ошибка про Java — проблема в отсутствии или неверной настройке JRE, а не в самом Apktool.
⚠️ Внимание: антивирусы иногда блокируют запуск bat-файлов из нестандартных папок. Если команда молча не выполняется, проверьте журнал защитника Windows или добавьте папку в исключения — но только если файлы скачаны с официального источника.
Как обновить Apktool до новой версии
Достаточно скачать свежий apktool.jar с официального сайта и заменить им старый файл в папке установки. Скрипт-обёртку и настройки PATH менять не нужно. После замены проверьте версию командой apktool --version.
Проверка работоспособности
Финальный шаг — убедиться, что инструмент работает. Выполните apktool --version: в ответ должна отобразиться версия без ошибок. Для полной проверки можно декомпилировать любой тестовый APK:
apktool d app.apkРядом с файлом появится папка с ресурсами и smali-кодом — значит, всё настроено правильно. Если декомпиляция падает с ошибками на конкретном APK, причина обычно в самом приложении (защита, нестандартная упаковка), а не в установке.
Часто задаваемые вопросы
Нужен ли root или особые права для Apktool?
Нет. Apktool работает на компьютере, а не на смартфоне, и никакого отношения к root-доступу на Android не имеет. Права администратора нужны только для записи файлов в системные папки вроде /usr/local/bin.
Можно ли установить Apktool без Java?
Нет. Apktool — это Java-приложение, и JRE обязателен. Сначала установите Java, затем сам инструмент.
Почему команда apktool не находится после установки?
На Windows — папка не добавлена в PATH или командная строка не перезапущена после изменения переменных. На Linux/macOS — файлы лежат не в каталоге из PATH либо скрипту не выданы права на исполнение (chmod +x).
Легально ли использовать Apktool?
Сам инструмент легален и широко применяется в исследованиях и разработке. Однако декомпиляция чужих приложений может нарушать лицензионные соглашения и авторские права — используйте его для собственных проектов или в рамках разрешённого анализа.
Как удалить Apktool с компьютера?
Удалите папку с JAR-файлом и скриптом, а на Windows дополнительно уберите путь из переменной Path. Реестр и система при этом не затрагиваются — установка полностью портабельная.