15 <p>To start, import your game project into Carbide:</p> |
15 <p>To start, import your game project into Carbide:</p> |
16 <ol> |
16 <ol> |
17 <li>Install the N-Gage SDK on your PC</li> |
17 <li>Install the N-Gage SDK on your PC</li> |
18 <li>Place your game project inside the N-Gage SDK</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> |
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> |
20 <li>Select <b>Symbian OS Bld.inf</b> <strong>File</strong> importer and navigate to your <span class="code">bld.inf</span> file to import it </li> |
21 </ol> |
21 </ol> |
22 <h4>Building the N-Gage project</h4> |
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> |
23 <p>Once the game project has been imported, use these steps to create an N-GAGE game file:</p> |
24 <ol> |
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> |
25 <li>Right-click the project name 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> |
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: |
27 <li>In the <b><a href="../reference/build_properties/wnd_sis_properties.htm">SIS Properties</a></b> window: |
28 <ol> |
28 <ol> |
29 <li>Specify the project and metadata PKG files to build</li> |
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> |
30 <li>Enable the<b> Sign sis file with certificate/key pair</b> for each PKG file </li> |
65 <li>Manually install the <span class="code">.N-GAGE</span> file on the device</li> |
65 <li>Manually install the <span class="code">.N-GAGE</span> file on the device</li> |
66 </ol> |
66 </ol> |
67 <h4>Debugging the Game project</h4> |
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> |
68 <p>With your game file installed on the device, create a launch configuration for the project. In Carbide:</p> |
69 <ol> |
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> |
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 under the General Options group</li> |
71 <li>Right-click the project and choose <b>Debug As > Debug As</b> to open the <b><a href="../reference/wnd_debug_configuration.htm">Debug</a></b> window</li> |
71 <li>Right-click the project and choose <b>Debug As > Debug Configuration</b> to open the <b><a href="../reference/wnd_debug_configuration.htm">Debug Cinfigurations</a></b> window</li> |
72 <li><a href="../tasks/projects/prj_debug_config.htm">Create</a> an <b>Application TRK</b> launch configuration |
72 <li><a href="../tasks/projects/prj_debug_config.htm">Create</a> an <b>Symbian OS Application TRK</b> launch configuration |
73 <ul> |
73 <ul> |
74 <li>In the <b><a href="../projects/launch/page_connection.htm">Connection</a></b> tab select the COM port used to connect to the device. </li> |
74 <li>In the <b><a href="../projects/launch/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="../projects/launch/page_installation.htm">Installation</a></b> tab, verify that the game SISX file is correct </li> |
75 <li> In the <b><a href="../projects/launch/page_installation.htm">Installation</a></b> tab, verify that the game SISX file is correct </li> |
76 <li>In the <b><a href="../projects/launch/page_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> |
76 <li>In the <b><a href="../projects/launch/page_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> |
77 </ul> |
78 </li> |
78 </li> |
80 <li>Click <b>Debug</b> </li> |
80 <li>Click <b>Debug</b> </li> |
81 </ol> |
81 </ol> |
82 <p>The Debugger launches the game project in the device and halts when it encounters the breakpoint you set. </p> |
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> |
83 <h3>For Emulator Debugging </h3> |
84 <h4>Deploying and debugging the N-Gage project on an emulator</h4> |
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> |
85 <p>With your game file installed on the emulator, create a launch configuration for the project. In Carbide:</p> |
86 <ol> |
86 <ol> |
87 <li>Open <b>Window > Preferences > Run/Debug > Launching</b> and disable the <b>Build (if required) before launching</b> option</li> |
87 <li>Open <b>Window > Preferences > Run/Debug > Launching</b> and disable the <b>Build (if required) before launching</b> option under the General Options group</li> |
88 <li>Right-click the project and choose <b>Debug As > Debug As</b> to open the <b>Debug</b> window</li> |
88 <li>Right-click the project and choose <b>Debug As > Debug Configurations</b> to open the <b>Debug Configurations</b> window</li> |
89 <li>Create an <b>Symbian OS Emulation </b> launch configuration</li> |
89 <li>Create an <b>Symbian OS Emulation </b> launch configuration</li> |
90 <li>Click <b>Debug</b> to launch the emulator </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> |
91 <li>In the emulator, select <b>File > Open</b>, locate and select the <span class="code">.N-GAGE</span> 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> |
92 <li>Open the Installation folder, launch the N-Gage runtime application</li> |
93 <li>In the N-Gage runtime launch the game </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> |
94 <li>If any breakpoint is hit in the game project, the debugger suspends</li> |
95 </ol> |
95 </ol> |
96 <p>From this point you can use all of the debugger features to debug the project. </p> |
96 <p>From this point you can use all of the debugger features to debug the project. </p> |