Создание проекта в Android Studio начинается не с кода, а с мастера New Project, и именно на этом этапе чаще всего допускаются ошибки: выбирают неподходящий шаблон, указывают слишком высокий Minimum SDK или неправильно заполняют имя пакета, которое потом сложно изменить. Первый запуск мастера занимает несколько минут, если заранее понимать, что означает каждое поле.
В этом руководстве разберём весь процесс: от проверки установленной среды разработки до первого запуска приложения на эмуляторе или реальном устройстве. Инструкция актуальна для современных версий Android Studio, однако расположение отдельных пунктов меню может немного отличаться в зависимости от версии IDE — в таком случае ориентируйтесь на встроенный поиск по настройкам.
Подготовка: что нужно проверить перед созданием проекта
Прежде чем нажимать кнопку создания проекта, убедитесь, что среда разработки установлена корректно. Запустите Android Studio и откройте SDK Manager — он доступен с приветственного экрана или через меню Tools → SDK Manager. Здесь проверяется наличие хотя бы одной установленной версии Android SDK Platform и инструментов сборки.
Обратите внимание на два момента. Во-первых, на вкладке SDK Platforms должна быть отмечена хотя бы одна версия Android — без неё проект не скомпилируется. Во-вторых, на вкладке SDK Tools нужны Android SDK Build-Tools и Android Emulator, если планируете тестировать приложение на виртуальном устройстве.
- 💾 Свободное место на диске — среда разработки вместе с SDK и эмулятором занимает значительный объём, поэтому заранее убедитесь, что места достаточно.
- ⚡ Стабильное интернет-соединение — при первом создании проекта Gradle скачивает зависимости, и прерывание загрузки может привести к ошибкам сборки.
- 🖥️ Включённая виртуализация в BIOS/UEFI — без неё эмулятор будет работать очень медленно или не запустится вовсе.
- ☕ Корректно настроенный JDK — современные версии Android Studio поставляются со встроенной Java, поэтому отдельная установка обычно не требуется.
⚠️ Внимание: если при первом запуске мастер настройки не смог скачать компоненты SDK, не пропускайте этот шаг. Проект без установленного SDK создать можно, но собрать и запустить его не получится — вы увидите ошибку синхронизации Gradle.
Запуск мастера создания проекта
На приветственном экране Android Studio нажмите New Project. Если IDE уже открыта с другим проектом, используйте путь File → New → New Project. Откроется окно выбора шаблона — это первый важный шаг.
Шаблон определяет стартовую структуру приложения. Для обучения и большинства задач подходит Empty Activity — минимальный шаблон с одним экраном. Вариант Empty Views Activity создаёт проект на классических Views с XML-разметкой, тогда как просто Empty Activity в новых версиях IDE по умолчанию использует Jetpack Compose — декларативный подход к интерфейсу на Kotlin.
Остальные шаблоны — Bottom Navigation Activity, Navigation Drawer Activity и другие — добавляют готовые элементы интерфейса. Они удобны, когда вы точно знаете, какая навигация нужна приложению, но для первого проекта избыточны.
Настройка параметров проекта
После выбора шаблона откроется форма с полями конфигурации. Каждое из них влияет на дальнейшую работу, поэтому разберём их по отдельности.
Поле Name — отображаемое название приложения, которое увидит пользователь. Package name — уникальный идентификатор приложения в формате обратного домена, например com.example.myapp. Именно по нему система отличает одно приложение от другого, и после публикации в магазине изменить его нельзя. Save location — папка на диске; избегайте путей с кириллицей и пробелами, это иногда вызывает проблемы со сборкой.
Отдельного внимания заслуживает Minimum SDK — минимальная версия Android, на которой будет работать приложение. Чем ниже версия, тем шире охват устройств, но тем больше ограничений при использовании современных API. Рядом с полем мастер показывает примерный процент поддерживаемых устройств — ориентируйтесь на него.
| Параметр | Назначение | Рекомендация |
|---|---|---|
| Name | Название приложения | Короткое и понятное, без спецсимволов |
| Package name | Уникальный ID приложения | Формат com.имя.приложение, не меняется после публикации |
| Save location | Папка проекта | Путь без кириллицы и пробелов |
| Minimum SDK | Минимальная версия Android | Баланс между охватом и доступными API |
| Build Configuration Language | Язык скриптов сборки | Kotlin DSL — современный вариант по умолчанию |
⚠️ Внимание: имя пакета, заданное на этом шаге, станет
applicationIdприложения. Переименовать его в существующем проекте можно, но это потребует правки нескольких файлов и рефакторинга — лучше сразу указать корректное значение.
☑️ Проверка перед нажатием Finish
Первая сборка и синхронизация Gradle
После нажатия Finish начинается самый долгий этап — синхронизация Gradle. Система сборки скачивает зависимости, указанные в файлах build.gradle.kts (или build.gradle), и настраивает проект. При первом запуске это может занять заметное время — всё зависит от скорости соединения и мощности компьютера.
Прогресс отображается в нижней панели IDE. Не закрывайте программу и не пытайтесь редактировать файлы, пока идёт синхронизация. Если процесс завершился ошибкой, откройте вкладку Build внизу окна — там указана конкретная причина: недоступный репозиторий, отсутствующая версия SDK или конфликт зависимостей.
Типичная ситуация — ошибка вида SDK location not found. Она означает, что IDE не знает, где находится Android SDK. Проверьте файл local.properties в корне проекта: в нём должна быть строка с путём к SDK, либо задайте путь через File → Project Structure → SDK Location.
Структура созданного проекта
Когда синхронизация завершена, полезно разобраться, что именно сгенерировала среда. В панели Project слева переключите представление на Android — оно группирует файлы по назначению, а не по фактическому расположению на диске.
Ключевые элементы структуры: папка app/src/main содержит исходный код и ресурсы. Файл AndroidManifest.xml описывает компоненты приложения и разрешения. В подпапке res хранятся строки, цвета, иконки и разметка. Скрипты сборки — build.gradle.kts на уровне проекта и модуля — управляют зависимостями и параметрами компиляции.
Зачем нужен файл settings.gradle
Этот файл сообщает Gradle, какие модули входят в проект, и задаёт репозитории для поиска зависимостей. В простом приложении модуль один — app, но в крупных проектах их может быть несколько: библиотеки, модули функций, общий код.
Точка входа в приложение — класс MainActivity. В шаблоне с Jetpack Compose интерфейс описывается прямо в нём функциями с аннотацией @Composable. В классическом варианте активность загружает XML-разметку из res/layout. Найдите этот файл и попробуйте изменить текст на экране — это самый быстрый способ убедиться, что всё работает.
Запуск приложения на эмуляторе и устройстве
Для запуска нужна цель — эмулятор или физическое устройство. Эмулятор создаётся через Device Manager (иконка на правой панели или меню Tools → Device Manager). Нажмите Create Device, выберите модель виртуального смартфона и образ системы — при отсутствии образа IDE предложит его скачать.
Запуск выполняется кнопкой Run (зелёный треугольник) или сочетанием клавиш Shift+F10. Первая загрузка эмулятора может занять несколько минут — последующие запуски быстрее, если не закрывать виртуальное устройство.
Для запуска на реальном смартфоне необходимо включить отладку по USB: в настройках телефона откройте раздел «О телефоне», несколько раз нажмите на номер сборки, чтобы активировать режим разработчика, затем в появившемся меню «Для разработчиков» включите отладку по USB. Точные названия пунктов зависят от оболочки производителя, поэтому при расхождениях сверяйтесь с документацией вашего устройства. После подключения кабелем телефон появится в списке целей запуска, а на его экране нужно подтвердить разрешение на отладку.
⚠️ Внимание: если эмулятор не стартует с ошибкой виртуализации, проверьте, включены ли технологии виртуализации (VT-x/AMD-V) в BIOS/UEFI, а на Windows — что не конфликтуют компоненты Hyper-V и платформа гипервизора. Изменение этих настроек требует перезагрузки компьютера.
Частые ошибки новичков и их решение
Даже при точном следовании инструкции первый проект может не запуститься. Большинство проблем относятся к нескольким типовым сценариям, и все они решаются без переустановки среды.
- 🔴 Ошибка синхронизации Gradle — проверьте интернет-соединение и повторите синхронизацию через
File → Sync Project with Gradle Files. - 📦 Отсутствует нужная версия SDK — откройте
SDK Managerи установите платформу, указанную в сообщении об ошибке. - 🚫 Устройство не определяется — проверьте кабель (некоторые кабели передают только питание), повторно разрешите отладку на телефоне и обновите драйверы, если работаете на Windows.
- 🐌 Эмулятор тормозит — убедитесь, что виртуализация включена, и выделите виртуальному устройству меньше ресурсов в настройках, если компьютер слабый.
Если ошибка не поддаётся диагностике, используйте Build → Clean Project, а затем Rebuild Project — это очищает промежуточные файлы сборки и часто устраняет странные сбои. В крайнем случае помогает File → Invalidate Caches с перезапуском IDE.
Часто задаваемые вопросы
Какой язык выбрать при создании проекта — Kotlin или Java?
Для новых проектов рекомендуется Kotlin — это официально предпочтительный язык Android-разработки, все современные шаблоны и документация ориентированы на него. Java остаётся рабочим вариантом, но новые API и примеры выходят в первую очередь на Kotlin.
Можно ли создать проект без подключения к интернету?
Полноценно — нет. При первом создании проекта Gradle скачивает библиотеки и плагины из репозиториев. Если все зависимости уже были загружены ранее и есть локальный кэш, сборка возможна и офлайн, но для первого проекта интернет необходим.
Что делать, если кнопка Run неактивна?
Обычно это значит, что синхронизация Gradle ещё не завершена или завершилась с ошибкой. Дождитесь окончания процесса в нижней панели и проверьте вкладку Build на наличие сообщений. Также убедитесь, что в списке конфигураций запуска выбран модуль app.
Сколько места занимает Android Studio со всеми компонентами?
Точный объём зависит от количества установленных версий SDK и эмуляторов, но следует закладывать значительный запас — десятки гигабайт с учётом кэша Gradle, образов виртуальных устройств и самих проектов. Регулярно очищайте неиспользуемые эмуляторы и старые версии SDK через SDK Manager.
Можно ли изменить имя пакета после создания проекта?
Технически да, но это потребует рефакторинга структуры папок и правки applicationId в файле сборки модуля. Если приложение уже опубликовано в магазине, изменить идентификатор нельзя — придётся публиковать его как новое приложение. Поэтому имя пакета лучше продумать на этапе создания проекта.