|
0
|
1 |
|
|
|
2 |
<!DOCTYPE html
|
|
|
3 |
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
|
4 |
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"/><meta name="copyright" content="(C) Copyright 2007"/><meta name="DC.rights.owner" content="(C) Copyright 2007"/><meta name="DC.Type" content="mobileconcept"/><meta name="DC.Title" content="Building and running example applications from Carbide.c++"/><meta name="DC.Format" content="XHTML"/><meta name="DC.Identifier" content="GUID-E87DFE55-7AEA-48A3-9BC9-185BE0E147EA"/><title> S60 Example Applications</title><script type="text/javascript" src="js/utils.js">//</script><script type="text/javascript" src="js/gui.js">//</script><script type="text/javascript" src="js/common.js">//</script><script type="text/javascript" src="js/toc.js">//</script><script type="text/javascript" src="js/page.js">//</script><script type="text/javascript" src="js/s60/white_toc.js">//</script><script type="text/javascript" src="js/s60/page.js">//</script><link href="css/html.css" rel="stylesheet" type="text/css" media="screen"/><link href="css/style.css" rel="stylesheet" type="text/css" media="screen"/><link href="css/print.css" rel="stylesheet" type="text/css" media="print"/><link href="css/nwg.css" rel="stylesheet" type="text/css" media="all"/><link href="css/s60/white.css" rel="stylesheet" type="text/css" media="all"/><script>if( self == top ){ window.location.replace( "../../../?topic=/com.nokia.s60.sdk.cppapi_5.0/GUID-441D327D-D737-42A2-BCEA-FE89FBCA2F35/GUID-E87DFE55-7AEA-48A3-9BC9-185BE0E147EA.html");}</script>
|
|
|
5 |
</head><body onload="initPage();"><!--BEGIN: HEADER--><!--END: HEADER--><!--BEGIN: BODY SECTION--><div class="body"><!--begin: content--><div class="contentLeft prTxt"><h1 class="pageHeading" id="GUID-E87DFE55-7AEA-48A3-9BC9-185BE0E147EA"><a xmlns:d="http://www.pnp-software.com/XSLTdoc" name="GUID-E87DFE55-7AEA-48A3-9BC9-185BE0E147EA"><!----></a>Building
|
|
|
6 |
and running example applications from Carbide.c++</h1>
|
|
|
7 |
<p>The SDK support of Carbide.c++ allows you to build S60 applications
|
|
|
8 |
and run them in the emulator directly from the IDE. Building and running an
|
|
|
9 |
example application for the emulator from Carbide.c++ consists of the following
|
|
|
10 |
steps:</p>
|
|
|
11 |
<ul>
|
|
|
12 |
<li><p>importing an example application to the IDE</p></li>
|
|
|
13 |
<li><p>creating a WINSCW build of the example application</p>
|
|
|
14 |
</li>
|
|
|
15 |
<li><p>running the example application in the emulator</p></li>
|
|
|
16 |
</ul>
|
|
|
17 |
<div class="note"><p><strong class="note_title">Note: </strong>Carbide.c++ does not perform actions described in the bld.inf file.
|
|
|
18 |
For instance exports and additional makefiles are ignored. Almost all example
|
|
|
19 |
applications are affected by this problem. Thus, it is recommended to build
|
|
|
20 |
example applications first on command line and import these into the IDE only
|
|
|
21 |
after a successful command line build (see Building and Running
|
|
|
22 |
Example Applications from the Command Line).</p></div>
|
|
|
23 |
<div><h3>Importing an example application to Carbide.c++</h3><p>The <strong>Import Project</strong> wizard of Carbide.c++ allows you to import
|
|
|
24 |
Symbian OS projects into the IDE. With the wizard you can import both component
|
|
|
25 |
description file (<code>bld.inf</code>) and project definition file
|
|
|
26 |
(<code>.mmp</code>) based projects.</p><p>To import an example application (in this case <em>Hello World Basic</em>)
|
|
|
27 |
to Carbide.c++, do the following:</p><ol>
|
|
|
28 |
<li id="GUID-352BD584-6350-4987-8ACB-04EB254576C8"><a xmlns:d="http://www.pnp-software.com/XSLTdoc" name="GUID-352BD584-6350-4987-8ACB-04EB254576C8"><!----></a><p>Select <strong>File
|
|
|
29 |
> Import..</strong> from the menu bar.</p></li>
|
|
|
30 |
<li id="GUID-033B08A3-463C-4E46-B76F-C21E81D6AE1F"><a xmlns:d="http://www.pnp-software.com/XSLTdoc" name="GUID-033B08A3-463C-4E46-B76F-C21E81D6AE1F"><!----></a><p>In the <strong>Import</strong> dialog,
|
|
|
31 |
select "Symbian MMP File" and click <strong>Next</strong>.</p></li>
|
|
|
32 |
<li id="GUID-B4BF29B5-7492-445C-B67D-22C959157CE2"><a xmlns:d="http://www.pnp-software.com/XSLTdoc" name="GUID-B4BF29B5-7492-445C-B67D-22C959157CE2"><!----></a><p>In the <strong>MMP
|
|
|
33 |
File</strong> field, browse to the <code>.mmp</code> file (located in the <code>group</code> folder)
|
|
|
34 |
of the example application that you want to import.</p><p>For example:</p>
|
|
|
35 |
<p><code><S60_SDK_installation_directory>\S60CppExamples\HelloWorldBasic\group\helloworldbasic.mmp</code></p>
|
|
|
36 |
</li>
|
|
|
37 |
<li id="GUID-9C669E8F-75A7-42B1-BEF5-5D4685E31A53"><a xmlns:d="http://www.pnp-software.com/XSLTdoc" name="GUID-9C669E8F-75A7-42B1-BEF5-5D4685E31A53"><!----></a><p>In the <strong>SDKs
|
|
|
38 |
and Build Configurations</strong> list, under "All SDKs" select "S60_5th_Edition_SDK_V1.0" and
|
|
|
39 |
"Emulator Debug(WINSCW)[S60_5th_Edition_SDK_V1.0]".</p></li>
|
|
|
40 |
<li id="GUID-4B288D54-56E3-44C8-87B4-4AB1082D88F1"><a xmlns:d="http://www.pnp-software.com/XSLTdoc" name="GUID-4B288D54-56E3-44C8-87B4-4AB1082D88F1"><!----></a><p>Click <strong>Finish</strong>.</p>
|
|
|
41 |
</li>
|
|
|
42 |
</ol><p>The wizard will now create import the project and display it in the <strong>C/C++
|
|
|
43 |
Projects</strong> view, from where it can be built.</p><p>For more information on importing and creating project in Carbide.c++,
|
|
|
44 |
please refer to the following topic in the Carbide.c++ Help:</p><ul>
|
|
|
45 |
<li><p><strong>Carbide.c++ User Guide > Symbian OS Projects > Tasks >
|
|
|
46 |
Projects > Importing Projects</strong></p></li>
|
|
|
47 |
</ul></div>
|
|
|
48 |
<div><h3>Creating a WINSCW build of an example application with Carbide.c++</h3><p>In order to be able to view an aplication in the SDK emulator, you need
|
|
|
49 |
to create a WINSCW build of it: </p><ol>
|
|
|
50 |
<li id="GUID-43FF836F-1FDF-4104-BC2F-570CEB17DE52"><a xmlns:d="http://www.pnp-software.com/XSLTdoc" name="GUID-43FF836F-1FDF-4104-BC2F-570CEB17DE52"><!----></a><p>Select <strong>Project
|
|
|
51 |
> Properties</strong> from the menu bar.</p><p>The <strong>Properties</strong> dialog
|
|
|
52 |
opens. Here you can manage the build process by defining all aspects of the
|
|
|
53 |
build by entering the needed information.</p></li>
|
|
|
54 |
<li id="GUID-09954897-E1A8-4A91-BE88-0D7A87C89A42"><a xmlns:d="http://www.pnp-software.com/XSLTdoc" name="GUID-09954897-E1A8-4A91-BE88-0D7A87C89A42"><!----></a><p>Click <strong>C/C++
|
|
|
55 |
Build</strong> in the dialog TOC.</p></li>
|
|
|
56 |
<li id="GUID-6972CB13-B9DA-4E10-827A-E777B9DEF893"><a xmlns:d="http://www.pnp-software.com/XSLTdoc" name="GUID-6972CB13-B9DA-4E10-827A-E777B9DEF893"><!----></a><p>Select "S60
|
|
|
57 |
3.0 Emulator Debug" from the <strong>Configuration</strong> drop-down menu.</p></li>
|
|
|
58 |
<li id="GUID-9B8CCC40-0B4A-4257-969A-31069A039656"><a xmlns:d="http://www.pnp-software.com/XSLTdoc" name="GUID-9B8CCC40-0B4A-4257-969A-31069A039656"><!----></a><p>Click <strong>OK</strong>.</p>
|
|
|
59 |
</li>
|
|
|
60 |
<li id="GUID-2010504D-C631-48C2-94DB-AF8514A6F397"><a xmlns:d="http://www.pnp-software.com/XSLTdoc" name="GUID-2010504D-C631-48C2-94DB-AF8514A6F397"><!----></a><p>Select <strong>Project
|
|
|
61 |
> Build Project</strong> from the menu bar.</p></li>
|
|
|
62 |
</ol><p>Carbide.c++ creates a build of your project according to the current
|
|
|
63 |
configuration determined in the <strong>Properties</strong> dialog - in this case, a
|
|
|
64 |
WINSCW build.</p><p>For more information on building a project, please refer to the following
|
|
|
65 |
topics in the Carbide.c++ Help:</p><ul>
|
|
|
66 |
<li><p><strong>Carbide.c++ User Guide > Getting Started > First Application
|
|
|
67 |
Example > 5. Building a Symbian OS Executable</strong></p><p><strong>C/C++ Development
|
|
|
68 |
User Guide > Tasks > Building projects</strong></p></li>
|
|
|
69 |
</ul></div>
|
|
|
70 |
<div><h3>Running an example application in the emulator from Carbide.c++</h3><p>Once you have created a GCCE build of your project, you can run it on
|
|
|
71 |
the S60 emulator.</p><ol>
|
|
|
72 |
<li id="GUID-A79DB2EB-D28D-4A1A-933D-031028DF8AFF"><a xmlns:d="http://www.pnp-software.com/XSLTdoc" name="GUID-A79DB2EB-D28D-4A1A-933D-031028DF8AFF"><!----></a><p>Select <strong>Run
|
|
|
73 |
> Run...</strong> from the menu bar.</p><p>The Run dialog opens. The Run
|
|
|
74 |
dialog allows you to define the launch configuration of the build.</p>
|
|
|
75 |
</li>
|
|
|
76 |
<li id="GUID-1B4D8494-E86B-4E97-84C0-18CC79253BA0"><a xmlns:d="http://www.pnp-software.com/XSLTdoc" name="GUID-1B4D8494-E86B-4E97-84C0-18CC79253BA0"><!----></a><p>Select the
|
|
|
77 |
GCCE build from the <strong>Configurations</strong> list of the dialog.</p></li>
|
|
|
78 |
<li id="GUID-06A71AAD-5A85-4157-BE40-ABFA4E6E9CBF"><a xmlns:d="http://www.pnp-software.com/XSLTdoc" name="GUID-06A71AAD-5A85-4157-BE40-ABFA4E6E9CBF"><!----></a><p>Define and/or
|
|
|
79 |
accept the values in the fields (above all, make sure that the <strong>Executable</strong> and <strong>Emulator
|
|
|
80 |
or host application</strong> paths are correct).</p></li>
|
|
|
81 |
<li id="GUID-1BD562CB-2612-4748-BC97-51524E5CE1A3"><a xmlns:d="http://www.pnp-software.com/XSLTdoc" name="GUID-1BD562CB-2612-4748-BC97-51524E5CE1A3"><!----></a><p>Click the <strong>Apply</strong> button.</p>
|
|
|
82 |
</li>
|
|
|
83 |
<li id="GUID-6424FE70-A363-4938-BC89-9FF7B9DEB5CB"><a xmlns:d="http://www.pnp-software.com/XSLTdoc" name="GUID-6424FE70-A363-4938-BC89-9FF7B9DEB5CB"><!----></a><p>Click the <strong>Run</strong> button.</p>
|
|
|
84 |
</li>
|
|
|
85 |
</ol><p>The application is launched in the emulator (see step 2 onwards in <a href="GUID-1AAADEA6-89E7-4F54-A3F5-FA74BDE1A21A.html#GUID-8319CFBF-719F-4DB7-AB52-545798F09509">Launch the application in
|
|
|
86 |
the emulator</a> for a description of the Hello World Basic example application).</p><p>For more information on running projects and applications through Carbide.c++,
|
|
|
87 |
please refer to the following topics in the Carbide.c++ Help:</p><ul>
|
|
|
88 |
<li><p><strong>Carbide.c++ User Guide > Getting Started > First Application
|
|
|
89 |
Example > 3. Building a Symbian OS Executable</strong></p></li>
|
|
|
90 |
<li><p><strong>C/C++ Development User Guide > Tasks > First Application
|
|
|
91 |
Example > Running and debugging projects</strong></p></li>
|
|
|
92 |
</ul></div>
|
|
|
93 |
</div><!--end: content--><!--start: sidebar--><!--end: sidebar--></div><!--END: BODY SECTION--><!--BEGIN: FOOTER--><div class="footer"><hr/><div class="copy">© Nokia 2009</div></div><!--END: FOOTER--></body></html> |