Swift Package Manager в видеоприложениях: модульный гайд 2026

10/11/2026
·
Обновлено
11.10.2026
Swift Package Manager для видеоприложений: модульный плейбук 2026 — обложка

Swift Package Manager (SPM) — официальный менеджер зависимостей и пакетов Swift: модули и внешние библиотеки описываются в файле Package.swift, а сам SPM встроен в Xcode с 2019 года (Xcode 11) и работает из командной строки. Видеоприложению (видеочату, стримингу, записи или трансляциям) он даёт возможность разложить код на модули, у которых границы конкурентности Swift 6 проверяет компилятор. В ноябре 2026 года выбора почти не осталось: репозиторий CocoaPods trunk 2 декабря 2026 года переходит в режим только для чтения, а актуальный Swift 6.4 вышел вместе с Xcode 27 14 сентября 2026 года (InfoQ, 2026). Если настроить SPM правильно, поддержка видеоприложения дешевеет, сборка ускоряется, а командам проще работать над общим кодом. Если ошибиться, получится ад из вложенных пакетов с долгим разрешением зависимостей и хрупким CI.

По этому плейбуку Фора Софт настраивает Swift Package Manager в видеоприложениях, которые доходят до продакшена: границы модулей, фиксация версий, интерфейсы пакетов, безопасные для Sendable, выбор зависимостей для WebRTC и стриминга, CI-пайплайны и конкретная структура Package.swift продакшен-уровня. Если вы делаете приложение для видеоконференций, меняете стриминговый стек или пишете свою обработку видео и аудио, эту модульную архитектуру стоит взять за основу.

Главное

• SPM — выбор по умолчанию, у CocoaPods есть дедлайн. Trunk CocoaPods становится только для чтения 2 декабря 2026 года: новые версии подов больше не публикуются. Для нового или активно развиваемого iOS-видеоприложения стандартом стоит сделать SPM уже сейчас.

• Делите модули по зонам конкурентности, а не по фичам. Один модуль на каждую actor-зону (Core, Signalling, MediaEngine, CaptureSession, MediaFX, CallFlow, UI), и тогда границы Sendable в Swift 6 проверяются ещё при компиляции.

• Фиксируйте точно, обновляйте по графику. Держите Package.resolved в репозитории, каждую внешнюю зависимость пиньте к точной версии или контрольной сумме, а обновления разбирайте раз в квартал, а не случайными PR.

• WebRTC — бинарным таргетом. Берите поддерживаемый xcframework stasel/WebRTC (версия 155.0.0 от 12 октября 2026 года), а не заброшенный под google/GoogleWebRTC. Чистая сборка в CI сокращается с 15–25 минут до меньше минуты.

• Не дробите слишком сильно. Для видеоприложения оптимально 6–10 модулей; больше 15 — обычно признак случайной фрагментации. Необязательные функции (демонстрация экрана, ИИ-фильтры) включайте трейтами пакета (Swift 6.1+), а не отдельными пакетами.

Обновлено в ноябре 2026: срок CocoaPods (trunk только для чтения со 2 декабря 2026), Swift 6.4 и Xcode 27, stasel/WebRTC 155.0.0 вместо заброшенного GoogleWebRTC, трейты пакета, схемы и оценки с ИИ-инструментами.

Почему этот плейбук написала Фора Софт

Фора Софт выпускает видео- и аудиоприложения для iOS с 2005 года: за 250+ проектов мы успели поработать с CocoaPods, Carthage и всеми ранними версиями SPM, пока он не стал зрелым. SPM у нас в продакшене в платформе онлайн-обучения BrainCert, в корпоративном видеоинструменте VALT для проверки записей, в видеоэффектах SuperPower FX и в приложениях для Smart TV в проекте bellicon. Эта же раскладка модулей лежит в основе нашей разработки платформ видеоконференций под iOS.

Эту модульную архитектуру мы используем каждый день и отработали её на миграциях с CocoaPods на SPM, с Swift 5 на Swift 6 и при переходе от одномодульных монолитов к правильно разделённым пакетам. Механическую часть миграции (манифесты, перенос зависимостей, настройка CI) сеньоры делают с ИИ-ассистентами кода, поэтому наши оценки ниже рыночных; как мы их считаем, показано в разделе об экономике.

Запутались в настройке Swift Package Manager?

Медленные сборки, запутанные зависимости, утечки Sendable между модулями? Пришлите нам ваш Package.swift и примерный список модулей. Мы вернёмся с чистой архитектурой и точной оценкой.

Обсудить проект →Позвонить →Написать на почту →

SPM, CocoaPods и Carthage — что выбрать в 2026 году

