DevOps / CI/CD

Flutter 3.47 iOS CI: какие задачи обязательно выполнять на Mac? Руководство на 2026 год

Сборка Flutter проходит в Linux, но iOS-задача не находит Xcode или симулятор.

Быстрое решение: не переносите на Mac весь конвейер — оставьте там, где это подходит проекту, общие Dart-проверки и неплатформенные задачи, а сборку iOS, проверку в iOS Simulator и этапы подписи и публикации направляйте на macOS-узел.

Эта статья предназначена разработчикам Flutter, которым нужно добавить сборку iOS, сохранив привычную среду для остальной разработки. Она также поможет инженерам CI разделить задания по платформам, а ответственным за инфраструктуру — оценить, оправдан ли отдельный или арендованный Mac.

Последняя проверка: 2 октября 2026 года. Требования сверены с описанием поддерживаемых платформ Flutter, инструкцией по настройке iOS и руководством Flutter 3.47.0. Документация может измениться: перед обновлением CI сверяйте условия с её актуальной версией.

Разделите Flutter 3.47 iOS CI по требованиям к инструментам

Вопрос не в том, что проект «ориентирован на iOS», а в том, какие инструменты требуется запустить на конкретном этапе. Форматирование Dart, статический анализ и часть тестов можно выполнять отдельно от сборки приложения для Apple-платформы. Как только задача требует iOS SDK, Xcode, симулятора или создания подписанного артефакта, ей нужен подходящий macOS-узел. В документации Flutter по платформам требования к среде разделены по целевым платформам; это основание для маршрутизации задач, а не требование переносить весь репозиторий на одну операционную систему.

Такое разделение помогает избежать нескольких распространённых издержек. Во-первых, если даже анализ кода привязан к Mac, свободные Linux-узлы остаются незадействованными, хотя конкретная проверка не использует Apple-инструменты. Во-вторых, единая крупная задача усложняет диагностику: ошибка Dart, сбой нативного плагина и проблема подписи оказываются в одном логе. В-третьих, излишне широкий доступ к сертификатам увеличивает последствия ошибки или утечки в задаче, которой эти данные вообще не нужны.

Есть и менее очевидные ограничения. Зелёный результат на Android или Web не подтверждает, что проект собирается для iOS: отличаются платформенные зависимости и интеграция плагинов. Успешная компиляция для симулятора не доказывает, что приложение проверено на физическом устройстве. Наконец, сам факт наличия Mac в инфраструктуре не гарантирует корректность версии Xcode, настройки проекта и доступа к секретам. Эти условия нужно проверять отдельно и по результатам конкретных задач.

Оставьте общие проверки на подходящих узлах

Можно ли запускать Dart-тесты Flutter в Linux CI? Да, если выбранная задача действительно ограничена общим кодом и не требует iOS SDK, Xcode, симулятора или платформенной сборки. Документация Flutter описывает основные виды тестирования; на практике команда должна разделить проверки по зависимостям, а не считать любую тестовую команду автоматически переносимой.

На узле без macOS обычно уместны проверки форматирования, статический анализ Dart, проверка изменений и тесты общего слоя — при условии, что они не обращаются к платформенному каналу или инструментам Apple. Если тестируемый код вызывает нативный iOS-плагин, обычный запуск на Linux может не проверить соответствующую реализацию. Это не значит, что такой код вообще нельзя тестировать вне Mac: изолированные Dart-компоненты остаются отдельным объектом проверки. Но интеграцию с iOS нужно подтвердить в среде, где доступны соответствующие инструменты.

Разделение также полезно для восстановления после сбоя. Если анализ и общие тесты успешны, а ошибка возникает только на этапе Xcode, команда получает более точную область поиска. Если же все этапы объединены, журнал сборки может смешать ошибки, не связанные между собой: например, недоступный пакет, проблему нативной интеграции и сбой при создании архива.

Проверка Flutter-плагина автоматически требует Mac? Нет. Само наличие плагина не делает каждый анализ или тест обязательным для macOS. Решение зависит от того, проверяет ли задача Dart API, общую логику или реальную iOS-реализацию на Swift, Objective-C и настройках Xcode. Руководство Flutter по тестированию плагинов помогает различать тесты Dart-части и платформенные проверки; для команды это означает, что задачи стоит классифицировать по фактическому содержимому теста.

Направьте сборку iOS и работу с симулятором на macOS

Нужна ли macOS для сборки Flutter-приложения для iOS Simulator? Для iOS-сборки требуется среда macOS с Xcode; ту же границу нужно учитывать и для задач, которые создают или запускают сборку для iOS Simulator. В руководстве Flutter по настройке iOS указаны требования к инструментам. Поэтому Linux-узел может выполнить предварительный анализ, но не заменяет Mac на этапе, которому необходимы Xcode и iOS SDK.

