12 <p class="note"><b>NOTE</b> When creating or importing projects the sources and SDK must be on the same drive. This is due to many of the internal SDK tools using an implicit working drive to calculate paths (e.g. \epoc32\tools). Avoid spaces in SDK paths since this will also cause problems.</p> |
12 <p class="note"><b>NOTE</b> When creating or importing projects the sources and SDK must be on the same drive. This is due to many of the internal SDK tools using an implicit working drive to calculate paths (e.g. \epoc32\tools). Avoid spaces in SDK paths since this will also cause problems.</p> |
13 <div class="step"> |
13 <div class="step"> |
14 <h3>Creating New Symbian OS C++ Projects</h3> |
14 <h3>Creating New Symbian OS C++ Projects</h3> |
15 <ol> |
15 <ol> |
16 <li class="step">Select <b>File > New > Symbian OS C++ Project</b> to invoke the <b>New Project</b> wizard.</span></li> |
16 <li class="step">Select <b>File > New > Symbian OS C++ Project</b> to invoke the <b>New Project</b> wizard.</span></li> |
17 <p><img src="../images/step1.png" width="546" height="142" alt="" ></p> |
17 <p><img src="../images/step1.png" width="506" height="318" alt="" ></p> |
18 <li>The <b class="step">New Symbian OS C++ Project</b> wizard appears. Select a template related to an installed SDK.</li> |
18 <li>The <b class="step">New Symbian OS C++ Project</b> wizard appears. Select a template related to an installed SDK.</li> |
19 <p>A project template provides the initial source files and project settings appropriate for the chosen project type. A brief description of each template appears below the list. The project type determines the type of program that you are writing.</p> |
19 <p>A project template provides the initial source files and project settings appropriate for the chosen project type. A brief description of each template appears below the list. The project type determines the type of program that you are writing.</p> |
20 <p class="note"><b>NOTE</b> If the selected template requires user input, additional wizard pages will collect data from the user before creating the project.</p> |
20 <p class="note"><b>NOTE</b> If the selected template requires user input, additional wizard pages will collect data from the user before creating the project.</p> |
21 <p>Checkmark the <b>Filter templates based on enabled SDKs</b> option to only list SDKs enabled in the <a href="../reference/SDKPreferences.html">SDK Preferences</a> panel. Uncheck this option to list SDKs that can be used with Carbide. Click <b>Next</b>.</p> |
21 <p>Checkmark the <b>Filter templates based on enabled SDKs</b> option to only list SDKs enabled in the <a href="../reference/SDKPreferences.html">SDK Preferences</a> panel. Uncheck this option to list SDKs that can be used with Carbide. Click <b>Next</b>.</p> |
22 <p align="center"><img src="../images/step2.png" width="500" height="567" alt="" ></p> |
22 <p align="center"><img src="../images/step2.png" width="500" height="567" alt="" ></p> |
23 <li>Enter a name for your project. </li> |
23 <li>Enter a name for your project. </li> |
24 <p>Checkmark the <b>Use default location</b> option to save the project in the current workspace by default or uncheck it to save to another location. Enter the path in the <b>Location</b> field or click <b>Browse</b> button to locate the directory. Click <b>Next</b>.</p> |
24 <p>Checkmark the <b>Use default location</b> option to save the project in the current workspace by default or uncheck it to save to another location. Enter the path in the <b>Location</b> field or click <b>Browse</b> button to locate the directory. Click <b>Next</b>.</p> |
25 <p align="center"><span class="Image"><img src="images/new_proj_name_location.png" alt="new project" width="500" height="567"></span><span class="Image"><br> |
25 <p align="center"><span class="Image"><img src="images/new_proj_name_location.png" alt="new project" width="500" height="400"></span><span class="Image"><br> |
26 </span></p> |
26 </span></p> |
27 <li>Select the <b>SDKs and Build Configurations</b>. </li> |
27 <li>Select the <b>SDKs and Build Configurations</b>. </li> |
28 <p>Checkmark the <b>Filter SDKs based on selected template</b> option to only show build configurations based on the selected SDK template, or uncheck to show all enabled SDKs and their related build configurations.</p> |
28 <p>Checkmark the <b>Filter SDKs based on selected template</b> option to only show build configurations based on the selected SDK template, or uncheck to show all enabled SDKs and their related build configurations.</p> |
29 <p align="center"><img src="../images/step4.png" width="500" height="567" alt="" ></p> |
29 <p align="center"><img src="../images/step4.png" width="500" height="500" alt="" ></p> |
30 <p class="Image">The Symbian OS SDKs wizard page shows a tree of the SDKs and the type of builds available within that SDK. Select a single SDK |
30 <p class="Image">The Symbian OS SDKs wizard page shows a tree of the SDKs and the type of builds available within that SDK. Select a single SDK |
31 if the program you are developing is for just one version of a platform, |
31 if the program you are developing is for just one version of a platform, |
32 or select multiple SDKs to build the program for multiple build platforms or SDK versions.</p> |
32 or select multiple SDKs to build the program for multiple build platforms or SDK versions.</p> |
33 <p> The build configuration allows you to specify the compiler(s) to |
33 <p> The build configuration allows you to specify the compiler(s) to |
34 do the build, and whether debug and/or release builds are required. For this example we recommend using the Emulator Debug version as the <a href="../concepts/build_configurations.htm">build configuration</a>. Later, you can <a href="projects/prj_set_build_tgt.htm">switch</a> to another build configuration to create the project for a specific device.</p> |
34 do the build, and whether debug and/or release builds are required. For this example we recommend using the Emulator Debug version as the <a href="../concepts/build_configurations.htm">build configuration</a>. Later, you can <a href="projects/prj_set_build_tgt.htm">switch</a> to another build configuration to create the project for a specific device.</p> |
35 <p> Click <b>Next</b>.</p> |
35 <p> Click <b>Next</b>.</p> |
36 <li>Set the project properties in the <b>Basic Settings</b> page. </li> |
36 <li>Set the project properties in the <b>Basic Settings</b> page. </li> |
37 <div align="center"><img src="../images/step5.png" width="500" height="567" alt="" > </div> |
37 <div align="center"><img src="../images/step5.png" width="500" height="500" alt="" > </div> |
38 <blockquote> |
38 <blockquote> |
39 <p align="left" class="note"><b>NOTE</b> The basic properties for a project may change based on the template selected for a particular project type. </p> |
39 <p align="left" class="note"><b>NOTE</b> The basic properties for a project may change based on the template selected for a particular project type. </p> |
40 <p align="left" style="font-weight: normal;">Fill in the applicable fields, which |
40 <p align="left" style="font-weight: normal;">Fill in the applicable fields, which |
41 may include UID2, UID3, Vendor ID, Author, Support Email, Copyright |
41 may include UID2, UID3, Vendor ID, Author, Support Email, Copyright |
42 notice and Target Type for console EXEs.</p> |
42 notice and Target Type for console EXEs.</p> |
59 <span style="font-weight: normal;">which allocates these values.</span> </p> |
59 <span style="font-weight: normal;">which allocates these values.</span> </p> |
60 </blockquote> |
60 </blockquote> |
61 <li span style="font-weight: normal;"> |
61 <li span style="font-weight: normal;"> |
62 Click <b>Next</b> to move to the <b>Project Directories</b> page.</li> |
62 Click <b>Next</b> to move to the <b>Project Directories</b> page.</li> |
63 <div class="Figure"> |
63 <div class="Figure"> |
64 <p align="center" class="Image"><img src="../images/step6.png" width="500" height="567" alt="" ><br> |
64 <p align="center" class="Image"><img src="../images/step6.png" width="500" height="500" alt="" ><br> |
65 </p> |
65 </p> |
66 <p class="note" style="font-weight: normal;"> <b>NOTE</b> The project directories depends on the selected template. That is, the directories required to store project data may |
66 <p class="note" style="font-weight: normal;"> <b>NOTE</b> The project directories depends on the selected template. That is, the directories required to store project data may |
67 change based on the template used. </p> |
67 change based on the template used. </p> |
68 </div> |
68 </div> |
69 <p>Accept the defaults or enter the names for Include and Source folders to be created under the project root directory. Generated files will be copied to these directories.</p> |
69 <p>Accept the defaults or enter the names for Include and Source folders to be created under the project root directory. Generated files will be copied to these directories.</p> |
70 <li> Click <b>Finish</b> to create the project.</li> |
70 <li> Click <b>Finish</b> to create the project.</li> |
71 <p>This generates the necessary files for the project based on the template selected and show them in the <a href="../reference/view_cpp_projects.htm">Project Explorer</a> view.</p> |
71 <p>This generates the necessary files for the project based on the template selected and show them in the <a href="../reference/view_cpp_projects.htm">Project Explorer</a> view.</p> |
72 </ol> |
72 </ol> |
73 <blockquote> |
73 <blockquote> |
74 <p align="center"><img src="../images/step7.png" width="277" height="339" alt="" > </p> |
74 <p align="center"><img src="../images/step7.png" width="273" height="301" alt="" > </p> |
75 </blockquote> |
75 </blockquote> |
76 </div> |
76 </div> |
77 <blockquote> |
77 <blockquote> |
78 <p class="note"><b>NOTE</b> If the Carbide.c++ perspective is not visible, select the <b>Window |
78 <p class="note"><b>NOTE</b> If the Carbide.c++ perspective is not visible, select the <b>Window |
79 > Open Perspective > Other</b>... command to list all available |
79 > Open Perspective > Other</b>... command to list all available |