Конфигурирование проекта платформы

При создании новой платформы существует несколько параметров конфигурации, которые можно хотеть изменить. Эти опции упрощают распределять Вашу платформу клиентам и гарантировать ее совместимость после будущих циклов разработки. Таблица 1 перечисляет некоторые опции, которые необходимо установить для платформы.

Тестирование платформы на месте

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

Если Ваш проект платформы содержит дополнительные цели для тестовых приложений, то XCode создает те приложения в той же папке как Ваша платформа. Тестовые приложения, созданные рядом с Вашей платформой, находят что платформа автоматически из-за их близости к нему. Однако, если Вы встраиваете свои тестовые приложения в различный каталог сборки, те приложения могут быть неспособны найти Вашу платформу, если Вы не говорите им, где найти его.

Обычный путь к приложению для нахождения платформы состоит в том, чтобы посмотреть в стандартных расположениях (см. Установку Платформы). Однако Вы не можете хотеть переустанавливать свою платформу каждый раз, когда Вы вносите изменения в нее. В этом случае можно сказать тестовые приложения точно, где найти платформу с помощью DYLD_FRAMEWORK_PATH переменная окружения. Добавление этой переменной к Вашей исполнимой программе говорит dyld где искать дополнительные платформы, если это не находит то, в чем это нуждается в стандартных расположениях. Следующие шаги показывают Вам, как установить эту переменную в XCode.

1. Откройте свой проект приложения в XCode.

2. В области Groups & Files откройте Исполнимую группу, выберите исполнимую программу, чтобы сконфигурировать, открыть ее окно Info и нажать Arguments.

3. Добавьте запись в список переменных окружения.

4. Определите имя переменной окружения к DYLD_FRAMEWORK_PATH.

5. Установите значение переменной к полному пути каталога, содержащего Вашу платформу.

   Для указания многократных каталогов платформы разделите пути двоеточием. Например, у Вас могло быть значение, такое как следующее значение на этой строке: /Users/lynn/MyFrameworks:/Volumes/Keylime/MyOtherFrameworks.

Используя единственный проект XCode для обеих целей

Используя единственный проект XCode и для Вашего приложения и для цели платформы упрощает требуемую установку. Как только Вы создаете свой проект, Вы просто добавляете две цели к нему: один для Вашего приложения и один для Вашей платформы. (Поскольку обе цели находятся в том же проекте, нет никаких проблем, находящих исходные файлы ни от одной цели во время изготовления.) После этого Вы просто конфигурируете свою платформу и цели приложения с надлежащей информацией о выполнении для встраивания.

Конфигурация для Вашей цели платформы включает сообщение его, где это будет установлено. Платформе нужна эта информация так, чтобы это могло найти ресурсы, в которых это нуждается. Поскольку платформы обычно устанавливаются в фиксированных расположениях, Вы обычно указываете полный путь к надлежащему каталогу платформ. При встраивании платформы в пакете, однако, расположение платформы не фиксируется, таким образом, необходимо использовать @executable_path заполнитель, чтобы позволить платформе знать свое расположение относительно текущей исполнимой программы.

1. Откройтесь инспектор для Вашей платформы предназначаются и выбирают вкладку Build.

2. Установите значение установки сборки Каталога Установки в @executable_path/../Frameworks.

Во время изготовления XCode создает Вашу платформу и помещает результаты в каталог сборки. Прежде чем приложение может использовать платформу, однако, необходимо сконфигурировать цель приложения следующим образом:

• Необходимо скопировать платформу в пакет приложения.

• Необходимо соединить приложение против платформы.

• Необходимо создать зависимость от сборки между платформой и приложением.

Следующие шаги показывают Вам, как сконфигурировать Вашу цель приложения.

1. В области Group & Files откройте свою цель приложения для просмотра ее текущих фаз сборки.

2. Перетащите свой продукт платформы (расположенный в папке продуктов) к существующему Двоичному файлу Ссылки С фазой сборки Библиотек Вашей цели приложения. Это заставляет приложение соединяться против Вашей платформы.

3. Добавьте новую Фазу Сборки Файлов Копии к цели приложения. (Эта фаза будет использоваться для установки платформы в комплекте приложений.)

4. Выберите новую фазу сборки и откройте окно инспектора.

5. Во вкладке «Общие» окна инспектора, набор место назначения для фазы сборки к «Платформам».

6. Перетащите свой продукт платформы к новой фазе сборки.

7. Выберите цель приложения снова и откройте окно инспектора.

8. Во вкладке «Общие» окна инспектора добавьте свою платформу как зависимость для приложения. Добавление этой зависимости заставляет XCode создавать цель платформы прежде, чем создать цель приложения.

