2. Настройка проекта Xcode — добавление локальных xcframework
Здесь нет ни слияния манифестов, ни URL репозитория — два бинарных фреймворка нужно подключить к проекту Xcode вручную (или с помощью скрипта настройки, если он есть у вашей команды).
2.1 Где разместить фреймворки
Поместите AKSKit.xcframework и AppsKit.xcframework непосредственно в ту же папку, где находится ваш .xcodeproj — то есть рядом с Podfile и папкой исходного кода приложения, а не внутри неё и не в Pods/. Это важно: Xcode находит фреймворки по относительному пути без префикса папки (настраивать FRAMEWORK_SEARCH_PATHS не нужно). Если переместить фреймворки, ссылки на них в файле проекта перестанут работать.
YourApp/ <- CocoaPods project root (Podfile lives here)
├── Podfile
├── AKSKit.xcframework/ <- sibling of the .xcodeproj
├── AppsKit.xcframework/ <- sibling of the .xcodeproj
├── YourApp.xcodeproj/
├── YourApp.xcworkspace/ <- open THIS, not the .xcodeproj, once Pods are installed
└── YourApp/ <- your app target's source folder
├── AppDelegate.swift
└── ...2.2 Добавьте фреймворки в таргет
В Xcode выберите таргет приложения → General → Frameworks, Libraries, and Embedded Content → добавьте оба файла .xcframework и выберите Embed & Sign для каждого. В результате должны появиться:
- запись
PBXFileReferenceдля каждого фреймворка сsourceTree = "<group>"и значениемpathбез префикса папки - оба фреймворка в разделе Link Binary With Libraries (этап сборки
PBXFrameworksBuildPhase) - оба фреймворка на этапе копирования файлов Embed Frameworks (
PBXCopyFilesBuildPhase,dstSubfolderSpec = 10) с атрибутамиCodeSignOnCopy+RemoveHeadersOnCopy— именно такую конфигурацию создаёт выбор "Embed & Sign" в интерфейсе Xcode
Также убедитесь, что LD_RUNPATH_SEARCH_PATHS содержит @executable_path/Frameworks (Xcode добавляет этот путь автоматически при встраивании фреймворка через интерфейс; он позволяет загружать встроенные и подписанные фреймворки во время выполнения).
Если вместо интерфейса Xcode вы используете скрипт (например, на этапе настройки CI), в
project.pbxprojнужно добавить именно эти три компонента: ссылку на файл, этап линковки и этап встраивания.
2.3 Открывайте рабочее пространство, а не проект
После выполнения pod install откройте YourApp.xcworkspace. Именно рабочее пространство связывает таргет приложения с Pods.xcodeproj, созданным CocoaPods. Если открыть напрямую .xcodeproj, при сборке зависимости из Podfile не будут слинкованы корректно.