Пошаговый запуск приложения в Android Studio
Чтобы запустить приложение: соберите проект, настройте Run Configuration, выберите эмулятор или USB‑устройство и нажмите Run (Shift+F10). Ниже — короткая и прикладная инструкция с решениями типичных ошибок.
Подготовка проекта
- Соберите проект и проверьте ошибки: Build > Make Project (Ctrl+F9). Исправьте красные ошибки до запуска.
- Проверьте SDK и инструменты: Tools > SDK Manager. Убедитесь, что установлены Platform‑Tools и нужные API‑уровни (рекомендуется API 24+ для современных проектов).
- Синхронизируйте Gradle: File > Sync Project with Gradle Files после изменений в build.gradle.
- Проверьте манифест: в AndroidManifest.xml должна быть activity с intent-filter android.intent.action.MAIN и android.intent.category.LAUNCHER.
- Если приложение использует нативные библиотеки, пропишите abiFilters в модуле: ndk { abiFilters 'armeabi-v7a','arm64-v8a' } — это уменьшит проблемы с установкой на устройство.
Запускайте сначала простой шаблон (Empty Activity). Это ускоряет локализацию проблем при настройке окружения.
Настройка Run Configuration и выбор устройства
- Откройте Run > Edit Configurations. Убедитесь, что выбрана конфигурация типа Android App и Module = app (или ваш модуль).
- В поле Launch Options укажите Launch default Activity или конкретный класс (например, com.example.MainActivity).
- Target: выберите USB Device для физического телефона или Open Select Android Device Dialog для эмулятора.
- Build Variant: Debug для разработки; Release — только для тестирования релизной сборки (Build Variants).
- Для эмулятора: Tools > Device Manager > Create device → выберите образ (API и ABI) и выделите 2 ГБ RAM или больше для стабильности.
- Для физического устройства: включите Developer Options (Настройки > О телефоне > 7 тапов по Build number) и включите USB debugging. Подключите USB и подтвердите разрешение отладки на устройстве.
Для сокращения перезапусков используйте Apply Changes (вместо устаревшего Instant Run) — применяет изменения без полного рестарта приложения.
Запуск, мониторинг и быстрая отладка
- Запустите приложение: зелёная кнопка Run или Shift+F10. В появившемся списке выберите устройство.
- Если приложение не устанавливается из‑за конфликта подписи — удалите старую сборку с устройства: adb uninstall com.example.myapp или вручную.
- Логи и стек‑трейсы смотрите в Logcat (View > Tool Windows > Logcat). Фильтруйте по package name.
- Если эмулятор долго грузится — используйте Cold Boot или Wipe Data в AVD Manager. Иногда помогает увеличение выделенной памяти.
- Для массового тестирования: Run > Run on Multiple Devices.
Если Studio тормозит или Gradle потребляет ресурсы — остановите демон: ./gradlew --stop в терминале и включите Power Save Mode (File > Power Save Mode) на время.
Частые ошибки запуска и быстрые исправления
Таблица: Частые ошибки запуска и как быстро исправить
| Ошибка | Причина | Быстрое решение |
|---|---|---|
| "SDK tools not found" | Нет нужных SDK/Build‑Tools | SDK Manager → установите Platform‑Tools и Build‑Tools, перезапустите Studio |
| "No target device" | Нет запущенного AVD или устройство не подключено | Запустите AVD или включите USB debugging; adb devices для проверки |
| "Installation failed" (INSTALL_FAILED_SIGNATURE | OLDER_SDK) | Конфликт подписи или несовместимый ABI |
| "Gradle sync failed" | Несовместимая версия Gradle/AGP или сеть | Обновите gradle-wrapper.properties, проверьте proxy/интернет |
| "App crashes on launch" | Ошибка в манифесте/MainActivity или NullPointer | Посмотрите stack trace в Logcat, проверьте setContentView и манифест |
| "Emulator stuck on boot" | Недостаточно RAM/повреждён AVD | Wipe Data или пересоздайте AVD, увеличьте RAM/CPU |
| "Device offline" | Плохой USB/ADB | adb kill-server && adb start-server; переподключите кабель |
FAQ
-
Как запустить приложение по Wi‑Fi на реальном устройстве?
- Подключите устройство по USB, выполните adb tcpip 5555, отключите USB и подключитесь adb connect
:5555. Затем выберите устройство в Studio.
- Подключите устройство по USB, выполните adb tcpip 5555, отключите USB и подключитесь adb connect
-
Что делать, если Gradle не скачивает зависимости?
- Проверьте интернет, настройки proxy в Settings > Appearance & Behavior > System Settings > HTTP Proxy и повторите sync. Иногда помогает очистка кеша: File > Invalidate Caches / Restart.
-
Как быстро найти нужный package для фильтра Logcat?
- В AndroidManifest.xml посмотрите package или используйте Build Variants → скомпилируйте и в Run Console найдите applicationId.
-
Почему запуск работает на эмуляторе, но не на телефоне?
- Часто из‑за несовместимого ABI, неподходящего minSdkVersion или подписи. Сравните ABI и minSdk, удалите старые версии приложения.
Если проблема не решается — скопируйте полный stack trace из Logcat и начинайте с минимального проекта (Empty Activity) для поэтапной изоляции ошибки. Практика и постепенная локализация помогают устранить 95% проблем запуска.