Создание первого проекта Android: подробное руководство для начинающих

Введение / Зачем это нужно

Создание первого проекта в Android Studio — это первый и самый важный шаг в мире разработки под Android. Этот гайд проведёт вас через весь процесс: от запуска мастера до появления работающего приложения на экране эмулятора или устройства. Вы получите базовое понимание структуры проекта, научитесь настраивать эмулятор и запускать код. Идеально для тех, кто только начинает путь Android-разработчика.

Требования / Подготовка

Перед началом убедитесь, что у вас есть:

• Android Studio версии 2023.1.1 (Hedgehog) или новее. Скачать можно с официального сайта.
• Android SDK (устанавливается автоматически с Android Studio).
• Минимум 8 ГБ оперативной памяти и 10 ГБ свободного места на диске.
• Для эмулятора: включённая виртуализация в BIOS/UEFI (Intel VT-x или AMD-V). На процессорах Intel может потребоваться установка Intel HAXM, на AMD — Android Emulator Hypervisor Driver.
• Если используете физическое устройство: устройство с Android 7.0 (API 24) или выше, кабель USB и включённая опция USB debugging (в Developer options).

💡 Совет: Если вы только установили Android Studio, запустите его один раз, чтобы завершить настройку SDK и загрузить необходимые компоненты.

Шаг 1: Запуск мастера создания проекта

Откройте Android Studio. При первом запуске может появиться окно импорта настроек — выберите "Do not import settings". На стартовом экране нажмите "New Project". Если у вас уже открыт какой-то проект, перейдите в меню File → New → New Project.

Шаг 2: Выбор шаблона

В разделе "Phone and Tablet" выберите шаблон "Empty Activity" (пустая активность). Этот шаблон создаёт минимальный проект с одной активностью и разметкой, что идеально для начала. Нажмите "Next".

Шаг 3: Настройка проекта

Заполните основные параметры:

• Name: имя вашего приложения, например, MyFirstApp.
• Package name: уникальный идентификатор пакета (обычно в формате com.example.имя). Можно оставить предложенное значение, например, com.example.myfirstapp.
• Save location: папка для сохранения проекта. Оставьте по умолчанию или выберите удобную.
• Language: выберите Kotlin (рекомендуется) или Java.
• Minimum SDK: минимальная версия Android, на которой будет работать приложение. Для первого проекта выберите API 24 (Android 7.0) — это обеспечит хороший охват устройств. Если нужно поддержку более старых версий, выберите ниже, но учтите, что некоторые современные API могут быть недоступны.

После заполнения нажмите "Finish". Android Studio начнёт создание проекта, загрузит необходимые зависимости и откроет основной интерфейс. Это может занять несколько минут, в зависимости от скорости интернета и производительности компьютера.

Шаг 4: Запуск приложения

После создания проекта откроется файл MainActivity.kt (или MainActivity.java) и разметка activity_main.xml. По умолчанию приложение отображает текст "Hello World!". Чтобы запустить его:

1. Убедитесь, что в панели инструментов выбран правильный модуль (обычно app).
2. Нажмите кнопку "Run" (зелёный треугольник) или используйте сочетание клавиш Shift+F10.
3. Если у вас ещё нет настроенного эмулятора, Android Studio предложит "Create Virtual Device". Следуйте инструкциям:
   • Выберите устройство (например, Pixel 6) и нажмите "Next".
   • Выберите системный образ (рекомендуется последняя стабильная версия, например, Tiramisu API 33 или выше). Если образ не установлен, нажмите "Download" и дождитесь загрузки.
   • После установки образа нажмите "Finish".
   • Вернитесь к окну выбора устройства и выберите созданный AVD, затем нажмите "OK".
4. Эмулятор загрузится (это может занять 2-5 минут). После загрузки приложение автоматически установится и запустится.

Использование физического устройства:

1. Включите Developer options (в Настройках → Об устройстве нажмите Build number 7 раз).
2. В Developer options включите USB debugging.
3. Подключите устройство к компьютеру по USB.
4. Разрешите отладку на устройстве при появлении запроса.
5. В Android Studio выберите ваше устройство из списка и нажмите "Run".

Шаг 5: Проверка результата

На эмуляторе или устройстве должно появиться приложение с надписью "Hello World!" (или указанным вами именем в заголовке). Если приложение запустилось без ошибок, вы успешно создали и запустили первый проект!

Дополнительно проверьте:

• Logcat (в нижней панели Android Studio) на наличие ошибок. Успешный запуск выведет сообщения вида I/ActivityManager: Displayed com.example.myfirstapp/.MainActivity.
• Иконку приложения в списке приложений эмулятора/устройства.

Возможные проблемы

• Эмулятор не запускается или работает очень медленно:
  • Убедитесь, что виртуализация включена в BIOS/UEFI (Intel VT-x/AMD-V).
  • Для процессоров Intel установите Intel HAXM через SDK Manager (Tools → SDK Manager → SDK Tools → Intel x86 Emulator Accelerator). Для AMD установите Android Emulator Hypervisor Driver.
  • Увеличьте объём ОЗУ для AVD (AVD Manager → pencil icon → Show Advanced Settings → Memory).
  • На Windows может потребоваться включить Windows Hypervisor Platform (в "Включение или отключение компонентов Windows").
• Ошибка INSTALL_FAILED_OLDER_SDK: Минимальный SDK вашего проекта выше, чем версия Android на устройстве/эмуляторе. Либо увеличьте версию Android на устройстве, либо уменьшите минимальный SDK: File → Project Structure → Modules → Default Config → Min SDK Version.
• Устройство не определяется в списке:
  • Проверьте, установлены ли драйверы (для Windows — драйверы OEM, для Linux/Mac обычно не требуются).
  • Убедитесь, что USB-режим на устройстве установлен как "Файлы" или "PTP".
  • Перезагружите ADB: в терминале Android Studio выполните adb kill-server и затем adb start-server.
• Ошибка Failed to resolve: com.android.tools.build:gradle: Проверьте подключение к интернету и настройки прокси (File → Settings → Appearance & Behavior → System Settings → HTTP Proxy). Также можно попробовать File → Invalidate Caches and Restart.