# 1.

Introduction

This manual describes the CodeWarrior Integrated Development Environment (IDE) for the BeOS in detail. The IDE is used to develop code for various operating systems, using various programming languages.

## Introduction

This section introduces the CodeWarrior IDE. The other topics in this chapter are:

- `Read the Release Notes!`
- `IDE User Guide Overview`
- `About the CodeWarrior IDE`
- `Where to Go From Here`

The IDE is a collection of development tools for creating and generating code for the systems listed in Table 1.1.

#### Table 1.1 CodeWarrior IDE platforms

Target | Description
--- | ---
68K Macintosh | Any Mac OS computer that uses the Motorola 68000 family of microprocessors
Power Macintosh | Any Mac OS that uses a PowerPC microprocessor
Win32/x86 | The Win32 model for Windows NT4 and Windows 95 on Intel 80x86 processors
Java | The Java virtual machine
BeOS | The Be operating system
PlayStation | The PlayStation game console
PowerTV OS | The PowerTV digital set-top box operating system
PalmPilot OS | The operating system for the Pilot connected organizer

### NOTE:

Your version of CodeWarrior does not contain compilers for all possible targets listed in Table 1.1. Check your product description for targets available to you.

You use the same IDE when developing code for all these systems. You add new compilers and linkers by dragging specially-designed plug-ins into your CodeWarrior Plugins folder. The Plugins folder contains separate subdirectories for Compilers, Linkers, Post Linkers and Preference Panels.

You can develop applications using these languages:

- C and C++ , a compiler that implements templates, exception handling, run-time type information (RTTI), and inline assembly code.
- Java, for Java virtual machines.

### NOTE:

Some languages (such as Java) can only be used for certain targets.

## Read the Release Notes!

By now, you probably have read the CodeWarrior release notes. If you haven't, please do so. They contain important information about new features, bug fixes, and incompatibilities that may not have made it into the documentation due to release deadlines. You can find them on both CodeWarrior CDs, in the Release Notes folder.

## IDE User Guide Overview

There are several chapters in this User Guide. Each chapter begins with an overview of the topics discussed in that chapter. The chapter overviews are:

- `Introduction` - (this chapter) contains an overview of the CodeWarrior IDE languages, platforms, and documentation
- `Getting Started`- system requirements, installation, QuickStart steps
- `Working with Projects`- introduces the CodeWarrior project manager, shows how to setup, configure, and work with projects
- `Working with Files`- introduces the concepts behind working with files in CodeWarrior
- `Editing Source Code`- explains how to use the CodeWarrior text editor
- `Searching and Replacing Text`- explains how to use the CodeWarrior facilities to search and replace text in files
- `Configuring IDE Options`- discusses the many options available in CodeWarrior's Preferences and Project Settings dialogs
- `Compiling and Linking`- discusses how to control compilation, linking, and running a CodeWarrior project
- `IDE Menu Reference`- describes each command in each CodeWarrior IDE menu

## About the CodeWarrior IDE

The CodeWarrior IDE is a collection of tools that allow you to develop computer code for many different platforms using different programming languages. Using the IDE, you can develop a program, plug-in, library, or other executable code to run on a computer system.

The CodeWarrior IDE permits a code developer to quickly assemble a variety of source code files (for example, a file written in the C++ computer language), resource files, and library files into a project, without writing a complicated build script (or "Makefile") for the project. Source code files may be added or deleted from the IDE's project using simple mouse and keyboard operations instead of editing a build script. Tools such as a debugger, compilers, linkers, and source code editor are included with CodeWarrior. These tools allow you to edit your code, navigate your code, compile it, link it, and debug it until you have a running application. Options for code generation, debugging, and navigation of your project are all configurable in the IDE.

The CodeWarrior product comes with everything you need to develop code!

## Where to Go From Here

There are a few different options for where to start reading more about developing with CodeWarrior.

When you are ready to debug, be sure to read the Debugger manual on the CodeWarrior CD.

When you are trying to get started quickly with a new platform or if you are new to CodeWarrior, see `"QuickStart and Tutorial Resources."`

### QuickStart and Tutorial Resources

You will find all the manuals mentioned in this section in the `CodeWarrior Documentation` folder on the CodeWarrior CD. For some products this will be on the CodeWarrior Reference CD.

If you are new to CodeWarrior check out these resources:

- The CodeWarrior QuickStart Guide for an overview of CodeWarrior, descriptions of some CodeWarrior windows and shortcuts, pointers to the references available to you, and instructions for using the viewers Metrowerks provides for on-line information. Quick Start is is on your CD, so you can use it regardless of whether you purchased any printed documentation.
- `"CodeWarrior IDE Guided Tour"` provides a quick overview of the CodeWarrior user interface.
- The CW Tutorials Code folder on the CodeWarrior CD contains some sample projects for many platforms that will help you become productive quickly with CodeWarrior.

Visit the Metrowerks website at: http://www.metrowerks.com
For assistance contact Metrowerks Technical Support at: support@metrowerks.com
Copyright © 1998, Metrowerks Corp. All rights reserved.
Last updated: February 15, 1998
* Chris Magnuson * John Roseborough