Для нового видеоприложения единственный разумный выбор — SPM. Для старого миграцию с CocoaPods стоит планировать уже не как опцию: CocoaPods в режиме поддержки, и его trunk 2 декабря 2026 года становится только для чтения. Уже собранные проекты продолжат резолвиться, но новые версии подов после этой даты не выйдут; в начале ноября 2026 года команда CocoaPods устроила пробный режим только для чтения, чтобы авторы успели заметить сбои. Экосистема уже развернулась: Flutter 3.44 сделал SwiftPM менеджером по умолчанию для iOS, и на момент анонса в апреле 2026 года SwiftPM поддерживали 61% из топ-100 iOS-плагинов.

Параметр SPM CocoaPods Carthage
Интеграция с Xcode Нативная Через плагин Вручную
Конкурентность Swift 6.2+ Модульные swiftSettings Только обходные пути Только обходные пути
Бинарные таргеты XCFramework с контрольной суммой Подключаемый бинарь Да
Производительность CI Хорошая (с кэшем) Неровная Быстрая для собранных артефактов
Статус в 2026 году Развивается, поддержка Apple Trunk только для чтения со 2 декабря 2026 Сообщество, низкая активность
Приватные репозитории Нативно SSH / HTTPS Приватный репозиторий спецификаций Git-URL
По умолчанию для нового iOS-приложения Да Только легаси Редко

Берите SPM, когда: начинаете новый iOS-проект, переносите старое приложение на Swift 6 или хотите упростить управление зависимостями в нескольких командах. Раз реестр подов уходит в режим только для чтения, разумных причин начинать новый проект на CocoaPods не осталось.

Раскладка модулей для видеоприложения в продакшене

Такую структуру мы используем для видеочата или стримингового приложения на Swift 6. Каждый модуль привязан к своей зоне конкурентности и держит минимальный публичный интерфейс, а границы Sendable проверяются на этапе компиляции.

MyVideoApp/
  Package.swift
  Sources/
    Core/              // Sendable types, errors, logging (zero deps)
    Signalling/        // WebSocket + protocol (depends: Core)
    Networking/        // REST / auth (depends: Core)
    MediaEngine/       // WebRTC wrapper actor (depends: Core, WebRTCBinary)
    CaptureSession/    // AVCaptureSession actor (depends: Core)
    MediaFX/           // Core ML, filters (depends: Core)
    CallFlow/          // orchestration actor (depends: all above)
    UIKitVideoView/    // UIViewRepresentable + Metal (depends: Core)
    Features/          // SwiftUI feature slices (depends: CallFlow, UIKitVideoView)
  BinaryFrameworks/
    WebRTC.xcframework
  Tests/
    ...
App/                   // the Xcode project (depends on Features)

Xcode-проект приложения зависит только от Features: ни интерфейсу, ни склеивающему коду не нужно знать о WebRTC или Core ML. Бинарные таргеты (WebRTC) лежат вне Sources/ и подключаются через манифест пакета.

Раскладка SPM-модулей видеоприложения: App и Features, CallFlow, шесть модулей зон конкурентности, Core и WebRTC.xcframework

Рисунок 1. Четыре слоя модулей видеоприложения на SPM: зависимости идут только сверху вниз, у Core нет внешних зависимостей, WebRTC подключён бинарным таргетом.

Базовый Package.swift для Swift 6.2 и новее

С этого каркаса манифеста мы начинаем: Swift Tools 6.2, swiftSettings на каждый модуль, изоляция на главном акторе по умолчанию (SE-0466) и поддерживаемый WebRTC, закреплённый на точной версии.

// swift-tools-version: 6.2
import PackageDescription

let concurrency: [SwiftSetting] = [
  .defaultIsolation(MainActor.self),                        // SE-0466
  .enableUpcomingFeature("NonisolatedNonsendingByDefault"), // SE-0461
  .enableUpcomingFeature("InferIsolatedConformances"),      // SE-0470
]

let package = Package(
  name: "MyVideoApp",
  platforms: [.iOS(.v17), .tvOS(.v17)],
  products: [
    .library(name: "Features", targets: ["Features"]),
  ],
  dependencies: [
    // поддерживаемый xcframework WebRTC, точная версия
    .package(url: "https://github.com/stasel/WebRTC", exact: "155.0.0"),
  ],
  targets: [
    .target(name: "Core", swiftSettings: concurrency),
    .target(
      name: "MediaEngine",
      dependencies: ["Core", .product(name: "WebRTC", package: "WebRTC")],
      swiftSettings: concurrency
    ),
    // ...так же для каждого модуля
    .testTarget(
      name: "MediaEngineTests",
      dependencies: ["MediaEngine"],
      swiftSettings: concurrency
    ),
  ]
)

