core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/new_proj_from_template_01.htm
author fturovic <frank.turovich@nokia.com>
Tue, 13 Jul 2010 13:38:18 -0500
changeset 1610 5e244b89116e
child 1617 94b6d1326534
permissions -rw-r--r--
revised Create New Project tutorial, updated images, TOC, and welcome link
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
1610
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
     1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
     2
<html>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
     3
<head>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
     4
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
     5
<meta http-equiv="Content-Style-Type" content="text/css" />
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
     6
<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
     7
<title>Creating New Projects from Templates</title>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
     8
<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
     9
</head>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    10
<body bgcolor="#FFFFFF">
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    11
<h2>Creating New Projects from Templates</h2>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    12
<p>In this example we show how to create a new project using one of the built-in Carbide templates, how to build it into an executable, and how to launch the debugger to verify program accuracy. The steps to do this include:</p>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    13
<ol>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    14
    <li><strong>Creating a project from a project template</strong></li>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    15
    <li><a href="new_proj_from_template_02.htm">Building</a> an executable based on the project sources</li>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    16
    <li><a href="new_proj_from_template_03.htm">Defining</a> a launch configuration for running or debugging the application</li>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    17
    <li><a href="new_proj_from_template_04.htm">Controlling and debugging</a> the running program using  the Carbide debugger</li>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    18
</ol>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    19
<hr>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    20
<p>Everything starts with a project. So the first step is to use the <strong>New Project</strong> wizard to create  a project based on a known template. Program templates are designed to make creating common project types fast and simple. They include the basic sources, resources, includes, and build files that Carbide uses to manage your project. </p>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    21
<div class="step">
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    22
    <h4><strong></strong>Creating projects from a template</h4>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    23
    <ol>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
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 />
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
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>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    26
            <p><img src="../images/new_project_template_01.png" alt="New Symbian OS C++ Project window" width="525" height="503"></p>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    27
        </li>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    28
        <li>Select a template from the available, then click <strong>Next</strong>.<br />
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
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>S60 > GUI Application</strong> template. Note that as you select a template a brief description appears below the list explaining it attributes.</p>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    30
        </li>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
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 />
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    32
        	<p><img src="../images/new_project_template_02.png" width="525" height="503"></p>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    33
            <ol type="a">
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    34
                <li>Type a name into the <strong>Project name</strong> text box.<br />
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
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>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    36
                </li>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    37
                <li>(Optional) Change the project location.<br />
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
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>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    39
                </li>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    40
                <li>Select the <strong>Builder</strong> type.<br />
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
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>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    42
                </li>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    43
                <li>Click <strong>Next</strong>.</li>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    44
            </ol>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    45
        </li>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
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 />
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
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>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    48
        </li>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    49
        <li>(Optional) Click Next to provide Basic Settings like author, copyright and other info for your project.</li>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    50
        <li>(Optional) Click Next to rename the Project Directories used to organize the project.</li>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    51
        <li>Click Finish.<br>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    52
            <p>Carbide uses the selected project template and your settings to create a new project in the <a href="../../reference/view_cpp_projects.htm">Project Explorer</a> view.</p>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    53
        </li>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    54
    </ol>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    55
</div>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    56
<strong>NEXT STEP</strong> &gt; <a href="new_proj_from_template_02.htm">Building</a> an executable based on the project sources
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    57
<h4>Other references</h4>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    58
<ul>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    59
    <li><a href="./">Creating New Projects Tutorial</a></li>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    60
</ul>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    61
<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>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    62
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    63
</body>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    64
</html>