CodeWarrior Pro 2 Installation Instructions for Mac OS

Revision History:

Written for CodeWarrior Pro 1 (Macintosh) by Brad Pliner - Sept. 1997.
Adapted for HTML, upgraded for CodeWarrior Pro 2 (Macintosh and Windows) by
JL Popyack - Jan. 1998.

There are many options available for installation. This document will explain them, so you don't fill up your hard drive with unnecessary files. Use the installation program to mark the check boxes for the items you wish to install. Remember, you can always install additional options later.


Metrowerks CodeWarrior?

Metrowerks is the company, CodeWarrior is the product.
Just like "Microsoft Excel" - Microsoft is the company, "Excel" is the product.


What is it?

CodeWarrior is an integrated development environment (IDE). This means that it takes care of everything for you. All you have to do is program. The IDE is a text editor, preprocessor, compiler, assembler, disassembler, and debugger all in one integrated package. CodeWarrior supports many programming languages (C, C++, Pascal, Java) for many platforms (Macintosh, Windows 95/NT, and Java; Be, Sony, Magic Cap, and other platforms are also available.)


Host Platform vs Target Platform

The host platform is the computer you are using to do your development. The target platform is the platform for which your software will run. Your target platform does not need to be the same as your host platform. For example, you can write Windows software from your Macintosh (or vice versa), of course you won't be able to run the software. In CodeWarrior Pro a single project can contain multiple targets. That way, you can easily maintain a single project that will result in a Windows and Macintosh version of your program.


PPC or 68K? Win/x86? Java?

The Macintosh has used two families of processors. The Motorola 680x0 (68K) series processor was the first to be used in the Macintosh (68000, 68020, 68030, and finally the 68040). Now all Macs have the PowerPC (PPC) processor. (601, 603, 604, 603e, 604e). The PowerPC processor was codeveloped by IBM, Apple, and Motorola.

Several options will distinguish between 68K and PPC. We suggest using the choice relevant to your computer. Keep in mind that if you write a PPC program, it will not work on a friend's 68K Mac. However, a 68K program will run on all 68K and PPC Macs, although a 68K program on a PPC Mac would run a bit slower than a PPC version would.

As stated above, you can also write Windows 95/NT software on your Macintosh. You probably shouldn't bother to install these libraries. You can always install them later.

The programs you write in Computer Programming I or II will use standard libraries that are available on Mac OS or Windows. So any programs you write for this class would easily be recompiled for Windows or Macintosh.

CodeWarrior also includes Java compilers. Java programs will run on any platform that has a Java runtime engine. The Java applications (or applets) must be written in the Java programming language, which we won't go over in this class. Unless you plan on developing Java software, you can always install this option later. Java is not used in Computer Programming I or II.


Using the Installer

Insert the Mac OS Tools CD, and double click the "CWPro 2 Tools Installer" program.
The information button gives you a description for a particular option.
Clicking the triangle will give you more options.
After all your options have been selected, press the Install button.


The Options

You can always add additional options later. However, if you are a serious Mac developer, or if you have a large hard drive, install "MacOS Heaven". But that will take a lot of hard drive space. Otherwise here are the options you need from the Mac OS Tools CD. Items that are not mentioned are not needed. If you want Java support, don't worry about the individual options, just select "Java Heaven."

The amount of space required for the options you have selected and the amount of space available on your hard drive will be displayed in the dialog box as you select items.

* If you have a 68K Mac, install the 68K libraries instead. If you plan on publicly releasing software for the Mac OS, you will want to release a 68K and PPC version of your program. See the Targeting Mac OS documentation, for information on creating a "FAT" program.



Metrowerks releases complete updates to the CD's you purchased 2 times a year. Be sure to send in your registration card, to be eligible to receive one free update. Additionally, minor updates are posted to the Metrowerks web page at You will need to install "Tools for Netborne Patches" to use most of these upgrades.

As of this writing, CodeWarrior Pro 2 is the current version. There is usually an update at Metrowerks' web site that contains updates and patches, for both Mac OS and Windows. Such updates should be installed after you install CodeWarrior from the CD.


The CodeWarrior Reference CD

If you had a printed version of all the books on this CD, you would have needed a small truck to take them home from the book store. This CD is a great resource; be sure to browse the CD to see what's available.

CodeWarrior documentation comes in various formats:

HTML - Any web browser will open these pages. Most of the HTML documentation is for Java.
PDF - Adobe Acrobat files. Adobe Reader is on the CD, but a newer version is at
eDoc - These documents are self-contained, and need no viewer. However, we recommend the PDF alternatives.
QuickView - Excellent hypertext database for looking up information
Apple DocViewer - Apple's official format for releasing books on CD's. Hint: Set the view to 125%.

Recommended to install on your hard drive:

Install all the documentation viewers, so you're ready to view any documentation on the CD. These are in the "Documentation Viewers" folder. Don't worry about MS Internet Explorer if you already have a web browser installed. Rather than installing Adobe Acrobat off the CD, get the latest version at

The QuickView documentation is in the folder "CW QuickView Reference" in the "CodeWarrior Documentation" folder. It is an extremely useful hypertext reference. Some of the files are compressed, so you'll need Stuffit Expander to open these files.

Do not bother with the documentation installer. Instead, browse the CD. If you see anything that you wish to install, copy it to your hard drive.


Recommended Reading:

You do not need to install all the documentation files. Instead, you can view the documentation right from the CD, or copy only the books you are currently reading to your hard drive. Reading a book from your hard drive may be a bit faster than reading it from the CD.

The "CodeWarrior Documentation" folder is where all the documentation resides. Check these out:

CW Core: CodeWarrior QuickStart.pdf

Required reading!

CW Core: IDE User Guide.pdf

How to use the IDE. Very important.

CW Core: Debugger Manual.pdf

How to use the debugger. Very important.

Mac OS: Targeting Mac OS.pdf

Understanding Mac compiler options.

Mac OS: Profiler Manual.pdf

How to use the Profiler (Mac only)

Win32: Targeting Win32.pdf

Understanding Win32 compiler options.

C and C++: MSL C Reference.pdf

A C reference. *

C and C++: MSL C++ Reference.pdf

A C++ reference. *

C and C++: C Compiler Guide.pdf

Understanding all the C/C++ compiler options.

* These are useful to have around, but we recommend the QuickView reference, mentioned above.

The "CodeWarrior Books" folder has some interesting books:

Principles of Programming: An intro to computer programming concepts
Leam C++ on the Mac: A tutorial on C++
Programming Starter Kit: How to create real Macintosh applications


Contacting Metrowerks directly for Technical Assistance:

If you have difficulties with your installation, you may find assistance at the Metrowerks web site ( You can receive technical support via email at


See Also:

CodeWarrior Pro Introduction (Macintosh Version)
CodeWarrior Pro Introduction (Windows Version)