При этом полезно не объединять три разных результата под словом «проверено». Сборка для симулятора показывает, что соответствующая конфигурация компилируется с выбранными настройками. Запуск в iOS Simulator добавляет проверку запуска приложения и поведения в симулируемом окружении. Проверка на физическом устройстве нужна, если требуется подтвердить взаимодействие с реальным оборудованием или иными условиями, которые симулятор не воспроизводит. Состав последнего набора проверок определяется продуктом и его требованиями; один результат не подменяет остальные.

При добавлении нового плагина или изменении iOS-кода особое внимание уделите проектной конфигурации и интеграции зависимостей. Успешные Dart-тесты не подтверждают корректность Swift- или Objective-C-части. А если задача требует проверить запуск интеграционного сценария, её следует маршрутизировать туда, где доступен соответствующий целевой рантайм. Flutter отдельно описывает интеграционные тесты, поэтому командный план должен различать их от обычных unit-тестов, а не считать все проверки взаимозаменяемыми.

Результат симуляторной сборки также не стоит использовать как автоматическое разрешение на публикацию. Он подтверждает конкретный этап и конфигурацию, но не доказывает, что корректно получен архив, доступны нужные сертификаты или пройдены проверки, связанные с реальным устройством и процессом распространения.

Изолируйте подпись, архивирование и выпуск

Подпись и подготовка артефакта для распространения — отдельный контур с более строгими требованиями к доступу. Если задача использует Xcode для подписи, архивации или экспорта приложения, выполняйте её в macOS-среде с необходимым инструментарием и назначайте только тому этапу, которому это действительно нужно. Руководство Flutter по публикации iOS-приложения описывает процесс для целевой платформы, а документация Apple рассматривает распространение приложений для бета-тестирования и выпуска.

Для CI важно не просто выбрать Mac, а ограничить границы задачи. Этапы анализа и обычных тестов не должны получать доступ к секретам для подписи, если им они не нужны. Публикационный этап следует отделять от создания неподписанных артефактов так, чтобы изменение кода, пригодное для тестирования, не получало автоматически полномочий на распространение приложения. Конкретную схему задают используемая система CI и правила команды; здесь не следует предполагать поддержку определённой модели секретов или конкретного способа публикации.

Результат архивации тоже должен быть воспроизводимым для команды, а не только «успешным» в одном запуске. Зафиксируйте, какой commit был обработан, какая конфигурация использовалась, какие проверки прошли и какой артефакт передан дальше. Это позволяет отличить сбой компиляции от ошибки подписи и понять, на каком именно этапе задача получила доступ к чувствительным данным. Сам факт успешного создания архива не является гарантией успешного выпуска: для распространения действуют отдельные требования Apple, приведённые в документации по тестированию и выпуску.

Как разделить подпись и архивирование в Flutter iOS CI? Сначала определите задачу архивации и её входы, затем отдельно назначьте этап, который получает необходимые данные для подписи и запускает действия, связанные с выпуском. В общей Dart-проверке, анализе и тестировании, которым не нужны сертификаты, такие данные не должны появляться. Если проекту необходима публикация, её условия нужно проверять отдельно по требованиям Apple и настройкам Xcode, а не делать вывод на основании зелёной сборки для симулятора.

Сохраните Android и Web в их подходящей среде

Flutter-проект может иметь общую кодовую базу, но задачи для Android, Web и iOS имеют разные зависимости. Если сборка Android уже выполняется на существующей среде с нужными Android-инструментами, добавление iOS не является основанием переносить туда же все проверки. Аналогично Web-задачи не становятся macOS-задачами только потому, что в репозитории есть iOS-приложение.

Для смешанного проекта обычно понятнее выделить общую группу проверок и отдельные платформенные ветви. Общая группа выполняет форматирование, анализ и тесты переносимого кода. Android-ветвь использует свою подходящую среду. Web-ветвь проверяет браузерную цель, если она входит в продукт. iOS-ветвь получает задачи с зависимостью от Xcode, симулятора, iOS-интеграции и подписи. Это логика разделения по требованиям, а не привязка к определённому поставщику CI: названия заданий и доступная степень параллельного выполнения зависят от самой инфраструктуры.

Такой подход не делает Linux или другую существующую платформу «неправильной» для Flutter. Он лишь не использует её там, где задача прямо требует инструментов Apple. Если оставить все задачи на Mac, можно избыточно расходовать более подходящий существующий пул для общих тестов. Если, напротив, пытаться выполнять iOS-интеграцию без нужной среды, ошибки будут повторяться независимо от качества Dart-проверок.

Выберите границу узла и проверьте её по результатам

