Xcode 1.2 Release for Mac OS X Version 10.3 (Panther)



Xcode 1.2 Release for Mac OS X version 10.3 (Panther)

The following is information on Xcode Tools 1.2 for Mac OS X v10.3 (Panther).

What's New

• Xcode 1.2 is the latest version of Apple's new Integrated Development Environment. It has the following enhancements over Xcode 1.0 and Xcode 1.1:

- Improved stability and user experience - Enhanced build system, better dependency analysis, improved cross-project reference support, and improved native target support for yacc and assembler.

After installation, Release Notes containing detailed information on changes can be found in /Developer/Documentation/ReleaseNotes You can access the release notes from Xcode’s Help menu using the Show Release Notes menu item.

• CHUD 3.5: The Computer Hardware Understanding Developer Tools (CHUD Tools) are a set of applications and tools for measuring and optimizing software performance on Mac OS X, as well as for hardware bring-up and system benchmarking. They are an optional installation, selected during the install process using the "Customize" button. Xcode Tools v1.2 includes CHUD v3.50. For more information, see http://developer.apple.com/tools/performance/

• GCC 3.3, the Xcode Tools default compiler, has been updated. For more information about this version of the compiler, see /Developer/Documentation/ReleaseNotes/GCC3.html

• Documentation - This release contains a new navigation system for accessing documentation. All of the navigation pages have been redesigned and populated with documents according to a new categorization scheme. In addition, the HTML presentation of individual documents has changed to provide better access to content. This release includes documentation published on the Apple Developer Connection website as of February, 2004.

• Java Application Servers Development - The Java Application Servers Development Kit is not included as a custom install option with this release. This optional install includes the Ant, XDoclet-based and J2EE project templates, and JBoss. If you are upgrading an existing Xcode Tools conﬁguration which includes these components, they will be left in place. An updated installer for these components is available as a separate item from the Apple Developer Connection download site http://connect.apple.com

For more information on new features, see the individual “What’s New” documents for summaries of each area.

Known Issues in this Release • The Darwin full-text index does not include the Kernel and IOKit reference documentation. This documentation is still accessible through Xcode's API search, but will not appear in full-text searches. If you wish to correct this problem you should reindex the content, including the reference content. Please do the following, logged in as an admin user:

- Launch /Developer/Documentation/Apple Help/Apple Help Indexing Tool - In the application's preferences, ensure that Index anchor information in all ﬁles is checked, and that the English tokenzier with stemmer is selected. - Drag the /Developer/Documentation/Darwin folder onto the Apple Help Indexing Tool

• The Xcode Tools 1.2 release includes an incremental update to the gcc 3.3 compiler. Because this update alters the minor version of the compiler, the PCH ﬁles generated from previous versions of the gcc 3.3 compiler will be invalid for use with the updated compiler. When using native targets, Xcode will normally rebuild these PCH ﬁles for you.

However, when working with jam-based targets that have been upgraded to the Xcode native format, an error may be encountered when building for the first time using the updated compiler, stating "one or more PCH files were found, but they were invalid". The "clean" command in Xcode for a target (jam-based or native) will now remove all precompiled headers (.gch) that might be built by that target, even if they are shared with other targets. Simply cleaning and rebuilding the target will remove the older PCH file, and the error.

• When editing the Perforce settings (in the inspector for the project), hitting the Enter or Return key to save the settings from the provided sheet will cause Xcode to crash. Instead of using the Enter or Return key, clicking the "Ok" button with the mouse will correctly save the settings.

• When using predictive compilation, it is possible to crash Xcode if the document is closed before the background predictive compilation is complete. (This is most notable when a larger source ﬁle is very quickly opened, modiﬁed, saved, and then closed.) This can be avoided by simply delaying the close of the document until the compilation has completed.

• The gcc-3.1 compiler has not been updated in this release.

• Xcode 1.2 and Java Project Templates: Installation of Xcode 1.2 overwrites the Java 1.4.2 Xcode Project Templates (Java AWT Applet, Java AWT Application, Java JNI Application, etc.) with the Java 1.4.1 versions. If you are developing with Xcode 1.2 and Java 1.4.2, you should reinstall the Java 1.4.2 Developer package available on Apple Developer Connection (http://connect.apple.com) in the Download Software -> Java section.

Bug Reports and Feedback

• When submitting bug reports, please include the key phrase "XcT7K249:" in the bug title and description. This information is extremely helpful to our team of engineers, it will help prevent delays in assessing your bug report and assigning it properly.

• For complete instructions on submitting bug reports, please see the following web page: http://developer.apple.com/bugreporter

• You can also send feedback and questions to using the [email protected] email address. It is best if you ﬁrst submit a bug report and then include the bug number in your email. If the question is speciﬁc to this release, be sure to include the key phrase "XcT7K249:" in the subject line.

• WHEN SUPPLYING FEEDBACK: Please be sure to include an ASP (Apple System Proﬁler) report along with a crash log for all crashing bugs. Kernel panic reports are also very important. If the panic is occurring during installation, we ask that you please record the backtrace with all the hex numbers and forward this information with your bug report. Please do your best to describe any sequence of operations which leads to a repeatable incorrect behavior, and include example source and project ﬁles whenever possible that can demonstrate the issue.

• TO GENERATE A CRASH LOG: Launch Console, go to Preferences and mark the checkboxes under the Crash tab.

Compatibility

• Xcode Tools 1.2 Build 7K249 project files are fully compatible with all Xcode 1.0.x and 1.1.x project files. You should review your target configuration to be certain that all your settings are correct after opening with Build 7K249.

Installation and Removal

• This software release consists of one install disk image ﬁle. You can run the install directly from the disk image when mounted. It requires an administrator password.

IMPORTANT: • Please note that this release version is a full update of the Xcode development tools suite. It requires Mac OS X v10.3.x to install, and can be installed directly over an Xcode Tools 1.0.x and 1.1 installation.

• Xcode Tools 1.2 Build 7K249 installs Xcode IDE 309.0, Xcode Core 310.0 and ToolSupport 307.0, reported in the About Xcode info box. It installs gcc version 3.3 build 1640 and gdb-309.

• To uninstall this release and return to the prior version of Xcode, you need to use the uninstall-devtools.pl script located in /Developer/Tools. Run the script from a Terminal window with the command: sudo perl /Developer/Tools/uninstall-devtools.pl

The sudo command will ask for an administrator password. Using this script removes all developer tools and allows you to reinstall the Xcode tools from your prior release Xcode Tools distribution CD or disk image.

• Please check the included release notes and Xcode Help for more information.

Thank you for your support, Apple Developer Connection