Mercurial Mercurial > oss > FCL > sftools > dev > ide > carbidecpp / annotate
summary | shortlog | changelog | graph | tags | bookmarks | branches | files | changeset | file | latest | revisions | annotate | diff | comparison | raw | help
Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/new_proj_dll_example_01.htm
author fturovic <frank.turovich@nokia.com>
Tue, 31 Aug 2010 22:58:09 -0500
changeset 1934 4f0cd256d26c
parent 1893 e29df1745269
child 1996 22b525c1e359
permissions -rw-r--r--
BUG 11531 - fixed reported issues from Rooney and Stephen for SDK section
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
1617
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
     1
 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
     2
 
<html>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
     3
 
<head>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
     4
 
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
     5
 
<meta http-equiv="Content-Style-Type" content="text/css" />
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
     6
 
<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
     7
 
<title>Creating DLL Projects Tutorial</title>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
     8
 
<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
     9
 
</head>
1791
727385d8e2b3 added new customize carbide section and some relinking done for deleted duplicate page
fturovic <frank.turovich@nokia.com>
parents: 1658
diff changeset 
    10
 
<body >
1617
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    11
 
<h2>Creating DLL Projects Tutorial</h2>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    12
 
<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>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    13
 
<ol>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    14
 
    <li><strong>Creating a DLL project from a project template</strong></li>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    15
 
    <li><a href="new_proj_dll_example_02.htm">Building</a> the DLL object code based on the project sources</li>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    16
 
    <li><a href="new_proj_dll_example_03.htm">Debugging</a> the DLL using  the Carbide debugger</li>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    17
 
    </ol>
1934
4f0cd256d26c BUG 11531 - fixed reported issues from Rooney and Stephen for SDK section
fturovic <frank.turovich@nokia.com>
parents: 1893
diff changeset 
    18
 
<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>
1617
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    19
 
<hr>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    20
 
<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>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    21
 
<div class="step">
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    22
 
    <h4><strong></strong>Creating a DLL project from a template</h4>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    23
 
    <ol>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    24
 
        <li>Click the <strong>File &gt; New &gt; Symbian OS C++ Project</strong> menu option.<br />
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    25
 
                <p>The <strong>New Symbian OS C++ Project</strong> window appears to guide you through project creation process.</p>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    26
 
            <p><img src="../images/new_dll_project_02.png" alt="New DLL project" width="525" height="503"></p>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    27
 
        </li>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    28
 
        <li>Select a template from the available options, then click <strong>Next</strong>.<br />
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    29
 
                <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>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    30
 
        </li>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    31
 
        <li>Use the <strong>New Symbian OS C++ Project</strong> page to define the project name and build system.<br />
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    32
 
                <p><img src="../images/new_dll_project_03.png" alt="New Symbian OS C++ Project page" width="525" height="503"></p>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    33
 
            <ol type="a">
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    34
 
                    <li>Type a name into the <strong>Project name</strong> text box.<br />
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    35
 
                            <p>The project name is used to define several of the pre-build source files in the prject.</p>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    36
 
                    </li>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    37
 
                <li>(Optional) Change the project location.<br />
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    38
 
                            <p>Uncheck the <strong>Use default location</strong> option to specify a different location for the project.</p>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    39
 
                </li>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    40
 
                <li>Select the <strong>Builder</strong> type.<br />
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    41
 
                            <p>Based on the installed SDKs you can choose between SBSv2 (recommended) and the older SBSv1 build systems.</p>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    42
 
                </li>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    43
 
                <li>Click <strong>Next</strong>.</li>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    44
 
            </ol>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    45
 
        </li>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    46
 
        <li>In the Symbian OS SDKs page, select the SDK and build configurations for the project.<br />
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    47
 
            <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>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    48
 
        	<p><img src="../images/new_dll_project_04.png" alt="Symbian OS SDKs page"></p>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    49
 
        </li>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    50
 
        <li>(Optional) Click Next to provide Basic Settings like author, copyright and other info for your project.</li>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    51
 
        <li>(Optional) Click Next to rename the Project Directories used to organize the project.</li>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    52
 
        <li>Click Finish.<br>
1658
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1645
diff changeset 
    53
 
            <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>
1617
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    54
 
            <p><img src="../images/new_dll_project_07.png" alt="DLL project in Project Explorer view"></p>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    55
 
        </li>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    56
 
    </ol>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    57
 
</div>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    58
 
<p><strong>NEXT STEP</strong> &gt; <a href="new_proj_from_template_02.htm">Building</a> the object code based on the project sources </p>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    59
 
<h4>Other references</h4>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    60
 
<ul>
1645
0083290c145a minor edits to sync titles across tutorials
fturovic <frank.turovich@nokia.com>
parents: 1617
diff changeset 
    61
 
    <li><a href="new_proj_dll_example_00.htm">DLL Projects</a></li>
1617
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    62
 
</ul>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    63
 
<div id="footer">Copyright &copy; 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>
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    64
 












94b6d1326534
revised dll example with new images, TOC, and welcome page



fturovic <frank.turovich@nokia.com>


parents: 

diff
changeset




    65


</body>













94b6d1326534
revised dll example with new images, TOC, and welcome page



fturovic <frank.turovich@nokia.com>


parents: 

diff
changeset




    66


</html>














FCL/sftools/dev/ide/carbidecpp