---

Introduction to Porting CodeWarrior Projects to Xcode

This document describes how to move Mac OS software projects from CodeWarrior to Xcode, the Apple integrated development environment. It lists similarities and differences between the two environments, describes how to import a CodeWarrior project into Xcode, and provides detailed information on many conversion issues.

The Xcode application is part of the developer tools distributed with Mac OS X version 10.3 and later. It provides a powerful user interface to many industry-standard and open-source tools, including GCC, javac, jikes, and GDB. Xcode contains templates for creating applications, frameworks, libraries, plug-ins, Java applications and applets, and command-line tools. Xcode supports both Cocoa and Carbon development, using C, C++, Objective-C, and Java.

Although this document generally describes how to convert CodeWarrior projects that build applications, much of the information can be applied to projects that build plug-ins, bundles, frameworks, and other kinds of software.

CodeWarrior descriptions and examples in this document are based on CodeWarrior Pro version 8.3 for Macintosh.

Contents:

Prerequisites
Further Reading
Organization of This Document
Feedback and Mail List

Prerequisites

This document is intended for CodeWarrior users, and assumes that you have some familiarity with the Mac OS, including Mac OS X.

• For detailed information on the development tools available with Xcode, see Mac OS X Developer Tools in Mac OS X Technology Overview.

  Among other new and revised documents, the Tools Documentation includes updated GCC documentation: GNU C/C++/Objective-C 4.0.1 Compiler User Guide and GNU C 4.0 Preprocessor User Guide.

• For introductory information on Mac OS X, see Mac OS X Technology Overview .

The primary documentation for performing operations with Xcode is Xcode 2.2 User Guide.

Further Reading

The following documents provide information on moving other kinds of software to Mac OS X.

• UNIX or Linux software

  • Porting UNIX/Linux Applications to Mac OS X.

  • Technical Note 2071: Porting Command Line UNIX Tools to Mac OS X

• Windows software

  • Porting to Mac OS X from Windows Win32 API

You can find additional information about porting code to Mac OS X in the Porting Documentation area.

Organization of This Document

This document contains the following:

• This Introduction describes the audience for the document and summarizes the contents.

• “Xcode From a CodeWarrior Perspective ” describes similarities and differences in key features of Xcode and CodeWarrior. It also describes how to use certain Xcode features.

• “Preparing a CodeWarrior Project for Importing” describes steps you can take to modify your CodeWarrior project before importing it into Xcode.

• “Importing a CodeWarrior Project Into Xcode” provides a brief walk-through of importing a CodeWarrior project.

• “After Importing a Project” describes steps you may need to take to successfully build an imported CodeWarrior project in Xcode.

• “Using PowerPlant in Universal Binaries” describes modification you may need to make to build universal binaries that use PowerPlant.

• “Where to Go From Here” points to some tools and performance documents you’ll want to consider as you work on your Mac OS X software.

Feedback and Mail List

You can get quick answers to your day-to-day Xcode questions by sending email to xcode-users@lists.apple.com. You can become a member of this list at Apple Mailing Lists.

Your feedback and suggestions for Xcode are welcome. For feedback on this document, use the link at the bottom of each page. To request a feature or report a bug in Xcode, use the Apple Bug Reporter.

To report bugs or to receive the bi-weekly Apple Developer Connection News email newsletter, you must be a member of Apple Developer Connection (ADC). You can sign up for a free ADC Online membership.

---