Apps Kit SDK logoApps Kit SDK
Документация · Интеграция с iOS

2. Настройка проекта Xcode — добавление локальных xcframework

Здесь нет ни слияния манифестов, ни URL репозитория — два бинарных фреймворка нужно подключить к проекту Xcode вручную (или с помощью скрипта настройки, если он есть у вашей команды).

2.1 Где разместить фреймворки

Поместите AKSKit.xcframework и AppsKit.xcframework непосредственно в ту же папку, где находится ваш .xcodeproj — то есть рядом с Podfile и папкой исходного кода приложения, а не внутри неё и не в Pods/. Это важно: Xcode находит фреймворки по относительному пути без префикса папки (настраивать FRAMEWORK_SEARCH_PATHS не нужно). Если переместить фреймворки, ссылки на них в файле проекта перестанут работать.

plaintext
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 не будут слинкованы корректно.