Если вы храните бинарник у себя, замените удалённый пакет локальным .binaryTarget с url и checksum. В продакшене контрольная сумма обязательна: именно она не пустит к пользователям тихо подменённый бинарник.

Уже на Xcode 27? Xcode 27 вышел 14 сентября 2026 года вместе со Swift 6.4, и манифест выше собирается без изменений. В Swift 6.4 система Swift Build стала сборщиком SwiftPM по умолчанию на всех платформах; в Swift 6.3 (март 2026 года) её можно было включить вручную. Прежде чем поднимать swift-tools-version, прогоните пакет хотя бы один раз в CI на новом движке.

Берите бинарные таргеты, когда: зависимость долго собирается из исходников (WebRTC, FFmpeg, TensorFlow Lite), распространяется как закрытый бинарник или почти не меняется. Всё остальное компилируйте из исходников, тогда стектрейсы и отладка останутся понятными.

Конкурентность Swift 6.2 и Sendable-безопасные интерфейсы модулей

Swift 6.2 сменил исходную позицию: с .defaultIsolation(MainActor.self) код модуля выполняется на главном акторе, если не сказано иное, и это убирает стену ложных предупреждений о гонках данных в модулях рядом с UI. Но видеоконвейеру нужна настоящая работа вне главного потока (захват, кодирование, сеть), так что вся дисциплина в том, где именно вы сознательно уходите с главного актора. Интерфейсы между модулями остаются чистыми при трёх правилах, а четвёртое, появившееся в Swift 6.4, касается завершения звонка:

1. Публичные типы — только в Core. Модуль Core содержит все типы-значения, помеченные как Sendable, которые используются в других модулях: ID, ошибки, статистика, состояния. Никакой другой модуль не может экспортировать Sendable-типы.

2. API акторов возвращают значения, которые можно отправить. Когда MediaEngine передаёт состояние UI-слою, он возвращает снапшоты Core.CallState, а не внутренний RTCPeerConnection.

3. sending-параметры через границы модулей. Буферы, payload’ы и одноразовые объекты передаются как sending. Вызывающая сторона описывает, что передаёт владение объектом, а компилятор гарантирует выполнение этого правила.

4. Завершение звонка переживает отмену. В Swift 6.4 блок defer может напрямую ждать await, а withTaskCancellationShield даёт отменённой задаче доработать до конца очистки. Здесь закрывают peer connection, дописывают последний сегмент записи и отправляют сигналу «положил трубку». Тогда пользователь, смахнувший приложение посреди звонка, не оставит недописанный файл или «призрака» в комнате.

Трейты пакета для необязательных видеофункций

Трейты пакета (SE-0450, Swift 6.1) большинство гайдов по SPM до сих пор пропускают, хотя видеоприложениям они подходят очень хорошо. Трейт позволяет одному пакету отдавать необязательные функции и зависимости, которые потребитель включает по имени, а код отсекается при компиляции через #if. Вместо отдельного пакета на каждое дополнение остаётся один модуль, а возможности переключаются на уровне сборки.

Примеры: трейт ScreenShare подтягивает помощник ReplayKit только при включении, AIFilters подключает тяжёлый набор моделей Core ML, TVOS выкидывает код захвата, который ТВ-сборке не нужен. Потребитель передаёт --traits AIFilters или задаёт трейты по умолчанию в манифесте, а CI прогоняет матрицу комбинаций, чтобы каждый вариант оставался зелёным.

// в манифесте видеопакета
traits: [
  "ScreenShare",
  .trait(name: "AIFilters"),
  .default(enabledTraits: ["ScreenShare"]),
],

// в коде
#if AIFilters
  import CoreML
  public func attachBackgroundBlur() { /* ... */ }
#endif

На стороне приложения трейт включают в объявлении зависимости (.package(url: …, from: "2.0.0", traits: ["AIFilters"])), а таргет может линковать тяжёлую зависимость только при включённом трейте через condition: .when(traits: ["AIFilters"]). Так набор моделей Core ML не попадает в сборки, где этой функции нет.

Берите трейты, когда: функция тяжёлая, необязательная или платформенная (демонстрация экрана, ИИ на устройстве, tvOS). Если функция есть в каждой сборке, оставьте обычный модуль: трейты окупаются тем, что облегчают сборки, которым функция не нужна.

Каталог SPM-зависимостей для видеоприложений

За годы работы над видеоприложениями мы выработали короткий список проверенных зависимостей, которым доверяем в 2026 году. Несколько хорошо подобранных пакетов лучше длинного Package.resolved.

