carbidesdk/com.nokia.carbide.cpp.sdk.doc.user/html/gettingStarted/import_examples.htm
author cawthron
Tue, 24 Mar 2009 22:20:21 -0500
changeset 2 d760517a8095
child 12 6b79ffb176c5
permissions -rw-r--r--
new
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
2
cawthron
parents:
diff changeset
     1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
cawthron
parents:
diff changeset
     2
<html xmlns="http://www.w3.org/1999/xhtml">
cawthron
parents:
diff changeset
     3
<head>
cawthron
parents:
diff changeset
     4
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
cawthron
parents:
diff changeset
     5
<title>Importing the SDK example and leavescan plug-ins</title>
cawthron
parents:
diff changeset
     6
<link rel="StyleSheet" href="../../book.css" type="text/css"/>
cawthron
parents:
diff changeset
     7
<style type="text/css">
cawthron
parents:
diff changeset
     8
<!--
cawthron
parents:
diff changeset
     9
.style1 {color: #000000}
cawthron
parents:
diff changeset
    10
-->
cawthron
parents:
diff changeset
    11
</style>
cawthron
parents:
diff changeset
    12
</head>
cawthron
parents:
diff changeset
    13
<body bgcolor="#FFFFFF">
cawthron
parents:
diff changeset
    14
cawthron
parents:
diff changeset
    15
<h2><a name="import" id="import"></a>Importing the SDK example and leavescan plug-ins</h2>
cawthron
parents:
diff changeset
    16
<p>There are two example plugins you can import and examine as examples of Carbide.c++ API usage.</p>
cawthron
parents:
diff changeset
    17
<ul>
cawthron
parents:
diff changeset
    18
<li>The Examples plugin (<span class="code">com.nokia.carbide.cpp.sdk.examples</span>) is part of the Carbide.c++ Plug-in SDK. It
cawthron
parents:
diff changeset
    19
provides examples of installing items in the Carbide menu, creating new projects programatically, and accessing
cawthron
parents:
diff changeset
    20
project and Symbian build information. See <a href="#showExamplesMenu">below</a> for instructions on how to enable the example menu
cawthron
parents:
diff changeset
    21
commands inside carbide. </li>
cawthron
parents:
diff changeset
    22
<li>The leavescan plugin (com.nokia.carbide.cpp.leavescan) is part of the Carbide.c++ product installation with source code included.
cawthron
parents:
diff changeset
    23
The source code can help give you a basic understanding of how to access basic project configuration 
cawthron
parents:
diff changeset
    24
settings from the Carbide.c++ APIs.</li>
cawthron
parents:
diff changeset
    25
</ul>
cawthron
parents:
diff changeset
    26
<p>You can import these plugins into your workspace and view/debug all the source to get a better understanding of the 
cawthron
parents:
diff changeset
    27
Carbide.c++ APIs in a functional plugin.</p>
cawthron
parents:
diff changeset
    28
<p class="note"><strong>Note</strong> that the example plugins were built with JRE1.5, you will likely receive errors with JRE1.6. Select Window &gt; Preferences &gt; Java &gt; Installed JREs to add currently installed JREs and select the JRE to use.</p>
cawthron
parents:
diff changeset
    29
<ol>
cawthron
parents:
diff changeset
    30
  <li>Choose <b>File &gt; Import</b></li>
cawthron
parents:
diff changeset
    31
  <li> Choose<strong> Plug-in Development</strong> &gt; <strong>Plug-ins and Fragments</strong> from the <strong>Import</strong> wizard page.<br />
cawthron
parents:
diff changeset
    32
    <br />
cawthron
parents:
diff changeset
    33
  <img src="../img/Import_wizard_page.JPG" width="470" height="550"/> <br /> 
cawthron
parents:
diff changeset
    34
  </li>
cawthron
parents:
diff changeset
    35
  <li>On the Import Plug-ins and Fragments pages you select  import options. In the <strong>Import As</strong> group, select <strong>Projects with source folders</strong>. 
cawthron
parents:
diff changeset
    36
  In addition, note that <strong>The target platform (as specified in the Preferences)</strong> 
cawthron
parents:
diff changeset
    37
  checkbox should be enabled. This should be the path you specified previously in the Target Preferences.<br />
cawthron
parents:
diff changeset
    38
    <br />
cawthron
parents:
diff changeset
    39
  <img src="../img/plugins_and_frags_wizard.JPG" width="575" height="525"/> <br /> 
cawthron
parents:
diff changeset
    40
  </li>
cawthron
parents:
diff changeset
    41
  <li> Finally, select the plugins you want to import. Here you select the <code class="code">com.nokia.carbide.cpp.leavescan</code> and 
cawthron
parents:
diff changeset
    42
  <code class="code">com.nokia.carbide.cpp.sdk.examples</code> plugins.<br />
cawthron
parents:
diff changeset
    43
    <br />
cawthron
parents:
diff changeset
    44
  <img src="../img/plugin_selection_wizard.JPG" width="663" height="554"/> <br />
cawthron
parents:
diff changeset
    45
  </li>
cawthron
parents:
diff changeset
    46
  <li>When you are done importing you should have new plugins in your workspace and be able to view the 
cawthron
parents:
diff changeset
    47
  sources for both plugin projects. Your workspace should look something like this:<br />
cawthron
parents:
diff changeset
    48
    <br />
cawthron
parents:
diff changeset
    49
  <img src="../img/dev_ide_complete.JPG" width="1024" height="757"/></li>
cawthron
parents:
diff changeset
    50
</ol>
cawthron
parents:
diff changeset
    51
 <h3>Adding a Carbide menu</h3>
cawthron
parents:
diff changeset
    52
 <p>The menu items contributed by the Examples plugin are not visible by default in the Carbide.c++ program. To show the missing menu, follow these steps:</p>
cawthron
parents:
diff changeset
    53
<ol>
cawthron
parents:
diff changeset
    54
 <li>In Carbide.c++ (not in your Eclipse Java development SDK) choose <b>Window &gt; Customize Perspective...</b></li>
cawthron
parents:
diff changeset
    55
 <li>Select the <b>Commands</b> tab</li>
cawthron
parents:
diff changeset
    56
 <li>Select the checkbox for <b>Carbide.c++ Examples Action Set</b><br/>
cawthron
parents:
diff changeset
    57
   <br/>
cawthron
parents:
diff changeset
    58
 <img src="../img/show_examples_menu.jpg" width="711" height="501"/></li>
cawthron
parents:
diff changeset
    59
</ol>
cawthron
parents:
diff changeset
    60
 <p>Click OK, and you should now see the Carbide menu in the menu bar.</p>
cawthron
parents:
diff changeset
    61
   <div id="footer">Copyright &copy; 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></div>
cawthron
parents:
diff changeset
    62
</body>
cawthron
parents:
diff changeset
    63
</html>