About Xcode Tools

 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.