Перед изменением маршрутизации отметьте, какие задачи действительно зависят от платформы, и подтвердите это на проекте. Ниже — проверочный список для планирования; каждый пункт подразумевает конкретное действие, а не предположение по названию задания.

  • [ ] Выделите форматирование, статический анализ и тесты, которые не используют iOS SDK, Xcode и платформенные API.
  • [ ] Найдите зависимости от Swift, Objective-C, iOS-плагинов и конфигурации Xcode; назначьте для их интеграционной проверки подходящую macOS-среду.
  • [ ] Отделите сборку для iOS Simulator от запуска в симуляторе и от проверки на физическом устройстве.
  • [ ] Выделите создание архива, подпись и публикацию в отдельные задачи; проверьте, какие из них действительно используют секреты.
  • [ ] Оставьте Android- и Web-проверки в подходящих для них средах, если им не требуется Mac.
  • [ ] После изменения маршрутизации выполните представительную задачу для iOS и сохраните сведения о commit, конфигурации, проверках и полученном результате.
  • [ ] Проверьте границу доступа: общие задачи не должны получать полномочия, предназначенные для подписи и выпуска.

Приёмка узла начинается с подтверждения, что доступен ожидаемый Xcode и что Flutter видит нужные инструменты. Затем запустите представительную iOS-задачу именно из вашего проекта, включая те плагины и конфигурацию, которые важны для релиза. Для симуляторной проверки зафиксируйте, что было собрано и запускалось; для публикационного контура отдельно проверьте доступ к необходимым секретам и то, что он не распространяется на другие задачи. Это критерии проверки, а не утверждение о конкретной конфигурации или результатах KuzCloud.

Тип задачи Где выполнять Что подтверждает результат
Форматирование и анализ Dart На подходящем существующем узле, если не нужны Apple-инструменты Проверку стиля и анализ общего кода
Тесты переносимой логики На доступном узле, если тесты не требуют iOS-рантайма Работу проверяемой логики в заданном тестовом контексте
Сборка для iOS На macOS с необходимыми инструментами Xcode Компиляцию выбранной конфигурации для iOS
Сборка или запуск для iOS Simulator На macOS с Xcode и необходимыми компонентами симулятора Соответствующую сборку или запуск в симулируемой среде
Интеграция iOS-плагина На macOS, если проверяется его нативная реализация Работу выбранной интеграции в целевой среде
Подпись, архивирование, выпуск На macOS-этапах, которым нужны инструменты и полномочия для этой операции Результат конкретной операции и её зафиксированные входы
Условие проекта Подход к узлам Основание для выбора
Проверяются только общие Dart-изменения Оставить задачу на имеющемся подходящем узле Для этой задачи не нужны инструменты Apple
Требуется iOS-сборка или проверка симулятора Добавить маршрут на macOS Необходимы iOS-инструменты и Xcode
Меняется нативная реализация плагина Сочетать общие проверки с iOS-интеграционной задачей Dart-тесты сами по себе не проверяют нативную часть
Нужно архивировать, подписывать или публиковать приложение Выделить соответствующий macOS-этап с ограниченным доступом Действия требуют отдельного контроля инструментов, артефакта и полномочий
В проекте есть Android и Web Сохранить для этих целей подходящие отдельные задачи Наличие iOS-цели не превращает остальные платформенные задачи в iOS-задачи

Решение о постоянном Mac зависит от повторяемости iOS-задач, требований к доступности сборочной среды и обязанностей по сопровождению узла. Если macOS требуется лишь для отдельных проверок перед редким выпуском, команда может сначала оценить вариант временного доступа к удалённому Mac. Если же iOS-сборка регулярно участвует в обязательном цикле и должна быть доступна команде постоянно, стоит сравнить самостоятельное оборудование и аренду по реальным затратам, требованиям к доступу и ответственности за обслуживание. Ни один вариант не отменяет необходимости отдельно организовать CI, Xcode и хранение секретов.

Для сравнения удалённого варианта и собственного оборудования сначала изучите описание KuzCloud и доступную информацию о тарифах, затем подтвердите соответствие вашему проекту по фактическому доступу к среде и пробной задаче. Не следует считать, что одна только аренда автоматически обеспечивает нужную версию Xcode, способ подключения или результат сборки: эти условия нужно сверять до переноса релизного этапа.

Если текущий Linux-узел не подходит, чтобы запускать Xcode, iOS Simulator и операции, зависящие от macOS, это не означает, что всю Flutter-разработку нужно переносить на Mac. У существующей среды могут оставаться другие реальные недостатки для iOS-контура: отсутствует требуемый Apple-инструментарий, нельзя запустить iOS Simulator и невозможно выполнить зависящий от Xcode этап подписи или архивации. В таком случае аренда Mac у KuzCloud может быть уместна как отдельная среда для этих задач — после проверки инструментария, доступа и требований к секретам. Если же Mac нужен постоянно для тяжёлой непрерывной нагрузки или проекту необходимы физические интерфейсы, прежде сравните аренду с собственным устройством и проверьте ограничения конкретного варианта.

Подготовьте Mac для сборки iOS-приложений

KuzCloud предоставляет выделенный Mac mini M4 с macOS для задач CI, которым необходима среда Mac.

Получите root-доступ и подключайтесь к машине по SSH или через удалённый рабочий стол.