

About Xcode Tools

Compatibility and Installation

Xcode Tools 2.4.1 Release for

Mac OS X v10.4 (Tiger)

Contents

Introduction
Compatibility with Mac OS X Versions
What's New
Installation
Troubleshooting
Deprecation Notice

Introduction

Xcode Tools distribution includes everything you need to develop software for Mac OS X, including the
Xcode IDE, programming tools, system API documentation, Mac OS X interfaces, libraries, and example
source code.

For the latest information and updates to Xcode Tools, documentation, code samples, and technical
notes, please visit the Apple Developer Connection’s Mac OS X tools pages at http://
developer.apple.com/tools/ .

We encourage developers to join the Apple Developer Connection, which provides the most convenient
access to Mac OS X development resources, including technical support and pre-release software. For
information visit http://developer.apple.com/ .

Compatibility with Mac OS X Versions

Xcode Tools 2.4.1 will run on Mac OS X v10.4 (Tiger). It will not install or run on earlier versions of
Mac OS X. Xcode Tools supports development for target platforms of Mac OS X v10.2 (Jaguar), Mac OS X
v10.3 (Panther), and Universal binaries for Power PC and Intel running on Mac OS X v10.4 (Tiger) or
later using Mac OS X SDK support.

What's New

Xcode 2.4.1 contains bug fixes in the following areas:

GCC4
GDB
64-bit Linker
SDKs
Xcode

Xcode 2.4.1 also contains CHUD 4.4.3 and updated documentation.

Xcode 2.3 introduced support for the DWARF debugging format in GCC and the Xcode debugger.  

Because the DWARF format eliminates duplication of debugging symbols, Xcode builds using DWARF
often take up significantly less space on disk and in memory while providing even greater debugging
fidelity. For the users of Xcode, this means lowered system requirements to build large projects, as well
as noticeable improvements in the debugging experience itself. DWARF is not the default format for
Xcode. See the release notes for further information on using DWARF within your projects.

Dedicated Network Builds (DNB) is a new form of scalable builds to compliment existing Shared
Workgroup Builds (also known as "distcc"). DNB is designed to scale more efficiently than distcc for large
build farms. The DNB model allows wider scalability through a dedicated administration process, and
greater resource commitments by each build machine. As the name implies, DNB is specially designed
for a dedicated build farm.

Please see the Xcode Release Notes from Xcode's Help menu for up-to-date information on changes to
Xcode.

Installing Xcode Tools

The XcodeTools.mpkg package contains several separate sub-packages in the Custom Install panel
that allow flexibility in installing and updating:
• Developer Tools Software (DeveloperTools.pkg) - This package contains Xcode, gdb, and the other
tools necessary for Macintosh development.
• GCC 4.0.1 (gcc4.0.pkg) - This is the latest version of gcc. This compiler is necessary for 64-bit
development, and for using the DWARF debugging format.
• GCC 3.3 (gcc3.3.pkg) - This package contains the gcc 3.3 compiler. This compiler is necessary for
targeting Mac OS X v10.2 (Jaguar).
• Software Development Kits - These packages provide the header files and link libraries necessary for
Macintosh development. All Macintosh development requires Mac OS X SDK. This package
provides the API for basic Macintosh technology such as Carbon, Cocoa, and command-line tools.
The other SDK packages provide API for extended Macintosh technologies, such as QuickTime,
OpenGL, etc.
• Java 1.4 Developer Tools - These packages are used when developing Java 1.4 applications for
Macintosh.
• Developer Documentation (DevDocumentation.pkg) - This package contains the core Macintosh
developer documentation for technologies such as Carbon, Cocoa, QuickTime, WebKit, etc.
• Developer Examples (DevExamples.pkg) - This package contains example code for a wide variety of
Macintosh technologies. Note that these examples may require any of the above Software
Development Kits to be installed before they will compile.
• WebObjects (WebObjects.mpkg) - These packages are used for WebObjects 5.3 development.
• Cross Development (MacOSX10.2.8.pkg, MacOSX10.3.9.pkg, MacOSX10.4u.pkg) - These packages
are for Mac OS X v10.2 (Jaguar), Mac OS X v10.3 (Panther), and Mac OS X v10.4 (Tiger) to allow
cross development. These can be installed together or independently, and can be installed
separately from the installation of the rest of Xcode. You must install MacOSX10.4u.pkg to enable
building of universal binaries.
• CHUD Tools (CHUD.pkg) - This package contains the Computer Hardware Understanding Developer
Tools. For more information see http://developer.apple.com/tools/performance/.

