Кнопка Run в Android Studio не запускает приложение, а сборка зависает или падает с ошибкой Gradle — с этим сталкивается почти каждый, кто впервые открывает чужой или свой новый проект. Чаще всего причина не в коде, а в окружении: не установлен нужный SDK, не создано виртуальное устройство или не завершена синхронизация Gradle.
В этой инструкции разберём полный путь: от открытия проекта до запуска приложения на эмуляторе и реальном смартфоне. Материал подходит для актуальных версий Android Studio на Windows, macOS и Linux, а конкретные названия пунктов меню могут немного отличаться в зависимости от версии среды.
Подготовка: что должно быть установлено
Прежде чем запускать проект, убедитесь, что среда разработки настроена полностью. Минимальный набор — сама Android Studio, комплект Android SDK и актуальная версия JDK, которая обычно поставляется вместе со средой (встроенная JetBrains Runtime).
Проверить наличие SDK можно через File → Settings → Appearance & Behavior → System Settings → Android SDK (на macOS путь начинается с Android Studio → Settings). Во вкладке SDK Platforms должна быть отмечена хотя бы одна версия Android, а во вкладке SDK Tools — Android SDK Build-Tools, Android Emulator и Android SDK Platform-Tools.
- 🧩 Установлена свежая версия Android Studio с официального сайта разработчика
- 📦 Загружена хотя бы одна платформа Android SDK нужного уровня API
- 🛠 Установлены SDK Tools: эмулятор, platform-tools, build-tools
- 💾 Достаточно свободного места на диске — SDK и эмуляторы занимают заметный объём
⚠️ Внимание: если проект открыт из архива, распакованного в папку с кириллицей или пробелами в пути, Gradle иногда завершается с неочевидными ошибками. Надёжнее хранить проекты в каталоге с латинскими символами, например
C:\AndroidProjects.
Открытие проекта и синхронизация Gradle
Открывать проект нужно через File → Open, выбирая корневую папку проекта — ту, где лежат файлы settings.gradle (или settings.gradle.kts) и build.gradle. Открытие вложенной папки модуля вместо корня — частая причина того, что проект «не собирается».
После открытия Android Studio автоматически запускает синхронизацию Gradle: скачивает зависимости, проверяет версии плагинов и формирует конфигурацию сборки. Процесс отображается в нижней панели Build, и прерывать его не стоит — дождитесь сообщения об успешном завершении. Если синхронизация не началась сама, нажмите File → Sync Project with Gradle Files.
Вам может встретиться запрос на повышение версии Android Gradle Plugin или, наоборот, ошибка о несовместимости. В первом случае обновление обычно безопасно, во втором — проверьте, какая версия плагина указана в файле build.gradle корневого уровня, и сопоставьте её с версией среды по официальной таблице совместимости.
Настройка эмулятора (Android Virtual Device)
Если под рукой нет физического устройства, приложение запускается на эмуляторе. Его создание выполняется через Tools → Device Manager → кнопка создания нового виртуального устройства. Далее выбирается модель (например, условный Pixel), системный образ и параметры вроде объёма памяти.
Обратите внимание на системный образ: если образ нужной версии Android не скачан, рядом с ним будет ссылка Download. Для работы эмулятора на Windows также желательно, чтобы в системе была включена виртуализация — в противном случае эмулятор может работать очень медленно или не запускаться вовсе. Конкретный механизм (Hyper-V, WHPX или настройки BIOS) зависит от вашего оборудования.
☑️ Чек-лист перед запуском на эмуляторе
Запуск на реальном устройстве
Запуск на физическом смартфоне часто быстрее и стабильнее эмулятора. Для этого на устройстве нужно активировать режим разработчика и включить отладку по USB. Точные названия пунктов зависят от оболочки производителя, поэтому сверяйтесь с инструкцией для своей модели, но общий принцип такой:
- 📱 Откройте настройки телефона и найдите раздел «О телефоне»
- 🔢 Несколько раз нажмите на пункт «Номер сборки», пока не появится сообщение о включении режима разработчика
- 🔌 В появившемся меню «Для разработчиков» включите «Отладка по USB»
- 💻 Подключите устройство кабелем к компьютеру и подтвердите запрос на разрешение отладки на экране телефона
После подключения устройство должно появиться в выпадающем списке устройств на панели инструментов Android Studio. Если его там нет, проверьте кабель (некоторые кабели передают только питание), переключите режим USB на телефоне и убедитесь, что на Windows установлены драйверы устройства при необходимости.
Запуск проекта: кнопка Run и конфигурации
Сам запуск выполняется кнопкой Run (зелёный треугольник) на панели инструментов или сочетанием клавиш Shift+F10. Перед этим убедитесь, что рядом с кнопкой выбраны правильная конфигурация запуска (обычно app) и целевое устройство — эмулятор или подключённый смартфон.
Android Studio соберёт проект, сформирует APK (или AAB для публикации), установит его на устройство и запустит главную активность. Ход сборки виден во вкладке Build, а логи работающего приложения — в окне Logcat. Именно в Logcat стоит искать причину, если приложение установилось, но сразу закрывается.
Типичные ошибки запуска и их решения
Ниже собраны распространённые проблемы. Формулировки ошибок могут отличаться в зависимости от версий Gradle и плагинов, поэтому ориентируйтесь на смысл сообщения, а не на точный текст.
| Ошибка / симптом | Вероятная причина | Что проверить |
|---|---|---|
| Gradle sync failed | Нет нужной версии SDK или плагина | Версии в build.gradle, наличие SDK в настройках |
| SDK location not found | Не задан путь к SDK | Файл local.properties и настройки Android SDK |
| Устройство не видно в списке | Отладка по USB выключена или не подтверждена | Режим разработчика, кабель, диалог разрешения |
| Эмулятор не стартует | Проблемы с виртуализацией | Настройки виртуализации в системе и BIOS |
| INSTALL_FAILED | Конфликт подписи или версии приложения | Удалить старую версию приложения с устройства |
Если сборка «зависла» без явной ошибки, помогает последовательность Build → Clean Project, затем Build → Rebuild Project. При подозрении на повреждённый кэш среды используется File → Invalidate Caches. Эти действия безопасны: они не затрагивают исходный код, а лишь заставляют среду пересобрать служебные данные.
⚠️ Внимание: не удаляйте папки
.gradleиbuildвручную «вслепую» во время работающей синхронизации — сначала закройте проект или всю среду, иначе файлы могут остаться заблокированными, а повреждённый кэш усугубит проблему.
Что делать, если Gradle скачивает зависимости слишком долго
Проверьте стабильность интернет-соединения — при первом открытии проекта Gradle загружает библиотеки из репозиториев. Убедитесь, что доступ к сети не блокируется брандмауэром или антивирусом. Если сеть ограничена, можно настроить прокси в File → Settings → Appearance & Behavior → System Settings → HTTP Proxy. Повторные сборки обычно идут быстрее, так как зависимости кэшируются локально.
Сборка APK без запуска
Иногда нужно не запустить приложение, а просто получить установочный файл. Для этого используется команда Build → Build App Bundle(s) / APK(s) → Build APK(s). Готовый файл появится в каталоге модуля, в подпапке build/outputs/apk, а среда покажет уведомление со ссылкой locate для быстрого перехода к нему.
Такой debug-APK подписан отладочным ключом и подходит только для тестирования — для публикации в магазине приложений потребуется релизная сборка с собственным ключом подписи. Не передавайте отладочные файлы как финальный продукт: они могут содержать лишние логи и работать медленнее релизной версии.
Также APK можно собрать из командной строки, находясь в корне проекта:
gradlew assembleDebugНа Windows используется gradlew.bat, на macOS и Linux — ./gradlew. Этот способ удобен, когда нужно проверить, собирается ли проект вне среды разработки.
FAQ: частые вопросы
Почему кнопка Run неактивна (серая)?
Обычно это значит, что синхронизация Gradle ещё не завершена или завершилась с ошибкой. Дождитесь окончания процесса в панели Build и устраните ошибки синхронизации. Также проверьте, что выбрана конфигурация запуска (например, app) рядом с кнопкой Run.
Можно ли запустить проект без эмулятора и телефона?
Полноценно запустить Android-приложение без устройства нельзя — нужен либо эмулятор, либо физический смартфон. Однако собрать APK и проверить компиляцию кода можно и без них, через Build → Build APK(s).
Что делать, если проект требует другую версию Android Studio?
Проверьте версию Android Gradle Plugin в корневом файле build.gradle и сопоставьте её с таблицей совместимости на официальном сайте разработчиков Android. Иногда достаточно обновить плагин, иногда — установить более новую или более старую версию самой среды.
Приложение установилось, но сразу вылетает. Где искать причину?
Откройте окно Logcat в нижней части Android Studio и выберите своё устройство и процесс приложения. Стектрейс исключения (обычно с пометкой FATAL EXCEPTION) укажет класс и строку, где произошёл сбой.
Нужен ли интернет для запуска проекта?
При первом открытии проекта интернет обычно нужен для скачивания зависимостей Gradle. После того как библиотеки закэшированы, сборка и запуск возможны офлайн, если включён режим Gradle Offline или все зависимости уже загружены.