core/com.nokia.carbide.cpp.doc.user/html/projects/launch/emulation.htm
author dan.podwall@nokia.com
Mon, 06 Apr 2009 14:56:28 -0500
changeset 56 887bd61e1328
parent 2 d760517a8095
child 400 9b005a8e6778
permissions -rw-r--r--
merge from RCL_2_0 to default

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Emulator Launch Configuration</title>
<link href="../../../book.css" rel="stylesheet" type="text/css">
</head>

<body>
<h2>Emulator Launch Configuration</h2>
<p>Select the <b>Symbian OS Emulator</b> launch configuration  to run or debug executables using an emulator.  </p>
<p>If  the <a href="wiz_new_launch_config.htm">New Launch Configuration Wizard</a> was used to create a emulator launch configuration no changes are usually needed. To modify the  launch configuration settings, select the <b>Run &gt; Open Debug Dialog...</b> menu option to open the <b>Debug</b> dialog. Select the Symbian OS Emulation launch configuration and click a tab to set specific options. Click <b>Apply</b> to save any option modifications. Click <b>Debug</b> to launch a debugging session using the new settings.</p>
<p align="center"><img src="../images/wnd_debug_emulation_launch_config.png" width="658" height="403"></p>
<p class="figure">Figure 1 - Emulator  launch configuration in Debug dialog </p>
<p>The <b>Debug</b>  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: </p>
<ul>
  <li>The <a href="page_main.htm">Main</a> 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. </li>
  <li>The <a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_arg.htm">Arguments</a> tab (<i>standard CDT page</i>) 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. </li>
  <li>The <a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_env.htm">Environment</a> tab (<i>standard CDT page</i>) 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. </li>
  <li>The <a href="page_debugger.htm">Debugger</a> tab provides common debugger options for the project.</li>
  <li>The <a href="page_executables.htm">Executables</a> tab allows you to specify which executables are debugged by your project.</li>
  <li>The <a href="page_exceptions.htm">x86 Exceptions</a> tab  lists all the x86 exceptions that the debugger can catch.</li>
  <li>The <a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_srce.htm">Source</a> tab (<i>standard CDT page</i>) 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. </li>
  <li>The <a href="PLUGINS_ROOT/org.eclipse.cdt.doc.user/reference/cdt_u_run_dbg_comm.htm">Common</a> tab (<i>standard CDT page</i>) 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. </li>
</ul>
<h4>Other references</h4>
<ul>
  <li><a href="launch_configs_overview.htm">Launch Configuration Overview</a></li>
</ul>
<div id="footer">Copyright &copy; 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
</body>
</html>