1. WebRTC: stasel/WebRTC. Поддерживаемый сообществом бинарный xcframework WebRTC для iOS и macOS, который распространяется как Swift-пакет и следует за ветками Chromium; последний релиз — 155.0.0 от 12 октября 2026 года. Старый под google/GoogleWebRTC заброшен, и SPM-пакетом он никогда не был. Пиньте точную версию, обновляйте раз в квартал. Если WebRTC для вашей команды пока чёрный ящик, начните с урока «WebRTC без зауми».

2. LiveKit Swift SDK и форк livekit/webrtc-xcframework. Если вы работаете с LiveKit Cloud или своим LiveKit SFU, у SDK полноценный SPM-таргет; актуальная версия — 2.17.0 (сентябрь 2026 года), поддержку Swift 5 убрали ещё в 2.14.

3. Starscream или URLSessionWebSocketTask. WebSocket-клиент для сигналинга. Starscream проверен временем; URLSession не добавляет лишних зависимостей и подойдёт, если вам не нужны расширения.

4. Swift Collections и Swift Algorithms. Коллекции, близкие к стандартным (OrderedSet, Deque), и ленивые алгоритмы. Риск отсутствует.

5. swift-log. Структурированное логирование с возможностью менять бэкенды. Одной строкой можно переключиться с вывода в консоль в разработке на OSLog или удалённый бэкенд в продакшене.

6. Kingfisher или SDWebImage. Нужны, только если требуется агрессивное кэширование изображений, например аватаров в большом масштабе. Для простых задач хватает AsyncImage и небольшого собственного кэша.

7. Core ML + Vision (без зависимостей). Вся обработка ИИ на устройстве в 2026 году строится на фреймворках Apple; сторонняя обёртка не даёт достаточной ценности, чтобы оправдать риски.

Нужна помощь, чтобы подчистить Package.resolved?

Мы регулярно уменьшаем дерево SPM-зависимостей в продакшен-видеоприложениях на 30–60% без потери функциональности. Пришлите ваш манифест — мы вернёмся со списком зависимостей для удаления и оценкой выигрыша по времени сборки.

Обсудить проект →Позвонить →Написать на почту →

WebRTC: бинарный таргет или сборка из исходников

Это самое крупное решение по времени сборки в WebRTC-приложении. Компиляция WebRTC из исходников на чистом CI-раннере занимает 15–25 минут, линковка готового .xcframework — меньше минуты. Для ежедневного CI бинарник выигрывает с большим отрывом.

Время чистой сборки в CI: WebRTC из исходников 15–25 минут против бинарного xcframework меньше минуты

Рисунок 2. Чистая сборка на CI-раннере: компиляция WebRTC из исходников против линковки бинарного таргета. Ориентир по нашим пайплайнам; цифры зависят от класса раннера и состояния кэша.

Собирайте WebRTC из исходников, только когда это действительно нужно: свой патч, нестандартная ветка или изменение, которое апстрим не примет. Во всех остальных случаях бинарник — правильный вариант по умолчанию, а точная версия делает сборки воспроизводимыми.

CI и кэширование сборки — что реально ускоряет билды

Время CI у видеоприложения на SPM определяют три рычага:

1. Бинарный WebRTC. Разобрали выше: перевод WebRTC из исходников в бинарный таргет обычно даёт больше, чем все остальные настройки CI вместе.

2. Кэш SPM в CI. Кэшируйте каталог .build и ~/Library/Caches/org.swift.swiftpm на CI-раннере. GitHub Actions, Bitrise и Xcode Cloud позволяют настроить это менее чем за 15 строк кода.

3. Явные модули и кэш компиляции — по замерам, а не на веру. С Xcode 26 явно собираемые модули (explicitly built modules) включены по умолчанию для всех Swift-таргетов (отключаются через SWIFT_ENABLE_EXPLICIT_MODULES=NO). Кэш компиляции включается отдельно и сильнее всего помогает при переключении веток и чистых сборках. Первые замеры явных модулей были неоднозначными, а выигрыш зависит от графа модулей, поэтому меряйте чистую и инкрементальную сборку до и после и оставляйте только то, что двигает цифры.

Ловушка Xcode 27 для WebRTC-приложений. В Xcode 27 удалили старый линкер ld64. Если в флагах линковки остался -ld_classic от давнего обходного пути, Xcode теперь выдаёт предупреждение и игнорирует флаг, поэтому перед переводом CI на Xcode 27 перепроверьте линковку бинарного WebRTC.

В сумме грамотно настроенный CI-пайплайн для среднего видеоприложения укладывается в «тест + архив» за 10 минут. Этого хватает для нескольких релизов в день, к которым стремятся продуктовые команды.