Зависимость от сборки, которую Вы устанавливаете в цели приложения, заставляет платформу быть созданной перед приложением. Это важно, потому что это гарантирует, что созданная версия Вашей платформы будет доступна, чтобы соединиться против и встроить в приложение. Из-за этой зависимости можно поставить активную цель проекта XCode к приложению и оставить его там. Создавание приложения теперь создают платформу и копируют его в каталог комплекта приложений, создание необходимой связи между двумя.

Используя отдельные проекты XCode для каждого Target

Если у Вас уже есть отдельные проекты XCode для Вашей платформы и приложение, можно использовать в своих интересах перекрестные ссылки проекта XCode для встраивания платформы в приложение. Перекрестные ссылки проекта являются удобным способом создать отношения между двумя отдельными проектами XCode. Для установки перекрестной ссылки проекта между приложением и платформой Вы сделали бы следующее:

1. В Вашем проекте приложения выберите Project> Add to Project и выберите свою платформу .xcodeproj файл. XCode добавляет проект платформы и выводит на экран его продукты в области Groups & Files Вашего проекта приложения.

2. Измените установку Build Products Path и для приложения и для целей платформы так, чтобы они использовали тот же каталог сборки. Необходимо изменить каждую цель в их исходном файле проекта XCode.

3. В Вашем проекте приложения измените установку Header Search Paths цели приложения путем добавления каталогов, содержащих любые заголовочные файлы платформы.

Как только Вы сконфигурировали свои проекты XCode создать должным образом, можно продолжить с шагами конфигурации, должен был встроить платформу в приложение. Остающиеся шаги конфигурации для платформы и целей приложения идентичны тем описанным в Использовании Единственного Проекта XCode Для Обеих Целей. Каталог установки Вашей платформы должен быть сконфигурирован, чтобы быть относительно исполнимого пути приложения. Точно так же цель приложения должна скопировать платформу в свой пакет и установить необходимую связь и зависимости. Единственная разница - то, что необходимо сконфигурировать каждую цель в ее собственном проекте XCode.

Обновление вспомогательной версии

При внесении незначительных изменений в платформу нет никакой потребности создать новый проект XCode для платформы. Однако необходимо всегда обновлять значения «текущей версии» и «версии совместимости», связанные с платформой. Если соединение программы к Вашей платформе возможно, эти значения позволяют динамическому компоновщику определить.

Для получения дополнительной информации о том, как обновить информацию о вспомогательной версии Вашей платформы и на типах изменений, составляющих обновление вспомогательной версии, видящих Вспомогательные версии.

Обновление основной версии

Процесс для обновления основной версии платформы является более трудным, чем процесс для вспомогательных версий. Рекомендуемый способ создать новую основную версию состоит в том, чтобы сделать двойную версию Вашей всей папки проекта XCode и продолжать разрабатывать оттуда. Старые файлы проекта должны архивироваться и использоваться для выполнения устаревших сборок. Однако активная разработка должна продолжить новый проект.

Как только у Вас есть новая папка проекта, необходимо сделать несколько модификаций к проекту XCode идентифицировать проект как основную версию. Выберите свою платформу, предназначаются и открывают окно Inspector. В области Build измените следующие опции сборки:

• Постепенно увеличьте значение установки сборки Версии Платформы в следующее последовательное значение.

• Постепенно увеличьте значение Текущей установки сборки Версии Библиотеки.

• Обновите значение установки сборки Версии совместимости для соответствия обновленной Текущей Версии Библиотеки.

• Обновите любые настройки сборки, информация о пути которых включает указатель основной версии платформы. Например, если у Вас есть фаза сборки Файлов Копии на основе каталога продукта, Вы, возможно, должны обновить тот путь. Или удостоверьтесь, что пути указаны с помощью платформы Current символьная ссылка.

• В области Properties целевого окна Info платформы обновите номер версии, который сохранен в информационном списке свойств Вашей платформы.

Как только Вы вносите изменения в свой код, можно создать цель платформы. То, что Вы получаете, является новым пакетом платформы, содержащим только новую основную версию.

Во время установки, если версия Вашей платформы уже не существует в целевой системе, имеют копию установщика Ваш пакет платформы по тому, как. Однако, если существующая версия платформы присутствует, имейте копию установщика содержание Вашего нового каталога платформы к старому каталогу. Ваш сценарий установщика должен заменить символьные ссылки в старом пакете платформы с, указывающими на новую версию платформы. Однако копирование по новой основной версии должно оставить любые старые версии неповрежденными. В то время как более новые версии используют обновленную платформу, это разрешает существующим приложениям продолжать работать.

Можно также хотеть, чтобы установщик удалил любые заголовочные файлы или документацию для устаревших версий платформы. Этот шаг является дополнительным и оставлен Вашему усмотрению. Однако рекомендуется предотвратить разработчиков от случайно включая устаревший набор заголовочных файлов или просмотр более старой документации, во время разработки.

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