Отладка Flutter iOS из Windows: рабочий процесс с реальным устройством (Flutter 3.x)

Раз в несколько недель всплывает одна и та же боль: “Я на Windows. Хочу отлаживать своё приложение Flutter iOS на реальном iPhone. Действительно ли мне нужен Mac?”. Свежий пост в r/FlutterDev предлагает прагматичный обходной путь: вынести сборку iOS на macOS в GitHub Actions, а затем устанавливать и подключаться для отладки уже из Windows: https://www.reddit.com/r/FlutterDev/comments/1qkm5pd/develop_flutter_ios_apps_on_windows_with_a_real/

Open-source проект, стоящий за этим: https://github.com/MobAI-App/ios-builder.

Разделите задачу: сборка на macOS, отладка из Windows

У iOS есть два жёстких ограничения:

• Инструменты Xcode работают на macOS.
• Установка на реальное устройство и подпись подчиняются правилам, которые из Windows обойти нельзя.

Но отладка во Flutter - это в основном “подключиться к работающему приложению и общаться с VM service”. Значит, можно отделить сборку и установку от цикла разработчика, если получится поместить на устройство приложение, пригодное для отладки.

Описанный в посте поток выглядит так:

• Запустить CI-задачу на macOS, которая собирает .ipa.
• Скачать артефакт на Windows.
• Установить его на физически подключённый iPhone (через приложение-мост).
• Запустить flutter attach из Windows, чтобы получить hot reload и DevTools.

Минимальная сборка GitHub Actions, которая выдаёт IPA

Это не полная история (подпись - отдельная кроличья нора), но идея ясна: macOS-runner собирает и выгружает артефакт.

name: ios-ipa
on:
  workflow_dispatch:
jobs:
  build:
    runs-on: macos-latest
    steps:
      - uses: actions/checkout@v4
      - uses: subosito/flutter-action@v2
        with:
          channel: stable
      - run: flutter pub get
      - run: flutter build ipa --debug --no-codesign
      - uses: actions/upload-artifact@v4
        with:
          name: ios-ipa
          path: build/ios/ipa/*.ipa

Допустимо ли --no-codesign, зависит от того, как вы планируете устанавливать. Многие пути на реальное устройство всё равно требуют подписи на каком-то этапе, даже для отладочных потоков.

Цикл со стороны Windows: установить, затем подключиться

Как только приложение установлено и запущено на iPhone, часть Flutter становится обычной:

# From Windows
flutter devices
flutter attach -d <device-id>

Hot reload работает потому, что вы подключаетесь к отладочной сессии, а не потому, что собирали на той же машине.

Понимайте компромиссы заранее

Этот процесс полезен, но магией не является:

• Подпись всё ещё реальна: придётся иметь дело с сертификатами, профилями или путём через сторонний установщик.
• Устройство всё равно нужно: симуляторы под Windows не работают.
• Ваша CI-задача становится частью цикла разработки: оптимизируйте время сборки и кэшируйте зависимости.

Если хотите оригинальную статью и репозиторий, с которого всё началось, начните отсюда: https://github.com/MobAI-App/ios-builder. За официальным руководством Flutter по отладке iOS держите рядом и платформенную документацию: https://docs.flutter.dev/platform-integration/ios/ios-debugging.