Кнопка New Project в Android Studio недоступна или мастер создания проекта зависает на этапе загрузки — чаще всего причина в том, что Android SDK не установлен полностью или IDE не может подтянуть зависимости Gradle из сети. Прежде чем искать ошибку, проверьте базовое: установлен ли SDK через Tools → SDK Manager и есть ли стабильное подключение к интернету при первом запуске проекта.
Создание проекта в Android Studio — это не просто нажатие одной кнопки: от правильных настроек на старте зависит, как будет собираться приложение, на каких устройствах оно запустится и сколько времени уйдёт на первую сборку. В этом руководстве разберём весь процесс по шагам — от выбора шаблона до запуска приложения на эмуляторе, а также типичные ошибки новичков и способы их устранения.
Подготовка: что нужно установить перед созданием проекта
Прежде чем приступать к созданию проекта, убедитесь, что среда разработки настроена корректно. Android Studio при первом запуске предлагает мастер установки, который загружает необходимые компоненты. Если вы пропустили этот шаг или установка прервалась, проверьте состояние через Tools → SDK Manager.
- 📦 Android SDK Platform — платформа нужной версии Android, под которую будет собираться приложение.
- 🛠️ Android SDK Build-Tools — инструменты сборки, без которых компиляция невозможна.
- 💻 Android Emulator — эмулятор для запуска приложения без физического устройства.
- 🔌 Android SDK Command-line Tools — утилиты командной строки, которые использует Gradle.
⚠️ Внимание: при первом создании проекта Gradle скачивает зависимости из интернета, и этот процесс может занять продолжительное время в зависимости от скорости соединения. Не прерывайте сборку — прерванная загрузка часто приводит к повреждённому кэшу и ошибкам вида Gradle sync failed.
Если компоненты отображаются как установленные, но проект не собирается, откройте вкладку SDK Tools в SDK Manager и сверьте отметки со списком выше. Точный набор обязательных компонентов зависит от версии Android Studio, поэтому при сомнениях ориентируйтесь на официальную документацию для вашей версии IDE.
Шаг 1. Запуск мастера создания проекта
Откройте Android Studio и на стартовом экране нажмите New Project. Если IDE уже открыта с другим проектом, используйте путь File → New → New Project. Откроется окно выбора шаблона.
Шаблон определяет стартовую структуру приложения: какие экраны и компоненты будут созданы автоматически. Для первого проекта оптимален вариант Empty Activity — он создаёт один пустой экран с минимальным кодом, без лишних зависимостей. Шаблоны вроде Bottom Navigation Activity или Navigation Drawer Activity добавляют готовую навигацию, но усложняют код, в котором новичку сложно разобраться.
Шаг 2. Настройка параметров проекта
На следующем экране мастера нужно заполнить несколько полей. Отнеситесь к ним внимательно — часть параметров потом менять неудобно.
| Параметр | Что указать | На что влияет |
|---|---|---|
| Name | Имя приложения, например MyFirstApp | Отображаемое название и имя модуля |
| Package name | Уникальный идентификатор, например com.example.myfirstapp | Идентификатор приложения в системе и магазине |
| Save location | Папка на диске без кириллицы в пути | Корректность сборки и путей к файлам |
| Language | Kotlin или Java | Язык исходного кода проекта |
| Minimum SDK | Минимальная версия Android | Диапазон поддерживаемых устройств |
Путь к проекту не должен содержать кириллических символов и пробелов в именах папок — это одна из самых частых причин загадочных ошибок сборки у пользователей, чьё имя учётной записи Windows написано на русском языке. Создайте отдельную папку вида C:\AndroidProjects и сохраняйте проекты туда.
Параметр Minimum SDK задаёт минимальную версию Android, на которой приложение запустится. Чем ниже версия, тем шире охват устройств, но тем больше ограничений по доступным API. Мастер показывает примерный процент поддерживаемых устройств прямо под полем выбора — ориентируйтесь на него.
Шаг 3. Выбор языка: Kotlin или Java
Google официально рекомендует Kotlin как основной язык для Android-разработки, и большинство современных шаблонов и документации ориентированы именно на него. Для нового проекта разумный выбор — Kotlin, если только у вас нет конкретной задачи поддерживать существующий код на Java.
Оба языка полностью совместимы: в одном проекте могут сосуществовать файлы .kt и .java. Поэтому выбор на старте не является необратимым, но единый язык упрощает чтение и поддержку кода.
Что такое Gradle и зачем он нужен
Gradle — система сборки, которую Android Studio использует для компиляции кода, управления зависимостями и упаковки приложения в APK или AAB. Настройки сборки хранятся в файлах build.gradle (или build.gradle.kts для Kotlin DSL) на уровне проекта и модуля. При первом создании проекта Gradle скачивает указанные в этих файлах библиотеки, поэтому требуется интернет.
Шаг 4. Структура созданного проекта
После нажатия Finish Android Studio сгенерирует проект и запустит первую синхронизацию Gradle. Дождитесь её завершения — статус виден в нижней панели IDE. Затем переключите панель проекта в режим Android, чтобы увидеть логическую структуру.
- 📁 app → java — исходный код приложения, включая MainActivity.
- 🎨 res → layout — XML-файлы разметки экранов (если шаблон не на Compose).
- 🖼️ res → drawable, mipmap — изображения и иконки приложения.
- ⚙️ manifests → AndroidManifest.xml — декларация компонентов и разрешений приложения.
Файл AndroidManifest.xml описывает, какие Activity есть в приложении, какая из них стартовая и какие разрешения требуются. На первых порах редактировать его вручную почти не придётся — шаблон уже содержит рабочую конфигурацию.
☑️ Проверка после создания проекта
Шаг 5. Запуск приложения на эмуляторе или устройстве
Чтобы проверить, что проект создан корректно, запустите его. Откройте Tools → Device Manager и создайте виртуальное устройство, выбрав модель и образ системы. Если на компьютере включена виртуализация, эмулятор будет работать заметно быстрее — при проблемах с производительностью проверьте настройки BIOS/UEFI, там параметр обычно называется Intel VT-x или AMD-V.
Альтернатива — физическое устройство. На смартфоне нужно включить режим разработчика и отладку по USB, затем подключить его кабелем и разрешить отладку в диалоге на экране телефона. Точное расположение этих настроек зависит от производителя и версии Android, поэтому сверяйтесь с инструкцией для вашей модели.
Нажмите зелёную кнопку Run (или сочетание Shift+F10). Если всё настроено верно, через некоторое время на экране появится приложение с надписью «Hello World» или стартовым экраном шаблона.
Типичные ошибки при создании проекта и их решение
Что делать, если вместо готового проекта вы видите ошибку? Разберём самые распространённые сценарии.
Gradle sync failed. Возможная причина — проблемы с сетью, прокси или повреждённый кэш. Попробуйте File → Invalidate Caches → Invalidate and Restart, затем повторите синхронизацию. Также проверьте, не блокирует ли антивирус или брандмауэр доступ IDE к сети.
Ошибки с кириллицей в путях. Проявляются как невозможность найти файлы или сбой сборки без понятного сообщения. Перенесите проект в папку без русских букв, как описано выше, — в большинстве подобных случаев это решает проблему полностью.
⚠️ Внимание: не меняйте вручную версии Gradle и Android Gradle Plugin в файлах сборки, если не понимаете их совместимость. Несовместимые версии — частый источник ошибок, а Android Studio сама предложит обновление, когда это безопасно, через диалог Upgrade Assistant.
Эмулятор не запускается. Проверьте, включена ли виртуализация, достаточно ли свободной оперативной памяти и не конфликтует ли эмулятор с другими гипервизорами в системе. При нехватке ресурсов создайте виртуальное устройство с меньшим объёмом RAM.
Часто задаваемые вопросы
Сколько места на диске нужно для Android Studio и проектов?
Сама IDE вместе с SDK, эмуляторами и кэшем Gradle занимает заметный объём — закладывайте запас в десятки гигабайт на системном диске. Точный размер зависит от количества установленных платформ и образов эмуляторов.
Можно ли создать проект без интернета?
Полностью автономно — только если все зависимости Gradle уже были скачаны ранее. При первом создании проекта интернет обязателен: IDE загружает библиотеки и плагины, указанные в файлах сборки.
Чем отличается Empty Activity от Empty Views Activity?
В актуальных версиях Android Studio шаблон Empty Activity по умолчанию использует Jetpack Compose — декларативный подход к интерфейсу на Kotlin. Вариант с Views создаёт классическую XML-разметку. Для изучения современного подхода выбирайте Compose, для работы с унаследованным кодом — Views.
Как открыть существующий проект, а не создавать новый?
На стартовом экране нажмите Open и укажите корневую папку проекта — ту, где лежит файл settings.gradle. Открывать папку app отдельно не нужно: IDE должна увидеть проект целиком, иначе синхронизация не выполнится.
Обязательно ли использовать Kotlin для нового проекта?
Нет, Java по-прежнему поддерживается. Однако новые API, примеры в документации и библиотеки в первую очередь ориентированы на Kotlin, поэтому для обучения с нуля он предпочтительнее.