Apple Developer Connection
Member Login Log In | Not a Member? Contact ADC

< Previous PageNext Page > Hide TOC

Installs for Product Developers

The nature and structure of your product determine the install experience you can provide to its users. If your product is a self-contained application (one that doesn’t need to install components at different locations in the file system), you can distribute it as a single file or folder. Users then can drag the product from its container or delivery vehicle to a location of their choice in their file systems. This type of installation process is called manual install. This is the preferred method of delivering applications to Mac OS X users.

However, there are situations that require more complex products. For example, some applications require the presence of shared resources such as frameworks or fonts, which, in general, reside at /Library/Frameworks and /Library/Fonts, respectively. Each item that resides at a distinct location on the file system is known as a component. To make it easy for users to install a multicomponent product, instead of making users place each component in the appropriate location you develop an appealing install that frees users from that tedious and error-prone task. To that end, the Installer application (/Applications/Utilities) uses a simple interface to guide users through the process of installing multicomponent products. This type of installation process is known as a managed install.

Note: This document uses the word component as a general term to refer to parts of a multipart product. It has no functional relation to items that are normally placed in Library/Components directories.

Managed installs provide users with a GUI (graphical user interface) through which they specify a few details to customize an install. The Installer application handles the file-management tasks on the users’ behalf.

You use PackageMaker (/Developer/Applications/Utilities) to develop a managed install. You can tailor the install experience with Read Me and license agreement files and by specifying installation requirements to ensure the product is installed only on systems that meet specific criteria, such as available memory and disk space.

Listing 1-1 shows an example of a single-component product, called Atom. This is the kind of product users should be able to install manually.

Listing 1-1  Atom—A single-component product

Atom_product/
   Atom.app

Listing 1-2, on the other hand, showcases a multicomponent product, called Levon, comprised of an application package, a documentation file, and a framework. The application package should be placed in /Applications, the documentation file in /Library/Documentation, and the framework in /Library/Frameworks. (See File System Overview for a more complete list file system locations and component types.) For users, having to drag three files to three locations is not an appealing install experience. A managed install is more appropriate for a product of this kind.

Listing 1-2  Levon—A multicomponent product

Levon_product/
   Levon.app
   Levon_User_Guide.pdf
   SharedServices.framework


< Previous PageNext Page > Hide TOC


Last updated: 2006-07-24




Did this document help you?
Yes: Tell us what works for you.

It’s good, but: Report typos, inaccuracies, and so forth.

It wasn’t helpful: Tell us what would have helped.
Get information on Apple products.
Visit the Apple Store online or at retail locations.
1-800-MY-APPLE

Copyright © 2007 Apple Inc.
All rights reserved. | Terms of use | Privacy Notice