Версионирование, пиннинг и квартальные обновления зависимостей

В продакшен-видеоприложениях мы фиксируем каждую внешнюю зависимость к точной версии, коммитим Package.resolved и обновляем зависимости по ежеквартальному графику, а не через случайные PR’ы. Исключение — патчи безопасности; они проходят вне очереди.

Для бинарников (WebRTC, FFmpeg, модели Core ML) фиксируем точный SHA архива .xcframework. Расхождение бинарников — самый неприятный вид багов в продакшене, потому что они тихо пересобираются на новом CI-раннере, и тесты не успевают поймать изменения.

Берите пиннинг к точной версии, когда: зависимость используется в рабочем пайплайне продакшена. Ослабляйте до .upToNextMinor только для внутренних утилит на чистом Swift, где критические изменения случаются редко и не влияют на работу.

Тестирование видеоприложения на Swift Package Manager

Нативный testTarget в SPM хорошо работает со Swift Testing. Для каждого модуля создаётся отдельный тест-таргет, @Suite — для ключевых сценариев, параметризованные тесты — для матричного покрытия.

Интеграционные и UI-тесты размещайте на уровне Xcode-проекта (XCUITest), а не внутри SPM: тесты SPM по умолчанию запускаются без устройства и не подходят для проверки взаимодействий с UIKit или SwiftUI. Общий подход к QA описан в статье о том, как устроено тестирование в Фора Софт.

Миграция с CocoaPods на SPM без поломки сборки

Trunk CocoaPods становится только для чтения 2 декабря 2026 года, поэтому, если вы ещё не начали, запускайте фазу 1 сейчас. Поды, которые вы уже используете, продолжат резолвиться и после этой даты, так что на следующие фазы время есть. Миграция идёт в три фазы, и рабочий откат на CocoaPods сохраняется до последней.

Миграция с CocoaPods на SPM в три фазы: двойной резолв, перенос по одной зависимости, удаление Podfile

Рисунок 3. Путь миграции с двойным резолвом: CocoaPods и SPM работают вместе в фазах 1 и 2, Podfile удаляем, только когда полноценный релиз вышел на одном SPM.

Фаза 1 — двойной резолв. Оставляем Podfile. Добавляем Package.swift с первым модулем (обычно Core). Убеждаемся, что Xcode и CI собирают оба резолвера без ошибок.

Фаза 2 — переносим зависимости по одной. Каждую зависимость CocoaPod переводим на SPM за один релиз-цикл, начиная с чисто Swift-библиотек. Зависимости на Objective-C (например, WebRTC или помощники для AVFoundation) обычно приходится упаковывать в XCFramework, поэтому их оставляем на конец.

Фаза 3 — удаляем Podfile. Только после того, как последний под исчезнет и полноценный релиз выйдет в стор исключительно под SPM. Не торопитесь: пока идёт миграция, возможность откатиться на CocoaPods стоит дёшево и страхует от сюрпризов.

Безопасность, цепочка поставок и пакеты, которые вы реально проверяете

Каждая зависимость в SPM — это код, который вы передаёте пользователю. Для видеоприложения, работающего со сквозным шифрованием, пользовательским медиа или контентом, подпадающим под HIPAA, относитесь к дереву зависимостей как к активу безопасности.

1. Проверяйте каждую зависимость перед подключением. Лицензия, мейнтейнер, дата последнего коммита, открытые предупреждения по безопасности. Если хотя бы один пункт вызывает сомнения, ищите альтернативу или вендорьте только нужный кусок кода.

2. Проверяйте контрольные суммы бинарников. SPM записывает контрольную сумму для каждого бинарного таргета, держите её закреплённой. Тихая подмена бинарника на вашем хостинге означает атаку на цепочку поставок, и контрольная сумма её ловит.

3. Следите за CVE. Подпишитесь на обновления CVE для каждой зависимости или настройте Dependabot / Renovate, чтобы они сами создавали pull request’ы в ваш Package.swift.

4. Готовьтесь к SBOM. Принятое в 2026 году предложение SE-0509 добавляет в SwiftPM генерацию перечня компонентов (SBOM): подкоманду swift package generate-sbom с выводом в CycloneDX и SPDX. Когда она появится в вашем тулчейне, прикладывайте SBOM к каждой релизной сборке.

Берите внутренний вендоринг зависимости, когда: upstream заброшен, критический CVE не исправлен или ваш скоуп соответствия (HIPAA, SOC 2) требует аудируемого форка, который вы контролируете сами.

Экономика: сколько стоит переход на SPM

