---

Introduction

Contents:

Organization of This Document

Dynamic configuration is a convenient way to adjust the properties of your executable without recompiling your code. Rather than relying on hardcoded information, your application implements slightly different behaviors based on external settings. There are several ways to record these settings, ranging from user preferences to property lists stored with your bundle.

Bundles use property lists extensively to store information about the bundle and its contents. Mac OS X and iPhone OS use the information in these property lists to determine an application properties such as its icon and whether to show the status bar (for iPhone applications).

You should read this document to learn about the properties you can use to configure application behavior and specify how Mac OS X or iPhone OS handle your application.

Organization of This Document

This document contains the following articles:

• “Information Property List Files” discusses information property list files and how you use them to configure your bundled application.

• “Property List Key Reference” provides a reference for the keys that can go into an information property list file.

• “The Preferences System” discusses the role and scope of user preferences and describes the use of the defaults tool for accessing preferences.

• “Environment Variables” discusses the role of environment variables in configuring applications. This section also covers some of the ways you can establish environment variables for a given user session or process.

• “Guidelines for Configuring Applications” lists the required and recommended configuration options for applications. This article also describes additional ways to configure both bundled and non-bundled applications.

---