core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/new_proj_dll_example_01.htm
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
<title>Creating DLL Projects Tutorial</title>
<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
</head>
<body >
<h2>Creating DLL Projects Tutorial</h2>
<p>In this example we show how to create a project for a DLL (Dynamically Linked Library) using one of the built-in Carbide templates, build it, then attach to another program for debugging. The steps to do this include:</p>
<ol>
<li><strong>Creating a DLL project from a project template</strong></li>
<li><a href="new_proj_dll_example_02.htm">Building</a> the DLL object code based on the project sources</li>
<li><a href="new_proj_dll_example_03.htm">Debugging</a> the DLL using the Carbide debugger</li>
</ol>
<p class="note"><b>NOTE</b> There must be at least one recognized SDK installed before you can create a project. See the <a href="../../reference/pref_carb_symbian_sdk.htm">Symbian SDKs</a>preference panel to determine if the installed SDKs are recognized by Carbide.c++ IDE. If the SDK you have installed is not recognized, you may still be able to <a href="../../sdks/sdk_add.htm">add</a> it to the Discovered Symbian OS SDK list.</p>
<hr>
<p>In this tutorial you'll create a simple DLL project using the <strong>New Symbian OS C++ Project</strong> wizard, attach it to the HelloWorld project created <a href="new_proj_from_template_00.htm">here</a>, then debug it.</p>
<div class="step">
<h4><strong></strong>Creating a DLL project from a template</h4>
<ol>
<li>Click the <strong>File > New > Symbian OS C++ Project</strong> menu option.<br />
<p>The <strong>New Symbian OS C++ Project</strong> window appears to guide you through project creation process.</p>
<p><img src="../images/new_dll_project_02.png" alt="New DLL project" width="525" height="503"></p>
</li>
<li>Select a template from the available options, then click <strong>Next</strong>.<br />
<p>Select the template for the type of project you want to create. For this example we chose the <strong>Generic Symbian OS > Baisc dynamically linked library (DLL)</strong> template. Note that as you select a template a brief description appears below the list explaining it attributes.</p>
</li>
<li>Use the <strong>New Symbian OS C++ Project</strong> page to define the project name and build system.<br />
<p><img src="../images/new_dll_project_03.png" alt="New Symbian OS C++ Project page" width="525" height="503"></p>
<ol type="a">
<li>Type a name into the <strong>Project name</strong> text box.<br />
<p>The project name is used to define several of the pre-build source files in the prject.</p>
</li>
<li>(Optional) Change the project location.<br />
<p>Uncheck the <strong>Use default location</strong> option to specify a different location for the project.</p>
</li>
<li>Select the <strong>Builder</strong> type.<br />
<p>Based on the installed SDKs you can choose between SBSv2 (recommended) and the older SBSv1 build systems.</p>
</li>
<li>Click <strong>Next</strong>.</li>
</ol>
</li>
<li>In the Symbian OS SDKs page, select the SDK and build configurations for the project.<br />
<p>Here you can select from any SDK that is both installed and recognized by Carbide. If the SDK supports several build configurations (GCCE, RVCT, etc.) then you can pick and choose among them for your project.</p>
<p><img src="../images/new_dll_project_04.png" alt="Symbian OS SDKs page"></p>
</li>
<li>(Optional) Click Next to provide Basic Settings like author, copyright and other info for your project.</li>
<li>(Optional) Click Next to rename the Project Directories used to organize the project.</li>
<li>Click Finish.<br>
<p>Carbide uses the selected project template and your settings to create the DLL project in the <a href="../../reference/view_proj_explorer.htm">Project Explorer</a> view.</p>
<p><img src="../images/new_dll_project_07.png" alt="DLL project in Project Explorer view"></p>
</li>
</ol>
</div>
<p><strong>NEXT STEP</strong> > <a href="new_proj_from_template_02.htm">Building</a> the object code based on the project sources </p>
<h4>Other references</h4>
<ul>
<li><a href="new_proj_dll_example_00.htm">DLL Projects</a></li>
</ul>
<div id="footer">Copyright © 2010 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>