Настройка Android для Flutter: Android Studio, SDK, эмулятор, телефон

Чтобы запускать Flutter-приложение на Android — в эмуляторе или на своём телефоне, — нужна Android Studio: из неё Flutter берёт Android SDK, инструменты сборки и эмулятор. Сам Flutter при этом ставится отдельно ( Урок 0 ) — плагина Flutter в Android Studio для этого мало.

Команды на этой странице выполняются в терминале: в Windows — PowerShell, в macOS и Linux — «Терминал». Как его открыть и вставить команду, рассказано на странице Установка Git . Команды flutter run выполняются в папке проекта — первый проект создадим в Уроке 1 .

Содержание:

1. Установка Android Studio
2. Пакеты в SDK Manager
3. Лицензии
4. Эмулятор
5. Свой телефон
6. Проверка и запуск
7. Частые сообщения flutter doctor
8. Итог

1. Установка Android Studio

Скачайте последнюю стабильную версию с developer.android.com/studio и установите:

• Windows — запустите скачанный .exe и пройдите мастер установки;
• macOS — выберите файл для своего Mac (Apple chip или Intel chip), откройте скачанный .dmg , перетащите Android Studio в папку «Программы» и запустите;
• Linux — в 64-битной Ubuntu сначала поставьте 32-битные библиотеки (команда из документации Android):

sudo apt-get install libc6:i386 libncurses5:i386 libstdc++6:i386 lib32z1 libbz2-1.0:i386

В Ubuntu 24.04 пакета libncurses5 нет, и эта команда остановится с ошибкой «Unable to locate package». Документация Android команду для 24.04 не обновила; остальные пакеты в 24.04 есть — поставьте их без libncurses5:i386 :

sudo apt-get install libc6:i386 libstdc++6:i386 lib32z1 libbz2-1.0:i386

Затем распакуйте скачанный архив в /opt/ и запустите Android Studio ( xdg-user-dir DOWNLOAD подставит вашу папку загрузок):

sudo tar -xzf "$(xdg-user-dir DOWNLOAD)"/android-studio-*.tar.gz -C /opt && /opt/android-studio/bin/studio

При первом запуске мастер настройки предложит скачать компоненты Android SDK — соглашайтесь.

Требования Android Studio: 8 ГБ оперативной памяти и 8 ГБ на диске, а вместе с эмулятором — 16 ГБ памяти и 16 ГБ на диске; Windows 10 (64-бит), macOS 12 и новее или 64-битный Linux с GNOME, KDE или Unity и glibc 2.31 и новее. На компьютерах с Windows и Linux на процессорах ARM Android Studio пока не работает.

2. Пакеты в SDK Manager

Откройте SDK Manager: в окне приветствия — More Actions → SDK Manager , в открытом проекте — Tools → SDK Manager .

• На вкладке SDK Platforms проверьте, что отмечена первая строка с API Level 36 .
• На вкладке SDK Tools отметьте:
• Android SDK Build-Tools
• Android SDK Command-line Tools
• Android Emulator
• Android SDK Platform-Tools
• CMake
• NDK (Side by side)

Нажмите Apply , в окне Confirm Change — OK , после установки — Finish .

3. Лицензии

Flutter не соберёт приложение для Android, пока не приняты лицензии Android SDK:

flutter doctor --android-licenses

Команда показывает лицензии по очереди — на каждый вопрос отвечайте y . В конце будет:

All SDK package licenses accepted.

Java отдельно ставить не нужно: Flutter сам берёт JDK, который идёт с Android Studio.

4. Эмулятор

Эмулятор — виртуальный телефон на вашем компьютере. Сначала проверьте аппаратное ускорение, затем создайте устройство.

Аппаратное ускорение.

• Windows — компонент Windows Hypervisor Platform (в русском тексте Google — «платформа низкоуровневой оболочки Windows»): нажмите «Пуск», наберите «Компоненты Windows», откройте Включение или отключение компонентов Windows , отметьте этот компонент и после установки перезагрузите компьютер. Нужна Windows 10 версии 1803 или новее; в BIOS должна быть включена виртуализация (Intel VT-x или AMD-V).
• macOS — ничего ставить не нужно: эмулятор использует встроенный Hypervisor.Framework.
• Linux — нужен KVM. Проверить в Ubuntu:

sudo apt-get install -y cpu-checker && sudo kvm-ok

Должно получиться INFO: /dev/kvm exists и KVM acceleration can be used . Если написано KVM acceleration can NOT be used , включите виртуализацию в BIOS.

Эмулятор с ускорением не запустится внутри другой виртуальной машины (VirtualBox, VMware, Docker).

Создание эмулятора.

1. Откройте Device Manager: в окне приветствия — More Actions → Virtual Device Manager (если открыт проект — Tools → Device Manager ).
2. Нажмите + ( Create Virtual Device ), выберите Phone , модель телефона и нажмите Next .
3. Выберите образ системы: x86 Images для обычного компьютера, ARM Images — для компьютера на ARM (например, Mac с Apple Silicon). Если у образа значок загрузки — скачайте его.
4. В Additional settings → Emulated Performance → Graphics acceleration выберите вариант со словом Hardware и нажмите Finish .
5. В Device Manager нажмите Run у созданного устройства. Первый запуск может занять около минуты, следующие — быстрее.

5. Свой телефон

Названия пунктов ниже — как в самом Android (Google Pixel); на других телефонах они могут называться и располагаться иначе.

1. Режим разработчика. Откройте Настройки → О телефоне и нажмите Номер сборки семь раз, пока не появится сообщение «Вы стали разработчиком!». На Samsung Galaxy пункт находится в Настройки → О телефоне → Информация о программном обеспечении → Номер сборки .
2. Отладка по USB. На Android 9 и новее: Настройки → Система → Дополнительно → Для разработчиков → Отладка по USB .
3. Подключите телефон кабелем. Появится вопрос «Отладка по USB» — нажмите Разрешить .

Под Windows для телефона нужен USB-драйвер его производителя (для устройств Google — Google USB Driver из SDK Manager). На macOS и Linux драйвер не нужен; в Ubuntu добавьте себя в группу plugdev :

sudo usermod -aG plugdev $LOGNAME

Группы обновляются при входе в систему — выйдите из неё и войдите снова.

6. Проверка и запуск

Сначала проверьте настройку целиком:

flutter doctor

У строки Android toolchain - develop for Android devices должна быть [✓] ; если там [!] , под ней написано, чего не хватает (раздел 7). Затем посмотрите подключённые устройства:

flutter devices

В списке должно появиться устройство с платформой android , например:

2406APNFAG (mobile) • <serial> • android-arm64 • Android 16 (API 36)

Запуск на нём — в папке проекта, с идентификатором устройства из второго столбца:

flutter run -d <id устройства>

7. Частые сообщения flutter doctor

8. Итог

• Android Studio даёт Flutter Android SDK и эмулятор; нужные пакеты — в SDK Manager, API 36.
• Лицензии — flutter doctor --android-licenses .
• Эмулятор — Device Manager и аппаратное ускорение; телефон — режим разработчика и отладка по USB.
• Проверка — flutter devices , запуск — flutter run -d <id> .