Создание предпочтительного пакета области

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

Создайте проект

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

  1. Запустите XCode.

  2. Выберите New Project из меню File.

  3. Выберите тип проекта Пакета Какао и создайте проект.

  4. Выберите Add Frameworks из Меню проектов. Если выбор уже не там, перейдите в /System/Library/Frameworks каталог. Выбрать PreferencePanes.framework.

Создайте файл пера

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

  1. В то время как XCode все еще работает с Вашим открытым проектом, запустите Интерфейсного Разработчика.

  2. Создайте пустое перо Какао.

  3. Создайте окно и измените размеры его к подходящему размеру. Для Установок системы окно не должно быть больше чем 595 пикселей шириной. Поскольку само окно не используется предпочтительной областью, только ее содержание, Вы не должны указывать заголовок окна, ни локализовать заголовок.

  4. Создайте пользовательский интерфейс в окне.

  5. Возвратитесь к XCode и найдите NSPreferencePane.h заголовочный файл в PreferencePanes.framework. Перетащите заголовочный файл к главному окну пера в Интерфейсном Разработчике.

  6. В области Classes выберите класс NSPreferencePane и создайте подкласс его. Переименуйте его к тому, что Вы хотите. Это - глобальное свойство в предпочтительном приложении, поэтому включайте уникальный префикс в имя, как описано в Предотвращении Конфликтов имен.

  7. С выбранным подклассом перейдите к области Attributes окна Info. Создайте любые выходы или действия, в которых Вы нуждаетесь для пользовательского интерфейса.

  8. В области Instances выберите объект Владельца Файла. В области Custom Class окна Info выберите свой предпочтительный класс области.

  9. Нарисуйте соединение (Перетаскивают управление) между объектом Владельца Файла и объектом окна. Подключите окно с _window выход.

  10. Соедините остающиеся выходы и действия, необходимые для пользовательского интерфейса.

  11. Сохраните файл пера в English.lproj каталог Вашего проекта. Когда спросили, добавить ли его к проекту, нажмите кнопку Add.

Создайте предпочтительные файлы области

В этом разделе описывается создать начальные исходные файлы и вставить предпочтительный значок области в проект.

  1. В Интерфейсном Разработчике, с открытым файлом пера, щелкают по вкладке Classes и выбирают Ваш предпочтительный подкласс области.

  2. Выберите Create Files из меню Classes. Сохраните файлы в своей папке проекта и удостоверьтесь, что проверяется флажок «Insert into targets».

  3. В XCode отредактируйте заголовочный файл своего предпочтительного подкласса области. После импорта строки Cocoa.h, добавьте строку

    #import <PreferencePanes/NSPreferencePane.h>
  4. Добавьте свой предпочтительный значок области к папке Resources проекта.

Обновите настройки сборки

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

  1. Выберите Edit Active Target из Меню проектов и перейдите к области Bundle Settings.

  2. Измените поле «Identifier» на надлежащее уникальное значение для CFBundleIdentifier ключ. Значение должно быть снабжено префиксом обратным доменным именем Вашей организации (см. Предотвращение Конфликтов имен).

  3. Измените поле «Principal class» в Специфичном для какао разделе к имени Вашего предпочтительного подкласса области. Это NSPrincipalClass ключ.

  4. Измените поле «Main nib file» на имя Вашего файла пера. Не включайте .nib расширение. Это NSMainNibFile ключ.

  5. Перейдите к режиму Expert путем нажатия кнопки Expert наверху окна Bundle Settings. Создайте новый ключ путем нажатия кнопки New Sibling. Переименуйте новый ключ NSPrefPaneIconFile и набор его значение к имени Вашего файла значка.

  6. Перейдите к области Build Settings, прокрутите к нижней части окна и изменитесь WRAPPER_EXTENSION входное значение к prefPane.

  7. Выберите InfoPlist.strings файл в папке Resources проекта. Обновите CFBundleName оцените, если это должно отличаться от названия проекта. Также можно добавить запись для NSPrefPaneIconLabel, если необходимо разделить имя между двумя строками.

Создайте и установите предпочтительную область

В этом разделе описывается сделать предпочтительную область доступной для Установок системы.

  1. Разработайте проект.

  2. В Средстве поиска найдите build каталог для проекта. Расположение по умолчанию в папке проекта. Предпочтительная область находится в этой папке.

  3. Переместите предпочтительную область в один из PreferencePanes семья папок перечислила в том, Где Живут Предпочтительные Области. Для тестирования используйте PreferencePanes папка в ~/Library. Вы, возможно, должны создать PreferencePanes папка.

При выполнении Установок системы, необходимо теперь видеть предпочтительную область у основания окна в «Другой» категории.