Installation instructions for Xcode 2.4.1

1) Boot into Mac OS X.
2) Insert the Xcode Tools DVD or the Xcode Tools CD 1.
3) Double-click on XcodeTools.mpkg, located at the top-level of the installation media.
4) Follow the instructions in the Installer. If you need to install CHUD, WebObjects, the Mac OS X 10.2.8
cross development package, or the Java 1.4 Reference Documentation, you must select "Custom
Install", and check those packages.
NOTE: If you select the Java 1.4 Reference Documentation, the installer will reindex all of the
developer documentation, which could take a very long time.
5) Authenticate as the administrative user. The first user you create when setting up Mac OS X has
administrator privileges by default.
NOTE: Xcode Tools MUST be installed on the same hard drive partition from which you booted Mac OS
X. The Installer prevents installation on any other partition.
If you encounter any problems in installation, including not having enough disk space to do the
installation, please refer to the "Troubleshooting" section below.
Once you have installed the Xcode Tools package, you can access the documentation by launching
Xcode and choosing any of the items in the Help menu. Developer applications, such as Xcode and
Interface Builder, are installed in /Developer/Applications.

It is highly recommended that you copy any of the examples in /Developer/Examples to another directory
before opening them and modifying them. If a particular example is modified such that it no longer works,
you must remove the example, and reinstall the entire examples package by double-clicking on
Packages/DevExamples.pkg on the Xcode Tools installation disk.

Troubleshooting

If you have a small amount of disk space on your boot volume, you can set up a symbolic link for any part
of the /Developer hierarchy. The installer will respect the symbolic link and install the files correctly. For
more information on symbolic links, see "man ln".

In some configurations upgraded from Jaguar to Tiger, Project Builder IDE and Xcode IDE will both be
available in the /Developer/Applications folder. Project Builder is not supported for use on Tiger.

Uninstalling Xcode Tools

To uninstall Xcode Tools on your system, from a Terminal window type:

$ sudo perl /Developer/Tools/uninstall-devtools.pl

To uninstall from the DVD, CD, or disk image that contains Xcode Tools, from a Terminal window type:

$ sudo perl /Volumes/Xcode\ Tools/Utilities/uninstall-devtools.pl

NOTE: The uninstaller that ships with previous versions of Xcode Tools or Developer Tools will not clean
everything off of your system properly. You should either use the one on the Xcode Tools 2.4.1 DVD, or
you should use the one installed when you installed Xcode Tools 2.4.1.

NOTE: Running the uninstall script from Xcode Tools will uninstall any previous installations of Mac OS X
Developer Tools or Xcode Tools releases.

Deprecation Notice

NOTE: As of the release of Xcode 2.4, the Cocoa Java bridge has been deprecated. This means that,
while still supported with Xcode 2.4 and Xcode 2.4.1, future releases of Xcode may not support the
bridge or other dependent features. Due to this, the following additional WebObjects developer
applications are also being deprecated:
EOModeler
EOModeler Plugin
WebObjects Builder
WebServices Assistant
RuleEditor
WOALauncher

This also means that the Xcode Java bridge templates have been deprecated, and should not be used
for new Java bridge-based development.

© 2006 Apple Computer, Inc. All rights reserved. Xcode, Apple, the Apple logo, Mac, Mac OS, and Macintosh are trademarks of Apple
Computer, Inc., registered in the U.S. and other countries.