# Building and running example applications from Carbide.c++

The SDK support of Carbide.c++ allows you to build S60 applications and run them in the emulator directly from the IDE. Building and running an example application for the emulator from Carbide.c++ consists of the following steps:

- importing an example application to the IDE

- creating a WINSCW build of the example application

- running the example application in the emulator

Note: Carbide.c++ does not perform actions described in the bld.inf file. For instance exports and additional makefiles are ignored. Almost all example applications are affected by this problem. Thus, it is recommended to build example applications first on command line and import these into the IDE only after a successful command line build (see Building and Running Example Applications from the Command Line).

### Importing an example application to Carbide.c++

The Import Project wizard of Carbide.c++ allows you to import Symbian OS projects into the IDE. With the wizard you can import both component description file (`bld.inf`) and project definition file (`.mmp`) based projects.

To import an example application (in this case Hello World Basic) to Carbide.c++, do the following:

1. Select File > Import.. from the menu bar.

2. In the Import dialog, select "Symbian MMP File" and click Next.

3. In the MMP File field, browse to the `.mmp` file (located in the `group` folder) of the example application that you want to import.

   For example:

   `<S60_SDK_installation_directory>\S60CppExamples\HelloWorldBasic\group\helloworldbasic.mmp`

4. In the SDKs and Build Configurations list, under "All SDKs" select "Nokia Symbian^3" and "Emulator Debug(WINSCW)[S60_5th_Edition_SDK_V1.0]".

5. Click Finish.

The wizard will now create import the project and display it in the C/C++ Projects view, from where it can be built.

For more information on importing and creating project in Carbide.c++, please refer to the following topic in the Carbide.c++ Help:

- Carbide.c++ User Guide > Symbian OS Projects > Tasks > Projects > Importing Projects

### Creating a WINSCW build of an example application with Carbide.c++

In order to be able to view an aplication in the SDK emulator, you need to create a WINSCW build of it:

1. Select Project > Properties from the menu bar.

   The Properties dialog opens. Here you can manage the build process by defining all aspects of the build by entering the needed information.

2. Click C/C++ Build in the dialog TOC.

3. Select "S60 3.0 Emulator Debug" from the Configuration drop-down menu.

4. Click OK.

5. Select Project > Build Project from the menu bar.

Carbide.c++ creates a build of your project according to the current configuration determined in the Properties dialog - in this case, a WINSCW build.

For more information on building a project, please refer to the following topics in the Carbide.c++ Help:

- Carbide.c++ User Guide > Getting Started > First Application Example > 5. Building a Symbian OS Executable

  C/C++ Development User Guide > Tasks > Building projects

### Running an example application in the emulator from Carbide.c++

Once you have created a GCCE build of your project, you can run it on the S60 emulator.

1. Select Run > Run... from the menu bar.

   The Run dialog opens. The Run dialog allows you to define the launch configuration of the build.

2. Select the GCCE build from the Configurations list of the dialog.

3. Define and/or accept the values in the fields (above all, make sure that the Executable and Emulator or host application paths are correct).

4. Click the Apply button.

5. Click the Run button.

The application is launched in the emulator (see step 2 onwards in Launch the application in the emulator for a description of the Hello World Basic example application).

For more information on running projects and applications through Carbide.c++, please refer to the following topics in the Carbide.c++ Help:

- Carbide.c++ User Guide > Getting Started > First Application Example > 3. Building a Symbian OS Executable

- C/C++ Development User Guide > Tasks > First Application Example > Running and debugging projects