Ориентиры для продакшен-видеоприложений по размеру кодовой базы. Точные цифры зависят от числа зависимостей и объёма Objective-C-моста, поэтому это опорные точки для планирования, а не коммерческое предложение. Главная колонка — наша оценка с ИИ-инструментами, рядом — оценка команды, которая работает без них.

Четыре типа работы. ИИ-ассистенты ускоряют разработку неравномерно. А — шаблонный код (манифесты, перенос зависимостей, CI): экономия 60–80% часов. Б — продуктовая логика: 40–60%. В — тяжёлая инженерия (упаковка ObjC и WebRTC, конкурентность Swift 6): 15–30%. Г — то, что от скорости кода не зависит (ревью в App Store, релизные циклы, приёмка): 0%. Публичные исследования ускорения расходятся, наши коэффициенты — по проектам Фора Софт.

Трудозатраты на миграцию и разделение модулей по размеру приложения: Фора Софт с ИИ против рынка без ИИ

Рисунок 4. Миграция плюс разделение на модули в инженеро-неделях: Фора Софт с ИИ-инструментами против команд без них. Полоса — середина диапазона из таблицы ниже.

Работа Тип Фора Софт с ИИ-инструментами, инженеро-недели Рынок без ИИ, инженеро-недели
Небольшое (<50 тыс. строк, 5–8 зависимостей): миграция А+Б+В+Г 0,5–1 1–2
Небольшое: разделение на модули смесь видео 0,5–1 1–2
Среднее (50–200 тыс. строк, 10–20 зависимостей): миграция А+Б+В+Г 1,5–2,5 3–5
Среднее: разделение по зонам конкурентности смесь видео 2,5–3,5 4–6
Крупное (200 тыс.+ строк, 25+ зависимостей, много ObjC): миграция А+Б+В+Г 4–6 8–12
Крупное: модульный подпроект вместе с переходом на Swift 6 смесь видео 7–11 12–20
Внутренний SDK бинарным таргетом: первый XCFramework и пайплайн релиза А+В+Г 0,5–1 1–2

Как считали: инженеро-недели без ИИ × коэффициент по типу работы (А −70%, Б −50%, В −22%, Г 0%), калибровка Фора Софт от ноября 2026 года; миграция — смесь 50/20/20/10 (экономия ≈ 49%, диапазон 41–58%), разделение на модули — смесь видеопроектов 30/30/30/10 (≈ 43%, диапазон 33–53%). Релизные циклы, ревью в App Store и приёмка релиза не сокращаются.

Пример. Средняя миграция — 4 инженеро-недели у команды без ИИ, то есть около 160 часов. С ИИ-инструментами та же работа занимает около 80 часов (160 × (1 − 0,49)). Календарь сокращается меньше часов: миграция крупного приложения всё равно растягивается на два релизных цикла, потому что ревью в App Store и приёмка релиза быстрее не становятся. Квартальное обновление внутреннего SDK — около половины рабочего дня с ИИ (рабочий день без ИИ).

Чтобы получить цифру по вашему репозиторию, начните с ревью архитектуры: мы смотрим граф зависимостей, объём Objective-C и состояние CI и возвращаемся с поэтапным планом и оценкой.

Мини-кейс — рефакторинг под SPM в корпоративном видеоприложении

Ситуация. Корпоративное видеоприложение с 20+ подами в CocoaPods, монолит на один модуль, чистая CI-сборка длится 20 минут и миграция на Swift 6 вызывает всё больше проблем. Цель: перейти на SPM, разбить модули по зонам ответственности, сократить чистую CI-сборку до менее чем 10 минут и не нарушить ритм релизов.

План на 12 недель (фактические сроки этого проекта, не оценка). Недели 1–3: создаём каркас Package.swift, выделяем модуль Core, настраиваем двойной резолв вместе с текущим Podfile. Недели 4–7: постепенно переносим чисто-Swift зависимости по релизам (перенесено 7 подов). Недели 8–9: WebRTC упаковываем в XCFramework, выделяем модули MediaEngine, CaptureSession и Signalling. Недели 10–11: убираем Podfile, настраиваем кэш в CI, включаем конкурентность Swift 6 по модулям. Неделя 12: релиз и ретроспектива.

Итог. Чистая CI-сборка сократилась с ~20 минут до менее чем 8. Новые границы модулей при переходе на Swift 6 выявили три скрытые проблемы с конкурентностью, которые раньше незаметно попадали в релизы. Скорость разработки фич выросла: теперь команда может параллельно работать над MediaEngine и Features, не мешая друг другу.

Фреймворк принятия решений — спланируйте свой SPM за пять вопросов

1. Greenfield или легаси? Greenfield — SPM с самого начала. Легаси — планируйте переход на два-три релиза, а не за один большой спринт.

