core/com.nokia.carbide.cpp.doc.user/html/tasks/ImportingProjects.html
changeset 1507 30441fd93226
parent 1376 120480c02651
child 1658 2a5c0df13bad
equal deleted inserted replaced
1506:9ebb7e505267 1507:30441fd93226
    47 		To import from a bld.inf file</h4> 
    47 		To import from a bld.inf file</h4> 
    48  
    48  
    49 	 <ol> 
    49 	 <ol> 
    50 		<li> 
    50 		<li> 
    51 	   Click File &gt; Import... to get a list of available import wizards</li> 
    51 	   Click File &gt; Import... to get a list of available import wizards</li> 
    52 		<li>Select Symbian OS Bld.inf file and click Next to go to the Import Bld.inf page
    52 		<li>Select Symbian OS &gt; Symbian OS Bld.inf file and click Next to go to the Import Bld.inf page
    53 		  <div class="Figure">
    53 		    <div class="Figure"></div>
    54     
       
    55 		  <p class="Image"><img src="../images/import1.gif" alt="" width="373" height="419"  border="0" /></p>
       
    56 	      </div>
       
    57 		</li>
    54 		</li>
    58 		<li> 
    55        </ol>
    59 			 Type the location of the bld.inf file to import, or browse to the file using the Browse button. </li> 
       
    60 	
       
    61 	      <p class="Image"><img src="images/file_import.png" alt="file import" width="521" height="391"></p>
       
    62 	      <p class="note"><strong>NOTE</strong> There will be two builders available in Carbide, one for SBSv1 (current version of Symbian Build System) and  one for SBSv2 (newer version). The Builder option will only be displayed when a SBSv2  installation is detected.</p>
       
    63 	      <p class="Image">SBSv2  only works with recent versions of Symbian OS9.5. Both  SBSv1 and SBSv2 are GNU make based build systems.&nbsp; SBSv1 uses Perl to generate make files,  while SBSv2 uses Python. Select the appropriate builder for your project.</p>
       
    64 	      When building for  SBSv2, the builder will set EPOCROOT to the absolute path (including drive  letter) to the kit for the active build configuration.&nbsp; It will also add the path to the sbs bin  directory to the start of the PATH variable.&nbsp;  This is derived from the SBS_HOME environment variable.<p class="Image">For SBSv2, all  build configurations (platform/target), including the built-in platforms  (WISNCW, ARMV5), are declared in xml files in the \sbs\lib\config directory.  The Build  Configurations selection page will display only those kits  known to support SBSv2.</p>
       
    65        <li>	    Click Next to select the recognized SDKs and Build Configurations to be created for this project
       
    66   <p>The SDKs and Build Configurations shows a tree of
       
    67 			 the SDKs that are available to be used, and for each SDK, the type of build configurations
       
    68 			 that are available. You can select a single SDK if you are developing the program
       
    69 			 for just one version of a platform, or multiple SDKs if your
       
    70 			 program is to be built against multiple platforms or operating system
       
    71 		  versions.</p>
       
    72 		  <p class="note"><b>NOTE</b> The platforms listed are dependent upon the filter settings in the <a href="sdks/sdk_platform_filter.htm">Platform Filtering Preferences</a>.</p>
       
    73 		  <p></p>
       
    74 		  <div class="Figure">
       
    75             <p class="Image"><img src="../images/import3.gif" alt="" width="448" height="410"  border="0" /></p>
       
    76 	      </div>
       
    77 	   </li> 
       
    78 	   <li value="5"> Click Next to select the mmp and extension make files
       
    79 		  <div class="Figure">
       
    80             <p>One MMP file must be selected in order to continue. If the bld.inf file contains more than three MMP files, just select the MMP files you need to import. If there are three or less MMP files, then all are selected for importing.</p>
       
    81             <p class="Image"><img src="../images/import4.gif" alt="" width="521" height="550"  border="0" /></p>
       
    82          </div>
       
    83 	   </li>
       
    84 	   <li>Click Next to enter the Project name and root directory</li>
       
    85 		<p>When creating a project, project files are created in the root directory. Carbide.c++ creates additional files for each project. They consist of:</p>
       
    86 	    <ul>
       
    87 	      <li>.project - an xml file that provides a project description </li>
       
    88 	      <li>.cproject - an xml file that provides additional project information </li>
       
    89 	      <li>.settings folder - contains files that provide build configuration and preference settings </li>
       
    90        </ul>
       
    91        <p>The root directory is a path to the root of your project. All necessary tool components, developer libraries, and information about the SDK are stored in subdirectories under this root. The whole path leading to the SDK root directory must be declared to the Windows system via the Environment Variables settings. The variable name is EPOCROOT and the variable value is the full path where a Symbian OS SDK is installed in the Windows system.</p>
       
    92        <p>The root directory should contain all project related files that you want to work with in Carbide. The default directory is calculated by parsing the bld.inf file and mmp file(s).</p>
       
    93        <p class="Image"><img src="../images/import5.gif" alt="" width="518" height="313"  border="0" /></p>
       
    94        
       
    95 	    <li> Click Finish to import the project
       
    96 	      <p>
       
    97              The
       
    98 			   wizard creates the project in the C/C++ Projects view, where it can be built and edited as normal. If the wizard is unable to read the project files, then the page
       
    99 	        describes the error that occurred. If an error occurs, you must fix the project file, and then
       
   100           re-import the bld.inf.</p>
       
   101        </li>
       
   102 	 </ol>
       
   103 
    56 
       
    57      <blockquote>
       
    58          <p><img src="../reference/images/import_bld_inf_01.png" alt="Select Symbian bld.inf file to import" width="525" height="550"></p>
       
    59      </blockquote>
       
    60      <ol start="3">
       
    61 		 <li> 
       
    62 			 Type the location of the bld.inf file to import, or browse to the file using the Browse button. </li>
       
    63 		  <p class="Image"><img src="../reference/images/import_bld_inf_02.png" alt="Select bld.inf file to import" width="573" height="550"></p>
       
    64 		  <p class="note"><strong>NOTE</strong> Depending upon which SDKs are installed, you may see both SBSv1 and SBSv2 builders available. It is recommended that SBSv2 be the primary choice as SBSv1 has been deprecated for future Symbian OS development.</p>
       
    65 		  <p class="Image">SBSv2   works with recent versions of Symbian^3 and Symbian ^4 SDKs. Both  SBSv1 and SBSv2 are GNU make based build systems.&nbsp; SBSv1 uses Perl to generate make files,  while SBSv2 uses Python. Select the appropriate builder for your project.</p>
       
    66 		  When building for  SBSv2, the builder will set <span class="code">EPOCROOT</span> to the absolute path (including drive  letter) to the kit for the active build configuration.&nbsp; It will also add the path to the sbs bin  directory to the start of the <span class="code">PATH</span> variable.&nbsp;  This is derived from the SBS_HOME environment variable.
       
    67 		  <p class="Image">For SBSv2, all  build configurations (platform/target), including the built-in platforms  (WINSCW, ARMV5), are declared in xml files in the <span class="code">\sbs\lib\config</span> directory.  The Build  Configurations selection page  displays only kits  known to support SBSv2.</p>
       
    68 		  <li> Click Next to select the recognized SDKs and Build Configurations to be created for this project
       
    69 		      <blockquote>
       
    70 		          <p>The SDKs and Build Configurations shows a tree of
       
    71 		              the SDKs that are available to be used, and for each SDK, the type of build configurations
       
    72 		              that are available. You can select a single SDK if you are developing the program
       
    73 		              for just one version of a platform, or multiple SDKs if your
       
    74 		              program is to be built against multiple platforms or operating system
       
    75 		              versions.</p>
       
    76 	          </blockquote>
       
    77          </li>
       
    78      </ol>
       
    79      <blockquote>
       
    80          <p class="note"><b>NOTE</b> The platforms listed are dependent upon the filter settings in the <a href="sdks/sdk_platform_filter.htm">Platform Filtering Preferences</a>.</p>
       
    81          <p><img src="../reference/images/import_bld_inf_03.png" alt="Symbian OS SDKs page" width="573" height="550"></p>
       
    82      </blockquote>
       
    83      <ol>
       
    84          <li value="5"> Click Next to select the mmp and extension make files
       
    85              <div class="Figure">
       
    86                  <p>One MMP file must be selected in order to continue. If the bld.inf file contains more than three MMP files, just select the MMP files you need to import. If there are three or less MMP files, then all are selected for importing.</p>
       
    87                  <p class="Image"><img src="../reference/images/import_bld_inf_04.png" alt="" width="573" height="550"  border="0" /></p>
       
    88              </div>
       
    89                  </li>
       
    90          <li>Click Next to enter the Project name and root directory</li>
       
    91          <p>When creating a project, project files are created in the root directory. Carbide.c++ creates additional files for each project. They consist of:</p>
       
    92          <ul>
       
    93              <li>.project - an xml file that provides a project description </li>
       
    94              <li>.cproject - an xml file that provides additional project information </li>
       
    95              <li>.settings folder - contains files that provide build configuration and preference settings </li>
       
    96                      </ul>
       
    97          <p>The root directory is a path to the root of your project. All necessary tool components, developer libraries, and information about the SDK are stored in subdirectories under this root. The whole path leading to the SDK root directory must be declared to the Windows system via the Environment Variables settings. The variable name is <span class="code">EPOCROOT</span> and the variable value is the full path where a Symbian OS SDK is installed in the Windows system.</p>
       
    98          <p>The root directory should contain all project related files that you want to work with in Carbide. The default directory is calculated by parsing the bld.inf file and mmp file(s).</p>
       
    99          <p class="Image"><img src="../reference/images/import_bld_inf_05.png" alt="" width="573" height="550"  border="0" /></p>
       
   100          <li> Click Finish to import the project
       
   101              <p>
       
   102                  The
       
   103                  wizard creates the project in the <a href="../reference/view_cpp_projects.htm">Project Explorer</a> view, where it can be built and edited as normal. If the wizard is unable to read the project files, then the page
       
   104                  describes the error that occurred. If an error occurs, you must fix the project file, and then
       
   105              re-import the bld.inf.</p>
       
   106                      </li>
       
   107      </ol>
   104    </div>
   108    </div>
   105 	   <h5>Related  concepts</h5>
   109 	   <h5>Related  concepts</h5>
   106 
   110 
   107 	   <ul>
   111 	   <ul>
   108          <li><a href="../concepts/Projects.html">Projects</a></li>
   112          <li><a href="../concepts/Projects.html">Projects</a></li>