Installing

Installing a target lets you test how it will work on the end user's computer. Project Builder builds it, if necessary, strips any debugging symbols, and places it where it will appear on the user's computer.

Installing a target is especially useful if your target contains elements used by other products that aren't in your project, so you can test how those products are affected by your changes.

You cannot install a target from within Project Builder. Instead, use the pbxbuild command-line tool.

To install a target:

Here's a detailed description:

  1. Launch Terminal.
    It's in /System/Applications.
  2. su to root (if necessary).
    If your target installs anything inside the System directory, you need to log in as root. Enter su, and enter the root password when prompted.
  3. cd to your project's directory.
    This is the directory that contains your project's .pbproj file. For example, if your project is in ~me/Projects/MyProj, enter cd ~me/Projects/MyProj
  4. Enter pbxbuild.
    This builds the target at the top of your targets list. To build a specific target, use pbxbuild -target target-name.

Choosing Where to Install a Target

To install a target's final product at a particular path:

  1. Click the Targets tab, select the target, click the Build Settings tab, and open the Install Location pane.
  2. Click Path and enter a location.

You can install one target's product inside another target's product within the same project. For example, your project may have targets for an application, framework, and plugin, and you need to install the framework in the application's Frameworks folder and the plugin in the application's Plugins folder. To install a target's product inside another target's product:

  1. Double-click the target's name, click the Build Settings tab, and open the Install Location pane.
  2. Click Subfolder, choose a target and a subfolder.

When you're still debugging a target's product, you can place it somewhere else. See Choosing Where to Build a Target.