В некоторых из моих прошлых проектов Cocoa Pods не были настроены правильно, и это приводило к нежелательным вещам, таким как необходимость дублирования проектов Cocoa Pod в Project Navigator или необходимость возврата файлов pod в систему управления версиями.
Как правильно установить Cocoa Pods и убедиться, что моя структура каталогов и структуры Project Navigator настроены правильно?
Лучший способ использовать Cocoa Pods — следовать официальному примеру.
Это состоит из нескольких шагов.
Начните с Руководства по началу работы, чтобы установить Cocoa Pods на свой компьютер.
Не создавайте Podfile в Xcode, так как он не должен быть частью вашего проекта!
Создайте файл в своем любимом текстовом редакторе и сохраните его на том же уровне, что и ваш файл .xcodeproj.
Пример содержимого подфайла:
pod 'CupertinoYankee', '~> 1.0'
Перейдите в каталог вашего подфайла в терминале и запустите pod install.
Как только вы запустите pod install, вы увидите сообщение, например:
[!] Отныне используйте
MyProject.xcworkspace.
Закройте проект Xcode и откройте сгенерированный файл .xcworkspace.
Всегда полезно знать, какие изменения были внесены в ваш проект на случай, если что-то пойдет не так.
Вы должны были начать с такой структуры, как:
... затем вручную добавил подфайл:
После запуска pod install ваша структура каталогов теперь выглядит так:
Обратите внимание, что единственными новыми объектами являются:
В Xcode вы начали с этого:
... и закончилось этим в новой рабочей области:
Для справки, вот расширенный взгляд на новую структуру каталогов:
Очевидно, что проект Pods был добавлен в навигатор проектов, но есть еще несколько ключевых моментов, на которые стоит обратить внимание:
Обратите внимание, что Podfile находится в корне папки MyProject в Finder, но находится внутри проекта Pods в навигаторе проектов Xcode.
Аналогично, обратите внимание, как Pods.xcconfig находится внутри папки Pods в Finder, но находится внутри MyProject в навигаторе проекта Xcode.
Это те же скриншоты, что и раньше:
В Xcode вы начали с этого:
... и закончилось этим в новой рабочей области:
Обратите внимание, что в разделе «Конфигурации» для цели «Мой проект» теперь указано Pods.
Это важно, потому что в противном случае PODS_ROOT не будет настроен должным образом (среди прочего), и при сборке вы получите ошибки.
Настройки сборки вашей цели пошли от этого: (Примечание: это прокручивается полностью вниз)
... к этому:
Обратите внимание, как PODS_ROOT был добавлен в качестве пользовательской настройки.
Примечание. Эта часть конфигурации иногда дает сбои при переустановке модулей, поэтому вам может потребоваться закрыть и открыть проект Xcode. починить это.
Вы можете увидеть полный список изменений здесь.
В моем случае: в моем проекте SwiftLint было добавлено Build Phasees -> SwiftLint, как показано ниже. 
Структура моей корневой папки была Volume/Project Files/iOS Project Files/Office Projects/project-name. Как вы можете видеть, в моей структуре каталогов было место, SwiftLint, выполненный на этапе сборки, создал проблему для этого пространства и показал ошибку no directory found. После изменения каталога высокого уровня путем переименования, как на изображении ниже, моя проблема была решена 
