Встановлення та налаштування Flutter на macOS

У багатьох могли виникати певні труднощі під час збірки проєкту на Flutter. Надаю оновлений посібник для тих, у кого виникають проблеми під час початкового встановлення та налаштування, або просто не було досвіду роботи з Flutter.

:::caution[Оновлення] Додано інструкції для Flutter 3.24+, FVM для керування версіями та сучасні практики налаштування. :::

Крок 1: Вибір методу встановлення

Варіант 1: Встановлення через FVM (рекомендовано)

FVM (Flutter Version Management) — найкращий спосіб керування версіями Flutter. Дозволяє легко перемикатися між версіями та працювати з різними проектами.

Встановлення FVM через Homebrew:

brew tap leoafarias/fvm
brew install fvm

Встановлення останньої стабільної версії Flutter:

fvm install stable
fvm global stable

Використання FVM у проекті:

# У папці проекту
fvm use 3.35.1  # або будь-яка потрібна версія
fvm flutter doctor

Варіант 2: Класичне встановлення Flutter SDK

Якщо воліте класичний метод, завантажте Flutter SDK тут.

Після завантаження архіву (наприклад, flutter_macos_3.24.0-stable.zip):

cd ~/development
unzip ~/Downloads/flutter_macos_3.24.0-stable.zip

Крок 2: Налаштування змінних середовища

Для FVM (якщо використовуєте FVM):

FVM автоматично керує шляхами, але потрібно додати до .zshrc:

# Відкриваємо конфігурацію
open ~/.zshrc

Додаємо в кінець файлу:

# FVM Flutter версії
export PATH="$HOME/.fvm/flutter_sdk/bin:$PATH"
export PATH="$HOME/.pub-cache/bin:$PATH"

Для класичного встановлення:

# Відкриваємо конфігурацію
open ~/.zshrc

Додаємо шлях до Flutter (замініть на ваш шлях):

export PATH="$HOME/development/flutter/bin:$PATH"
export PATH="$HOME/.pub-cache/bin:$PATH"

Після змін перезавантажте термінал або виконайте:

source ~/.zshrc

Перевіряємо встановлення:

flutter --version
which flutter

Повинні побачити версію та шлях до Flutter.

Крок 3: Діагностика та вирішення проблем

Перевіряємо стан установки Flutter:

flutter doctor -v

Поширені проблеми та їх вирішення:

1. Відсутність Xcode Command Line Tools

xcode-select --install

2. Відсутність плагінів для IDE

VS Code (рекомендовано):

• Встановіть розширення “Flutter” та “Dart”
• Перезапустіть VS Code

Android Studio/IntelliJ IDEA:

• Перейдіть у Preferences (⌘ + ,)
• Plugins → пошук “Flutter” → Install
• Перезапустіть IDE

3. Відсутність CocoaPods (для iOS розробки)

CocoaPods потрібен для керування залежностями iOS проектів:

# Встановлення через Homebrew
brew install cocoapods

# Ініціалізація
pod setup

4. Проблеми з Android SDK

# Прийняття ліцензій Android SDK
flutter doctor --android-licenses

# Встановлення Android SDK через Android Studio:
# Tools → SDK Manager → встановити необхідні компоненти

5. Проблеми з симулятором iOS

# Відкриття симулятора
open -a Simulator

# Перевірка доступних симуляторів
xcrun simctl list devices

Крок 4: Корисні команди для роботи

FVM команди:

fvm list                 # Показати встановлені версії
fvm releases             # Показати доступні версії Flutter
fvm install 3.24.0       # Встановити конкретну версію
fvm use 3.24.0           # Використати версію для проекту
fvm global 3.24.0        # Встановити глобальну версію

Flutter команди:

flutter create my_app    # Створити новий проект
flutter pub get          # Завантажити залежності
flutter run              # Запустити додаток
flutter build apk        # Збірка APK для Android
flutter build ios        # Збірка для iOS
flutter clean            # Очистити кеш проекту

Додаткові поради

1. Використовуйте VS Code - навіть якщо ви любите Android Studio як я, то спробуйте - VS Code, бо вважається швидшим та має кращу підтримку Flutter 🥲
2. Встановіть Android Studio навіть якщо плануєте використовувати VS Code - потрібен для Android SDK
3. FVM дозволяє використовувати різні версії Flutter для різних проектів
4. Регулярно оновлюйтесь командою flutter upgrade або fvm install stable