Как правильно настроить проект для Cocoa Pods?

В некоторых из моих прошлых проектов Cocoa Pods не был настроен правильно, и это приведет к нежелательным вещам, таким как необходимость дублирования проектов Cocoa Pod в Навигаторе проектов или файлы подкачки, которые необходимо проверить в версии контроль.

Как правильно установить Cocoa Pods и убедиться, что структура каталогов и структуры Project Navigator настроены правильно?

Ответ 1

Лучший способ использовать Cocoa Pods - следовать .

Это состоит из нескольких шагов.

Настройка Cocoa Pods в первый раз

1. Установите Cocoa Подставки на вашем компьютере

Начните с Руководство по началу работы для установки Cocoa Pods на вашем компьютере.

2. Создайте Podfile

Не создавайте подфайл в Xcode, так как он не должен быть частью вашего проекта!

Создайте файл в своем любимом текстовом редакторе и сохраните его на том же уровне, что и ваш файл .xcodeproj.

Пример содержимого подфайла:

pod 'CupertinoYankee', '~> 1.0'

3. Запустить программу установки

Перейдите в каталог подфайлов в терминале и запустите pod install.

4. Откройте сгенерированное рабочее пространство

После запуска pod install вы увидите сообщение, например:

[!] Теперь используйте MyProject.xcworkspace.

Закройте проект Xcode и откройте созданный файл .xcworkspace.

Общие сведения об изменениях

Всегда полезно знать, какие изменения были внесены в ваш проект в случае, если все пошло не так.

1. Структура каталогов

Вы должны были начать с такой структуры, как:

enter image description here

... затем вручную добавлен подфайл:

enter image description here

После запуска установки pod структура каталогов теперь выглядит так:

enter image description here

Обратите внимание, что только новые объекты:

  • MyProject.xcworkspace
  • Podfile.lock
  • Бобы

2. Навигатор проекта

В Xcode вы начали с этого:

enter image description here

... и закончил это в новой рабочей области:

enter image description here

Для справки, вот расширенный взгляд на новую структуру каталогов:

enter image description here

Очевидно, проект Pods был добавлен в Project Navigator, но есть еще несколько ключевых замечаний:

Обратите внимание, что Podfile находится в корне папки MyProject в Finder, но находится внутри проекта Pods в навигаторе проектов Xcode.

Также обратите внимание, что Pods.xcconfig находится внутри папки Pods в Finder, но находится внутри MyProject в навигаторе проектов Xcode.

3. Конфигурации

Это те же скриншоты, что и раньше:

В Xcode вы начали с этого:

enter image description here

... и закончил это в новой рабочей области:

enter image description here

Обратите внимание, что в разделе "Конфигурации" цель "MyProject" теперь имеет Pods.

Это важно, потому что иначе PODS_ROOT не будет настроен должным образом (между прочим), а когда вы построите, вы получите ошибки.

4. Добавлен PODS_ROOT

Твой целевой Настройки сборки пошел дальше: (Примечание: это прокрутка полностью вниз)

enter image description here

... к этому:

enter image description here

Обратите внимание, что PODS_ROOT был добавлен как пользовательский параметр.

Примечание. Эта часть конфигурации иногда выдается из строя при переустановке Pods, поэтому вам может понадобиться закрыть и открыть проект Xcode, чтобы исправить ее.

5. Другие изменения

Вы можете увидеть полный список изменений здесь.