Introduction

Explains how to create dynamically loaded plug-ins that provide a graphical interface to user preferences.

Who Should Read This Document?

You should read this document if you are a Cocoa developer who wants to provide a custom preference pane, accessible from the System Preferences applications, to your users. You should have a working knowledge of Cocoa programming with the Application Kit before attempting preference pane programming.

Organization of This Document

This document describes how to create and manage a preference pane, how to have System Preferences load your own preference pane, and how to load a preference pane in your own application.

Here are the concepts covered:

Architecture of Preference Panes describes the plug-in architecture of preference panes and how they interact with applications and the system.

The Preference Application describes the ways the preference pane can be presented to the user: System Preferences, a specialized preferences application, or inside the main application.

Managing User Preferences describes several ways the preference pane can interact with the system for manipulating preferences.

Life Cycle of a Preference Pane describes how the application interacts with the preference pane.

Anatomy of a Preference Pane Bundle describes the structure of a preference pane bundle.

Updating Preference Panes describes the requirements for preference panes for OS X version 10.6 and later.

Here are the tasks covered:

Preventing Name Conflicts recommends a technique to prevent name conflicts between the global symbols in your preference pane and either the application or other preference panes.

Wrapping Long Labels describes how to modify the .plist file so that long labels are split across two lines.

Using Preference Services describes the methods available for reading and writing preferences to a preference file.

Communicating With the Target Application provides examples for notifying a separate target application of preference changes.

Creating a Preference Pane Bundle walks you through the steps of creating a skeletal preference pane bundle in Xcode and Interface Builder.

Implementing a Simple Preference Pane walks you through the source code of a simple preference pane, showing an example of how to implement a working preference pane.

Using Preference Panes in Other Applications describes the responsibilities of an application that loads a preference pane.