Создание плагина мозаики прикрепления

Когда приложение не работает, запускаясь в OS X v10.6, можно настроить значок и меню мозаики Прикрепления приложения. Например, можно хотеть обновить текст значка, чтобы указать, что новое содержание будет доступно в следующий раз, когда приложение запускается. Точно так же можно хотеть обеспечить специализированное меню на основе содержания, доступного пользователю. Чтобы сделать это, Вы создаете плагин мозаики Прикрепления и связываете его с Вашим приложением. Когда приложение добавляется на Прикрепление, плагин приложения загружается автоматически.

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

Необходимо быть familar с задачами, описанными для приложений Какао, потому что многие из тех же понятий используются плагинами мозаики Прикрепления. Посмотрите Задачи Мозаики Прикрепления для Приложений Какао для получения дополнительной информации.

Создание плагина

Плагин мозаики Прикрепления является загружаемым пакетом. Для получения дополнительной информации о создании загружаемых пакетов, посмотрите, что Код Загружает Темы Программирования.

Плагин мозаики Прикрепления должен быть помещен в Contents/PlugIns каталог пакета Вашего приложения. Плагин связан с приложением путем добавления a NSDockTilePlugIn ключ к информационному списку свойств приложения. Значение, связанное с этим ключом, является именем пакета плагина, который должен закончиться a .docktileplugin расширение.

Основной класс плагина должен реализовать NSDockTilePlugIn протокол. setDockTile: метод является единственным требуемым методом в этом протоколе. Когда плагин загружается, объект основного класса инстанцируют, и setDockTile: метод вызывают. Вызов к этому методу обеспечивает NSDockTile возразите против своего плагина. Ваш плагин должен сохранить объект мозаики Прикрепления и выполнить любую другую инициализацию, требуемую Вашим плагином. Например, если Ваш плагин получает информацию от приложения только для фона, это может зарегистрироваться для события уведомления, отправленного тем другим приложением.

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

Когда Ваше приложение удалено из Прикрепления, setDockTile: метод вызывают с a nil параметр. Ваш setDockTile: метод должен удалить любые сильные ссылки к объекту мозаики Прикрепления, очистить любые ресурсы Ваш плагин Мозаики Прикрепления, выделенный, и выход.

Изменение значка мозаики прикрепления

Когда Ваше приложение должно настроить мозаику Прикрепления, оно управляет NSDockTile объект, который был предоставлен для начального вызова setDockTile: метод.

Обеспечение пользовательского меню в плагине

Ваш класс может дополнительно обеспечить a dockMenu метод для обеспечения дополнительных пользовательских элементов меню. Этот метод работает так же к applicationDockMenu: метод, предоставленный делегатом приложения. OS X вызывает Ваш плагин dockMenu метод, когда пользователь запрашивает меню на Вашу мозаику Прикрепления.