Находим потерянные файлы в нескольких Xcode таргетах

Привет, я Саня — iOS-разработчик и в этой статье поделюсь своим способом решения головной боли, которая возникает при работе на проекте с несколькими таргетами.

Предвижу вопрос «зачем тебе, Саня, несколько таргетов в проекте?». Отвечаю: на проекте, где я когда-то работал, был один таргет, привязанный к аккаунту заказчика, так что:

• доступа к этому аккаунту у нас не было;
• отсутствовала возможность генерировать provision profiles и distribution сертификаты;
• самое больное — не было возможности добавлять новые девайсы к provision profiles.

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

Решение было очевидным – создать второй таргет, который будет аналогичен главному, но иметь другой bundle id и который будет целиком и полностью привязан к нашему студийному аккаунту. Сказано – сделано! Второй таргет позволил вести полноценную разработку независимо от разработчиков на стороне заказчика, что не раз спасало нам процесс разработки, к примеру, когда на provision profile главного таргета разработчики заказчика удалили все наши девайсы и мы не могли запускать приложение на своих устройствах.

Несколько таргетов еще могут появиться в вашем проекте, когда нужно, например:

• собрать несколько приложений из одной кодовой базы, но с разными ресурсами;
• держать несколько инстансов приложения на одном устройстве.

Но работа на нескольких таргетах ведет к своим минусам, главный — необходимость строго контролировать процесс добавления новых файлов в проект. Они оба идентичны друг другу, соответственно, при добавлении нового файла в проект необходимо ставить галочку напротив обоих таргетов.

Это очень сложно при работе в большой разноуровневой команде, как по скиллам, так и по добросовестности.

Если не придерживаться этого простого правила, после очередного мерджа вы можете обнаружить, что один из таргетов перестал собираться, а Xcode ругается, что не может найти тот или иной класс. Но самое интересное, если кто-то не добавил файл из Copy Bundle Resources в оба таргета (к примеру, xib ячейки), такую ошибку вы сможете обнаружить только лишь в runtime.

После очередной проблемы с Debug-таргетом, решили отдать контроль за консистентностью таргетов на скрипт. В качестве инструмента выбрали язык Ruby, так как для него есть отличный гем xcodeproj , который является чуть ли не стандартом для написания инструментов для iOS разработки (см. fastlane, generamba и т.п.).

В результате разработали скрипт, который реализует следующую логику работы:

• на вход подаются путь до файла проекта и названия проверяемых таргетов;
• по пути до проекта скрипт находит сам проект;
• выбирает нужные таргеты, собирает файлы из них (Compile Sources, Copy Bundle Resources и Frameworks);
• ищется разница между перечнями файлов;
• выкидываем из этой разницы файлы из нашего whitelist. К примеру, файлы с константами, которые различаются в зависимости от таргета (baseUrl, если вы решили организовать проект так, чтобы приложения с разных таргетов обращались к разным серверам), либо файлы GoogleService-Info.plist, которые будут разными для разных таргетов.

Если скрипт находит разницу — у нас проблемы. Значит, тот или иной файл/фреймворк были добавлены в один таргет, но не добавлены в другой.

Таким образом, скрипт позволяет:

• убедиться, что все файлы из Compile Sources и Copy Bundle Resources были корректно добавлены к обоим таргетам;
• также проверяется идентичность списков добавленных фреймворков, что очень актуально, если на вашем проекте многомодульная архитектура;
• интеграция скрипта на Build Phase позволит определить проблему еще до непосредственно стадии сборки проекта;
• а если раньше вы для этого собирали на CI оба таргета, то теперь можно оставить сборку только одного, сократив время сборки на CI вдвое.

В случае ошибки, в Xcode вы сможете наблюдать следующее сообщение:

В случае же успеха — вас ждет единорожек:

Подробная инструкция добавления в проект, настройки, а также Example-project в репозитории.

Получившиеся утилита отлично показывает то, что даже будучи iOS-разработчиком можно внести небольшую дольку креатива в вашу повседневную работу и заняться автоматизацией и написанием скриптов, которые упростят вашу жизнь!

Спасибо за внимание!