Ошибка «APK не установлен» или пустая папка outputs после сборки — типичная ситуация, с которой сталкиваются те, кто впервые пытается собрать APK-файл из проекта Android. Причина чаще всего не в самом коде, а в неправильно выбранном типе сборки, отсутствующей подписи или несовпадении версий SDK и Gradle. Ниже разберём полный путь: от установки инструментов до готового файла, который можно передать на устройство.
APK (Android Package Kit) — это архив с кодом, ресурсами и манифестом приложения. Сделать его можно двумя путями: собрать собственный проект в Android Studio или упаковать уже готовый код через командную строку. Оба варианта рассмотрим, но начнём с подготовки среды, без которой сборка не запустится.
Что потребуется перед сборкой
Для сборки APK на компьютере должны быть установлены три компонента: JDK (Java Development Kit), Android Studio и Android SDK с нужной версией платформы. Android Studio обычно подтягивает SDK автоматически при первом запуске, но JDK стоит проверить отдельно — современные версии среды используют встроенную JBR, поэтому ручная установка Java чаще всего не нужна.
Проверить готовность среды просто: откройте Android Studio и перейдите в File → Project Structure → SDK Location. Там отображаются пути к SDK и JDK. Если какое-то поле пустое — скачайте недостающий компонент через SDK Manager (значок в панели инструментов или меню Tools → SDK Manager).
- 🧰 Установленная Android Studio актуальной версии
- ☕ Рабочий JDK (встроенный или внешний)
- 📦 Android SDK Platform под целевую версию Android
- 💾 Несколько гигабайт свободного места под SDK и кэш Gradle
Создание проекта с нуля
Если готового кода нет, начните с шаблона. В окне приветствия выберите New Project → Empty Activity и задайте имя приложения, пакет (например, com.example.myapp) и минимальную версию Android. Имя пакета важно: именно оно станет уникальным идентификатором приложения, и изменить его после публикации уже не получится.
После создания проекта дождитесь окончания индексации и первой синхронизации Gradle — в нижней части окна исчезнет полоса прогресса. Прерывать этот процесс нельзя: недокачанные зависимости — частая причина ошибок сборки вида Could not resolve all dependencies.
Сборка debug APK — быстрый вариант
Debug-сборка — самый простой способ получить APK. Откройте меню Build → Build Bundle(s) / APK(s) → Build APK(s) и дождитесь уведомления об успешной сборке. По ссылке locate в уведомлении откроется папка с готовым файлом — обычно это app/build/outputs/apk/debug/app-debug.apk.
Такой файл уже можно перекинуть на телефон и установить, предварительно разрешив установку из неизвестных источников в настройках Android. Однако debug-версия подписана тестовым ключом и не подходит для публикации в Google Play — там требуется release-сборка с вашей собственной подписью.
☑️ Проверка перед сборкой APK
Сборка подписанного release APK
Для релизной версии нужен keystore — файл с ключом подписи. Создайте его через Build → Generate Signed Bundle / APK → APK → Create new: укажите путь к файлу, пароли и данные ключа. Храните этот файл и пароли в надёжном месте — потерянный keystore невозможно восстановить, и обновлять приложение под тем же пакетом без него не получится.
Далее выберите вариант сборки release и завершите мастер. Готовый файл появится в папке app/release/. Перед распространением проверьте его установку на реальном устройстве, а не только в эмуляторе — часть ошибок проявляется только на конкретном железе.
⚠️ Внимание: не публикуйте keystore и пароли в репозитории кода, особенно публичном. Утечка ключа позволяет злоумышленнику выпускать поддельные обновления от вашего имени.
Сборка через командную строку
Если Android Studio недоступна или нужна автоматизация, APK собирается через Gradle Wrapper из терминала. В корне проекта выполните команду для debug-варианта:
./gradlew assembleDebugДля релизной сборки команда аналогична — ./gradlew assembleRelease, но без настроенной подписи в build.gradle она выдаст неподписанный файл, который система откажется устанавливать. В Windows вместо ./gradlew используется gradlew.bat.
Чем AAB отличается от APK
AAB (Android App Bundle) — формат публикации для Google Play, из которого магазин сам генерирует APK под конкретное устройство. Установить AAB на телефон напрямую нельзя — сначала его нужно конвертировать, например, через утилиту bundletool.
Типичные ошибки при сборке и их причины
Большинство проблем со сборкой сводится к нескольким повторяющимся сценариям. Сводная таблица поможет быстро сориентироваться:
| Ошибка | Вероятная причина | Что проверить |
|---|---|---|
| SDK location not found | Не указан путь к SDK | Файл local.properties и настройки SDK Location |
| Could not resolve dependencies | Нет сети или недоступен репозиторий | Интернет, блоки repositories в build.gradle |
| INSTALL_FAILED_UPDATE_INCOMPATIBLE | Подпись не совпадает с установленной версией | Удалить старую версию приложения с устройства |
| Keystore password incorrect | Неверный пароль ключа | Пароли keystore и alias вводятся раздельно |
| Приложение не устанавливается | Неподписанный или повреждённый APK | Тип сборки и целостность файла |
Отдельно стоит упомянуть несовпадение версий AGP (Android Gradle Plugin) и Gradle. Если проект открыт в более старой или новой Android Studio, чем та, под которую он создавался, среда предложит обновить плагин — соглашайтесь только если понимаете последствия, либо обновите саму IDE.
⚠️ Внимание: не скачивайте «готовые конструкторы APK» с сомнительных сайтов — такие сервисы нередко встраивают в итоговый файл рекламные модули или вредоносный код, о котором вы не узнаете до жалоб пользователей.
Проверка и установка готового APK
Перед передачей файла убедитесь, что приложение запускается и не падает при старте. Установка на телефон выполняется простым открытием файла через любой файловый менеджер — Android предложит разрешить установку из этого источника. На устройствах без Google-сервисов часть функций (карты, push-уведомления) может работать некорректно, это стоит учитывать при тестировании.
Для проверки подписи и содержимого APK пригодится встроенный анализатор: Build → Analyze APK в Android Studio покажет состав пакета, размеры ресурсов и манифест. Это полезно и для контроля размера — чем меньше файл, тем проще его распространять.
⚠️ Внимание: распространяя APK в обход магазина приложений, вы берёте на себя ответственность за обновления — система не обновит такое приложение автоматически, и пользователям придётся устанавливать новые версии вручную.
Частые вопросы
Можно ли сделать APK без Android Studio?
Да, через командную строку с установленными JDK, SDK и Gradle. Но Android Studio автоматизирует настройку среды, поэтому для начинающих это самый короткий путь.
Почему телефон пишет «приложение не установлено»?
Возможные причины: конфликт подписи с уже установленной версией, повреждённый файл, недостаток памяти или несовместимость minSdkVersion с версией Android на устройстве. Начните с удаления старой версии приложения.
Чем debug APK отличается от release?
Debug подписан тестовым ключом, содержит отладочную информацию и не оптимизирован. Release подписывается вашим ключом, минифицируется и подходит для публикации.
Нужно ли платить за создание APK?
Нет, все инструменты сборки бесплатны. Платной является только регистрация аккаунта разработчика в Google Play, если вы решите публиковаться там.
Можно ли собрать APK из чужого исходного кода?
Технически — да, если код открыт и лицензия это разрешает. Проверьте лицензию репозитория: многие открытые лицензии требуют сохранения указания авторства и не разрешают коммерческое использование без условий.