Как настроить Flutter в Android Studio и запустить первый проект

Чтобы запустить Flutter в Android Studio: установите Android Studio и Flutter SDK, добавьте flutter/bin в PATH, установите плагины Flutter и Dart в IDE, укажите путь к SDK в настройках, создайте новый Flutter‑проект и запустите его на эмуляторе или реальном устройстве — все шаги ниже.

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

  • Минимум: 8 ГБ RAM, 10 ГБ свободного места, 64‑битная ОС (Windows 10+, macOS 11+, Ubuntu 20.04+).
  • Установите последнюю Android Studio. Внутри IDE обновите Android SDK (Android 14+) и компоненты SDK Tools.
  • Java: JDK 17+ обычно встроен в Android Studio. Для эмулятора: HAXM (Intel), Hypervisor Framework (Apple Silicon) или KVM (Linux).

Если у вас не установлен Git, установите его — он потребуется для некоторых шаблонов и работы с пакетами.

Установка Flutter SDK и настройка PATH

  1. Скачайте архив SDK для вашей ОС и распакуйте в постоянную папку:
    • Windows: C:\flutter
    • macOS/Linux: ~/development/flutter Не распаковывайте в Program Files или папки с ограничениями прав.
  2. Добавьте flutter/bin в PATH:
    • Windows: через переменные окружения System → Advanced → Environment Variables → Path → Add C:\flutter\bin.
    • macOS/Linux: в ~/.zshrc или ~/.bashrc добавьте export PATH="$PATH:~/development/flutter/bin" и выполните source.
  3. Откройте терминал и выполните: flutter doctor Исправьте пометки (Android toolchain, Android SDK, Xcode для macOS, Chrome для веб). Цель — все проверки в зеленой зоне.

Плагины и интеграция в Android Studio

  1. Запустите Android Studio → File → Settings → Plugins.
  2. Установите плагины Flutter и Dart из Marketplace, перезапустите IDE.
  3. Укажите путь к Flutter SDK: File → Settings → Languages & Frameworks → Flutter → Flutter SDK path → выберите распакованную папку.
  4. Включите инструменты: View → Tool Windows → Flutter Inspector и DevTools (по необходимости).

Плагин Dart нужен для подсветки и анализа кода; Flutter даёт поддержку шаблонов, горячую перезагрузку и интеграцию с эмулятором.

Создание и запуск первого проекта

  1. File → New → New Flutter Project → Flutter Application.
  2. Задайте имя (lowercase_with_underscores), Bundle ID (например com.example.myapp) и Platforms (Android, iOS).
  3. Подождите, пока IDE загрузит зависимости (flutter pub get).
  4. Создание эмулятора: Tools → AVD Manager → Create Virtual Device → выберите образ (Pixel, API 34+), запустите.
  5. В тулбаре выберите устройство и нажмите Run (зелёная стрелка) или Shift+F10. Приложение запустится (демо‑счётчик).
  6. Горячая перезагрузка: используйте кнопку Hot Reload в тулбаре или в терминале при flutter run нажмите r (R — полный перезапуск).

Частые ошибки

  • "Flutter SDK not found" — PATH не настроен или IDE не перезапущена. Решение: проверьте flutter doctor, укажите путь в настройках и перезапустите Android Studio.
  • Эмулятор не стартует — отсутствует HAXM/HVF/KVM. Решение: включите аппаратную виртуализацию и установите соответствующий компонент в SDK Manager.
  • Build failed (Gradle) — несовместимый Android SDK/Build Tools. Решение: обновите SDK (Android 14+), выполните flutter clean и flutter pub get.
  • iOS не собирается — нет Xcode (macOS). Решение: установите Xcode и командную строку инструментов (xcode-select).
  • Hot Reload не работает — фоновая сборка или запущено не через flutter run. Решение: перезапустите запуск через IDE или терминал.

FAQ

  • Нужно ли отдельное Android SDK? Да — Android Studio включает SDK Manager; убедитесь, что установлены платформы Android и инструменты сборки.
  • Где хранить Flutter SDK? В постоянном каталоге вне Program Files с правами доступа пользователя.
  • Как протестировать на реальном устройстве? Включите USB Debugging на Android и подключите устройство, в списке устройств выберите его и запустите.
  • Можно ли собирать iOS на Windows? Нет — для сборки iOS нужен macOS с Xcode.

Дополнительно: подключите DevTools для профилирования, используйте state management (Riverpod, Provider или Bloc) и систему маршрутизации (GoRouter) по мере роста проекта. Удачи в разработке — после базовой настройки вы сможете быстро прототипировать и масштабировать приложения.