## Emulator Launch Configuration

Select the Symbian OS Emulator launch configuration to run or debug executables using an emulator.

If the New Launch Configuration Wizard was used to create a emulator launch configuration no changes are usually needed. To modify the launch configuration settings, select the Run > Open Debug Dialog... menu option to open the Debug dialog. Select the Symbian OS Emulation launch configuration and click a tab to set specific options. Click Apply to save any option modifications. Click Debug to launch a debugging session using the new settings.

Figure 1 - Emulator launch configuration in Debug dialog

The Debug window provides C/C++ emulator debug options when a Symbian OS Emulation launch configuration is created. The settings included in the Symbian OS Emulation launch configuration are a combination of Carbide, CDT, and Eclipse options. The tabs in the window include:

- The Main tab defines the project to be launched. Enter the name of the project containing the class to launch in the project field, and the executable name in the the Executable field and the emulator or host application in the Emulator or host application field.
- The Arguments tab (standard CDT page) defines the arguments to be passed to the application and to the virtual machine (if any). You can also specify the working directory to be used by the launched application.
- The Environment tab (standard CDT page) defines the environment variable values to use when running or debugging a program. By default, the environment is inherited from the Eclipse runtime. You may override or append to the inherited environment.
- The Debugger tab provides common debugger options for the project.
- The Executables tab allows you to specify which executables are debugged by your project.
- The x86 Exceptions tab lists all the x86 exceptions that the debugger can catch.
- The Source tab (standard CDT page) defines the location of source files used to display source when debugging an application. By default, these settings are derived from the associated project's build path. You may override these settings here.
- The Common tab (standard CDT page) defines general information about the launch configuration. You may choose to store the launch configuration in a specific file and specify which perspectives become active when the launch configuration is launched.

#### Other references

- Launch Configuration Overview