<?xml version="1.0" encoding="utf-8"?>

<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

<!-- This component and the accompanying materials are made available under the terms of the License 

"Eclipse Public License v1.0" which accompanies this distribution, 

and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

<!-- Initial Contributors:

    Nokia Corporation - initial contribution.

Contributors: 

-->

<!DOCTYPE concept

  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

<concept id="GUID-FCE138BF-A471-5864-AE4C-8D89EF5F2BB9" xml:lang="en"><title>Symbian

Emulator target using Metrowerks CodeWarrior</title><prolog><metadata><keywords/></metadata></prolog><conbody>

<p>This page describes how to build for the Symbian emulator using the Metrowerks

CodeWarrior compiler. The Symbian emulator is also known as the WINSCW build

target. </p>

<section><title>Building from the command line</title> <p>To build for WINSCW,

with <filepath>abld</filepath> use: </p> <p><userinput>bldmake bldfiles</userinput> </p> <p><userinput>abld

build winscw [udeb | urel]</userinput> </p> <p>Binaries are generated in the <filepath>udeb</filepath> and/or <filepath>urel</filepath> sub-directories

of the <filepath>epoc32\release\winscw\</filepath> directory. </p> </section>

<section><title>Building from the CodeWarrior IDE</title> <p>You can build

applications for a WINSCW Symbian emulator using the CodeWarrior compiler

from the CodeWarrior IDE. You can also build for ARM targets from the IDE:

this invokes the native toolchain, rather than CodeWarrior's own compiler. </p> <p>The

simplest way to use CodeWarrior, is, after defining a <filepath>bld.inf</filepath> file

and a <filepath>.mmp</filepath> file, choose the <systemoutput>File      

    | Import project from .mmp file</systemoutput> command. CodeWarrior then

reads the <filepath>.mmp</filepath> file that you select, and generates and

opens a CodeWarrior project. You can then use the normal CodeWarrior commands

to run, build, and debug the project. </p> <p>If later you change the <filepath>.mmp</filepath> file,

you can use the same commands to regenerate the IDE workspace. Changes you

make to the project made through the IDE, such as adding a source file, are

not automatically written to the <filepath>.mmp</filepath> file, but it is

good practice to manually keep the <filepath>.mmp</filepath> file up to date

with any changes made. </p> <p>The IDE project files have special build steps

which invoke the resource compiler, so for projects that use resources, this

does not need to be run separately. </p><p><b>Alternative method </b> </p> <p>A

slightly longer method is available that creates a CodeWarrior IDE project

from the command line. To do this, run <codeph>bldmake bldfiles</codeph> as

described, and then, to generate a CodeWarrior IDE project, use: </p> <p><userinput>abld

makefile CW_IDE</userinput> </p> <p>This creates an importable project file <varname>project-name</varname> <filepath>.xml</filepath> in

the directory <filepath>&lt;path&gt;\epoc32\build\</filepath> <varname>absolute_path_to_mmp_file</varname> <filepath>\</filepath> <varname>mmp_basename</varname> <filepath>\winscw\</filepath>. </p> <p>You can now tell CodeWarrior to read

this file and from it generate a project file of its own native type (an <filepath>.mcp</filepath> file).

Start CodeWarrior, choose the <systemoutput>File | Import Project...</systemoutput> command,

select the <filepath>HelloWorld.xml</filepath> file, and choose a name for

the CodeWarrior project (such as <filepath>HelloWorld</filepath> again). CodeWarrior

will now generate and load the project, which you can build, run, debug, etc.

using the normal IDE commands. </p> </section>