2
|
1 |
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
|
2 |
<html>
|
|
3 |
<head>
|
|
4 |
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
|
|
5 |
<meta http-equiv="Content-Style-Type" content="text/css" />
|
|
6 |
<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
|
|
7 |
<title>N-Gage Projects</title>
|
|
8 |
<link rel="StyleSheet" href="../../book.css" type="text/css"/>
|
|
9 |
<script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js"></script>
|
|
10 |
</head>
|
|
11 |
<body bgcolor="#FFFFFF">
|
|
12 |
<h2>N-Gage Projects</h2>
|
|
13 |
<p>Carbide.c++ supports the importing of N-Gage projects. However, there are some process issues that effect how you can debug game projects on devices. The following provides a high level overview of the process you should follow to successfully import, build, deploy, and debug an N-Gage game on a device. </p>
|
|
14 |
<h4>Importing N-Gage projects</h4>
|
|
15 |
<p>To start, import your game project into Carbide:</p>
|
|
16 |
<ol>
|
|
17 |
<li>Install the N-Gage SDK on your PC</li>
|
|
18 |
<li>Place your game project inside the N-Gage SDK</li>
|
|
19 |
<li> In Carbide.c++, click<b> File > <a href="../tasks/ImportingProjects.html">Import</a></b></li>
|
|
20 |
<li>Select <b>Symbian OS Bld.inf</b> importer and navigate to your bld.inf file to import it </li>
|
|
21 |
</ol>
|
|
22 |
<h4>Building the N-Gage project</h4>
|
|
23 |
<p>Once the game project has been imported, use these steps to create an N-GAGE game file:</p>
|
|
24 |
<ol>
|
|
25 |
<li>Right-click the project and choose <b>Properties</b> to open the <b>Properties for <i>project_name</i></b> window </li>
|
|
26 |
<li>In the <b>Carbide.c++ > Carbide Build Configuration > <a href="../reference/build_properties/pane_build_config_sis.htm">SIS Builder</a></b> panel, click <b>Add</b>.</li>
|
|
27 |
<li>In the <b><a href="../reference/build_properties/wnd_sis_properties.htm">SIS Properties</a></b> window:
|
|
28 |
<ol>
|
|
29 |
<li>Specify the project and metadata PKG files to build</li>
|
|
30 |
<li>Enable the<b> Sign sis file with certificate/key pair</b> for each PKG file </li>
|
|
31 |
<li>Select the certificate/key given to you by the Nokia R&D Certificate Service</li>
|
|
32 |
<li>Click <b>OK</b></li>
|
|
33 |
</ol>
|
|
34 |
</li>
|
|
35 |
<li>If using a batch file to build the N-Gage installation, create a new builder within Carbide by opening the <b>Properties for <i>project_name</i> > Builders</b> panel and click <b>New</b>. </li>
|
|
36 |
<p align="center"><img src="images/pane_builders_properties.png" width="682" height="208"></p>
|
|
37 |
<p align="center" class="figure">Figure 1 - Builders pane in project Properties dialog</p>
|
|
38 |
<li>Open the <b>Properties for <i>project_name</i> > Builders</b> panel</li>
|
|
39 |
<li>Click <b>New</b></li>
|
|
40 |
<li>Select <b>Program</b> in the <b>Choose configuration type</b> window, click <b>OK</b> </li>
|
|
41 |
<p align="center"><img src="images/wnd_properties_for_builder.png" width="800" height="640"></p>
|
|
42 |
<p align="center" class="figure">Figure 2 - <b>Properties for N-Gage Builder</b> dialog</p>
|
|
43 |
<li>In the <b>Properties for New_Builder</b> window
|
|
44 |
<b>Main</b> tab:
|
|
45 |
<ul>
|
|
46 |
<li>Define the builder name in the <b>Name</b> text box</li>
|
|
47 |
<li>Specify the <b>Location</b> of the builder of the installation file</li>
|
|
48 |
<li>Specify the <b>Working Directory</b> </li>
|
|
49 |
</ul>
|
|
50 |
</li>
|
|
51 |
<li>Click <b>OK</b> </li>
|
|
52 |
<p> The new builder appears in the <b>Builders</b> panel. The build steps are performed in the order they are displayed. Your builder name should appear under the <b>Carbide CPP Project Builder</b> item. If not, use the <b>Up</b> or <b>Down</b> controls to set the build order.
|
|
53 |
<p align="center"><img src="images/pane_builder_n_gage_builder.png" width="489" height="184"></p>
|
|
54 |
<p align="center" class="figure">Figure 4 - <b>Builder</b> dialog with new N-Gage Builder defined </p>
|
|
55 |
<li>Click OK to close the <b>Properties for <i>project_name</i></b> window</li>
|
|
56 |
<li>Build the project and its SISX file by selecting the <b>Project > Build Project</b> menu item</li>
|
|
57 |
<p>The <a href="../reference/view_log.htm">Console</a> view shows information as the project and it's SISX file are built and then the build of the installation file (<span class="code">N-GAGE</span>).</p>
|
|
58 |
</ol>
|
|
59 |
<h3>For On-device Debugging </h3>
|
|
60 |
<h4>Deploying the N-Gage project to a device </h4>
|
|
61 |
<p>Once you have an <span class="code">.N-GAGE</span> game file, you need to deploy it on the target device:</p>
|
|
62 |
<ol>
|
|
63 |
<li>Verify that you have a valid developer certificate on the target device given to you by the Nokia R&D Certificate Service. If not, get and install one.</li>
|
|
64 |
<li>Verify that you have Application TRK installed on the target device. If not, install it now using <a href="../reference/trk/wnd_new_connection_wizard.htm">On-Device Connections > New Connection Wizard > Install remote agents</a> pane.</li>
|
|
65 |
<li>Manually install the <span class="code">.N-GAGE</span> file on the device</li>
|
|
66 |
</ol>
|
|
67 |
<h4>Debugging the Game project</h4>
|
|
68 |
<p>With your game file installed on the device, create a launch configuration for the project. In Carbide:</p>
|
|
69 |
<ol>
|
|
70 |
<li>Open<span class="note"><b>Window > Preferences > Run/Debug ><img src="../images/command_link.png" width="16" height="12"> <a class="command-link" href='javascript:executeCommand("org.eclipse.ui.window.preferences(preferencePageId=org.eclipse.debug.ui.LaunchingPreferencePage)")'> Launching</a></b> preference panel </span>and disable the <b>Build (if required) before launching</b> option</li>
|
|
71 |
<li>Right-click the project and choose <b>Debug As > Open Debug Dialog</b> to open the <b><a href="../reference/wnd_debug_configuration.htm">Debug</a></b> window</li>
|
|
72 |
<li><a href="../tasks/projects/prj_debug_config.htm">Create</a> an <b>Application TRK</b> launch configuration
|
|
73 |
<ul>
|
|
74 |
<li>In the <b><a href="../reference/launch_configs/page_connection.htm">Connection</a></b> tab select the COM port used to connect to the device. </li>
|
|
75 |
<li> In the <b><a href="../reference/launch_configs/app_trk_installation.htm">Installation</a></b> tab, verify that the game SISX file is correct </li>
|
|
76 |
<li>In the <b><a href="../reference/launch_configs/page_trk_debugger.htm">Debug</a></b> tab, enable the View messges between PC and debug agent on the phone if you want to monitor communications between TRK and Carbide </li>
|
|
77 |
</ul>
|
|
78 |
</li>
|
|
79 |
|
|
80 |
<li>Click <b>Debug</b> </li>
|
|
81 |
</ol>
|
|
82 |
<p>The Debugger launches the game project in the device and halts when it encounters the breakpoint you set. </p>
|
|
83 |
<h3>For Emulator Debugging </h3>
|
|
84 |
<h4>Deploying and debugging the N-Gage project on an emulator</h4>
|
|
85 |
<p>With your game file installed to the emulator, create a launch configuration for the project. In Carbide:</p>
|
|
86 |
<ol>
|
|
87 |
<li>Open <b>Window > Preferences > Run/Debug > Launching</b> and disable the <b>Build (if required) before launching</b> option</li>
|
|
88 |
<li>Right-click the project and choose <b>Debug As > Open Debug Dialog</b> to open the <b>Debug</b> window</li>
|
|
89 |
<li>Create an <b>Symbian OS Emulation </b> launch configuration</li>
|
|
90 |
<li>Click <b>Debug</b> to launch the emulator </li>
|
|
91 |
<li>In the emulator, select <b>File > Open</b>, locate and select the .N-GAGE installation file and click <b>Open</b> to install the project </li>
|
|
92 |
<li>Open the Installation folder, launch the N-Gage runtime application</li>
|
|
93 |
<li>In the N-Gage runtime launch the game </li>
|
|
94 |
<li>If any breakpoint is hit in the game project, the debugger suspends</li>
|
|
95 |
</ol>
|
|
96 |
<p>From this point you can use all of the debugger features to debug the project. </p>
|
|
97 |
<p>Always refer to the N-Gage documentation for more information on creating, deploying, and debugging N-Gage projects. </p>
|
|
98 |
<div id="footer">Copyright © 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>
|
|
99 |
|
|
100 |
</body>
|
|
101 |
</html>
|