2. Swift 6 или ещё Swift 5? Модули по зонам конкурентности дают наибольший эффект на Swift 6.2 и новее, где изоляция на главном акторе по умолчанию убирает большую часть шума. Если вы на Swift 5.10 с полной проверкой конкурентности, польза тоже заметная.

3. WebRTC бинарём или из исходников? Бинарь — ради скорости CI; исходники — только если нужен свой патч или вы используете не-LTS-ветку WebRTC.

4. Зависимость открытая или приватная? Открытые зависимости подключаются в основном файле Package.swift. Приватные хранятся в отдельном приватном репозитории с настроенным SSH-доступом в CI.

5. Кто отвечает за апгрейды зависимостей? Каждый квартал назначайте одного инженера «уборщиком зависимостей»: он разбирает накопленные обновления, изучает changelog и проводит апгрейд через PR. Ротация — раз в квартал. Если своей iOS-команды на это нет, такие квартальные обновления входят в поддержку и сопровождение продукта.

Грабли, которых стоит избегать

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

2. Сборка WebRTC из исходников в CI. Если вам не нужна собственная ветка, используйте готовый XCFramework. Каждый день это экономит в CI заметное время.

3. .upToNextMajor на всё подряд. Открытые диапазоны версий в продакшене гарантируют сюрпризы посреди релиза. Фиксируйте версии точно, обновляйте осознанно.

4. Постоянное сосуществование SPM и CocoaPods. Двойной резолв допустим на этапе миграции. Если через год вы всё ещё используете оба менеджера, Podfile превратился в кладбище зависимостей.

5. Игнор кэша пакетов в CI. Без кэша каждый PR пересобирает все зависимости с нуля, а пятнадцать строк в CI-конфиге решают это дешевле любой другой оптимизации сборки.

KPI — что измерять после рефакторинга под SPM

KPI качества. Количество вхождений @unchecked Sendable (чем меньше — тем лучше), межмодульные предупреждения Swift 6 в CI (цель — ноль) и число зависимостей на критическом пути.

Бизнес-метрики. Время разработки фичи до и после разделения модулей, задержка между «CI прошёл» и деплоем, а также время адаптации новых инженеров (должно снижаться по мере того, как структура модулей становится понятной).

KPI надёжности. Время полной CI-сборки, время инкрементальной CI-сборки и частота вопросов вроде «почему у меня упал билд» в чате. Все три показателя должны заметно снизиться после правильной настройки SPM.

Когда не стоит затевать SPM-рефакторинг в этом квартале

SPM — правильный выбор для большинства iOS-видеоприложений, но не всегда сейчас. Отложите переход, если команда в процессе миграции на Swift 6 или SwiftUI (лучше делать одну миграцию за раз), если продукт заморожен из-за комплаенса или ревью в App Store, либо если релизный ритм и так напряжён, а CI едва стабилен.

В этих случаях планируйте рефакторинг под SPM как первый проект следующего квартала. Быстрее всего он окупается, если начинать со стабильной базы, а не посреди другой миграции.

Готовы перестроить видеоприложение вокруг Swift Package Manager?

Мы переводили iOS-приложение для видеостриминга с монолитной архитектуры на CocoaPods на Swift 6 и SPM. Пришлите репозиторий и целевую версию — подготовим поэтапный план миграции.

Обсудить проект →Позвонить →Написать на почту →

FAQ

Готов ли Swift Package Manager для видеоприложений в продакшене?

Да. SPM встроен в Xcode с Xcode 11 (2019 год), а начиная со Swift 6 проверяет границы конкурентности на уровне модулей. В Swift 6.4 (сентябрь 2026 года) SwiftPM по умолчанию собирает через Swift Build. Мы используем его в продакшене в нескольких выпущенных видеоприложениях.

Сколько модулей — уже слишком много?

Для типичного видеоприложения оптимальное количество — 6–10 модулей. После 15 обычно наступает убывающая отдача и растут накладные расходы CI. Делите код по зонам конкурентности или архитектурным слоям, а не по отдельным функциям.

Может ли SPM заменить CocoaPods для легаси-кода на Objective-C?

Да, но работы заметно больше. Зависимости на Objective-C нужно упаковать в XCFramework или аккуратно настроить module-map. Если кода на Objective-C много, миграцию лучше распределить на два-три релиза, а не пытаться сделать за один спринт.

Как управлять приватными SPM-пакетами?

Храните их в приватном Git-репозитории, подключайтесь по SSH или HTTPS с токеном, настройте учётные записи для CI. Центральный реестр не нужен. Для крупных организаций отдельный репозиторий «общих пакетов» помогает находить внутренние SDK, не засоряя Package.swift каждого приложения.

Чем заменить GoogleWebRTC в SPM?

Под google/GoogleWebRTC заброшен и SPM-пакетом не был. Берите stasel/WebRTC (155.0.0 на октябрь 2026 года) или форк livekit/webrtc-xcframework, если вы на LiveKit. Для независимости от апстрима заведите зеркало xcframework в своём хранилище и подключайте его как .binaryTarget с контрольной суммой.

Как SPM влияет на время сборки больших видеоприложений?

С бинарным WebRTC, CI-кэшем и явными модульными сборками среднее видеоприложение обычно собирает чистую сборку меньше чем за 10 минут, а инкрементальную сборку для PR — меньше чем за 3. Монолитный Xcode-проект с CocoaPods обычно требует в 2–3 раза больше времени.

Как выглядит SPM-проект с Фора Софт?

Аудит репозитория, предложение структуры модулей и порядок миграции занимают около 2 недель с ИИ-инструментами (2–3 недели у команд без них). Дальше выделенная команда выпускает рефакторинг за два-три ваших обычных релизных цикла. Часто мы работаем с клиентами как отдельная команда разработки.

Подходит ли SPM для Smart TV и tvOS-видеоприложений?

Да. Таргеты SPM поддерживают tvOS как платформу, и та же структура модулей переносится с iOS на tvOS с минимальными правками (ввод, движок фокуса). Мы используем такой подход в продакшене в Smart TV-приложениях — например, в проекте bellicon Smart TV.

Что будет с CocoaPods после 2 декабря 2026 года?

Trunk CocoaPods станет только для чтения: новые версии подов публиковаться не будут. Уже подключённые поды продолжат резолвиться, поэтому сборки не сломаются в один день, но обновления безопасности и новые SDK будут выходить только через SPM.

Сколько стоит перейти с CocoaPods на SPM?

Для среднего видеоприложения (50–200 тыс. строк) миграция занимает 1,5–2,5 инженеро-недели с ИИ-инструментами (3–5 недель у команд без них), разделение на модули — ещё 2,5–3,5 недели (4–6 без ИИ). Релизные циклы и ревью в App Store не сокращаются.

Язык

Swift 6 простыми словами: многопоточность, тесты, ошибки и переход на новую версию

Swift 6: многопоточная безопасность по умолчанию, изоляция по регионам, передача данных, типизированные ошибки, ~Copyable и тестирование — с планом перехода.

Видео

Swift 6 и iOS: создаём современное видеочат-приложение

Видеочат на iOS с Swift 6: архитектура на основе actor, WebRTC, собственный SFU, ИИ на устройстве, Liquid Glass в iOS 26 и тестирование на Swift.

UI

SwiftUI или UIKit для видеоконференций: гид 2026

Что выбрать для iOS-видеоконференции — SwiftUI, UIKit или гибрид? Бенчмарки, шаблоны состояния, правила PiP и CallKit, фреймворк из 5 вопросов.

Интероп

WebRTC в iOS: как добавить видеозвонки в приложение

Мультимедийная команда о работе WebRTC в iOS: как использовать технологию и реализовать видеозвонки в мобильных приложениях.

Контекст

Как создать iOS-приложение для видеостриминга в 2026: инструменты, стоимость и архитектура

Видеостриминг на iOS: AVPlayer, Mux, Cloudflare Stream, AWS IVS, защита FairPlay, ABR-качественные уровни, стоимость и архитектура решения.

Готовы заставить Swift Package Manager работать на ваше видеоприложение?

SPM — модульная система по умолчанию для современной iOS-видеоразработки: встроен в Xcode, понимает Swift 6.2 и новее, работает с CI, а после 2 декабря 2026 года остаётся единственным развивающимся менеджером зависимостей для iOS. Делите код по зонам конкурентности, точно фиксируйте зависимости, поставляйте WebRTC бинарником и кэшируйте сборку в CI. Такой проект быстро компилируется, легко ревьюится и масштабируется между командами.

Если вы делаете новое видеоприложение или переносите монолит с CocoaPods на SPM и Swift 6, этот плейбук пригодится: мы работаем по нему каждый день. Когда понадобятся инженеры, которые уже выпускали такую архитектуру в продакшен, позвоните или напишите нам.

Хотите применить SPM-плейбук к своему репозиторию?

Напишите нам, сколько у вас зависимостей, сколько длится сборка в CI и в каком статусе находится поддержка Swift 6. Мы подготовим поэтапный план рефакторинга и обоснованную оценку.

Обсудить проект →Позвонить →Написать на почту →

  • Технологии