10 --> |
10 --> |
11 </style> |
11 </style> |
12 </head> |
12 </head> |
13 <body bgcolor="#FFFFFF"> |
13 <body bgcolor="#FFFFFF"> |
14 |
14 |
15 <h2><a name="import" id="import"></a>Importing the SDK example and leavescan plug-ins</h2> |
15 <h2><a name="import" id="import"></a>Importing the SDK Example </h2> |
16 <p>There are two example plugins you can import and examine as examples of Carbide.c++ API usage.</p> |
16 <p>You can import any of the plug-ins in Carbide.c++ and examine the source code. However, the SDK provides a plug-in you can import and examine as an example of Carbide.c++ API usage.</p> |
17 <ul> |
17 <ul> |
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 |
18 <li>The Examples plugin (<span class="code">com.nokia.carbide.cpp.sdk.examples</span>) is part of the Carbide.c++ Development Kit (CDK). It |
19 provides examples of installing items in the Carbide menu, creating new projects programatically, and accessing |
19 provides examples of installing items in the Carbide menu, creating new projects programatically, and accessing |
20 project and Symbian build information. See <a href="#showExamplesMenu">below</a> for instructions on how to enable the example menu |
20 project and Symbian build information. See <a href="#showExamplesMenu">below</a> for instructions on how to enable the example menu |
21 commands inside carbide. </li> |
21 commands inside carbide. </li> |
22 <li>The leavescan plugin (com.nokia.carbide.cpp.leavescan) is part of the Carbide.c++ product installation with source code included. |
|
23 The source code can help give you a basic understanding of how to access basic project configuration |
|
24 settings from the Carbide.c++ APIs.</li> |
|
25 </ul> |
22 </ul> |
26 <p>You can import these plugins into your workspace and view/debug all the source to get a better understanding of the |
23 <p>You can import this and other plugins into your workspace and view/debug all the source to get a better understanding of the |
27 Carbide.c++ APIs in a functional plugin.</p> |
24 Carbide.c++ APIs in a functional plugin. Plesae see the page on <a href="env_setup.htm">setting up your development environment</a> for information on how to import a source project. </p> |
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 > Preferences > Java > Installed JREs to add currently installed JREs and select the JRE to use.</p> |
25 <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 > Preferences > Java > Installed JREs to add currently installed JREs and select the JRE to use.</p> |
29 <ol> |
26 <p class="note">When you are done importing you should have new plugins in your workspace and be able to view the |
30 <li>Choose <b>File > Import</b></li> |
27 sources for both plugin projects. Your workspace should look something like this:<br /> |
31 <li> Choose<strong> Plug-in Development</strong> > <strong>Plug-ins and Fragments</strong> from the <strong>Import</strong> wizard page.<br /> |
28 <br /> |
32 <br /> |
29 <img src="../img/dev_ide_complete.JPG" width="1024" height="757"/></p> |
33 <img src="../img/Import_wizard_page.JPG" width="470" height="550"/> <br /> |
30 <h3>Adding a Carbide menu</h3> |
34 </li> |
|
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>. |
|
36 In addition, note that <strong>The target platform (as specified in the Preferences)</strong> |
|
37 checkbox should be enabled. This should be the path you specified previously in the Target Preferences.<br /> |
|
38 <br /> |
|
39 <img src="../img/plugins_and_frags_wizard.JPG" width="575" height="525"/> <br /> |
|
40 </li> |
|
41 <li> Finally, select the plugins you want to import. Here you select the <code class="code">com.nokia.carbide.cpp.leavescan</code> and |
|
42 <code class="code">com.nokia.carbide.cpp.sdk.examples</code> plugins.<br /> |
|
43 <br /> |
|
44 <img src="../img/plugin_selection_wizard.JPG" width="663" height="554"/> <br /> |
|
45 </li> |
|
46 <li>When you are done importing you should have new plugins in your workspace and be able to view the |
|
47 sources for both plugin projects. Your workspace should look something like this:<br /> |
|
48 <br /> |
|
49 <img src="../img/dev_ide_complete.JPG" width="1024" height="757"/></li> |
|
50 </ol> |
|
51 <h3>Adding a Carbide menu</h3> |
|
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> |
31 <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> |
53 <ol> |
32 <ol> |
54 <li>In Carbide.c++ (not in your Eclipse Java development SDK) choose <b>Window > Customize Perspective...</b></li> |
33 <li>In Carbide.c++ (not in your Eclipse Java development SDK) choose <b>Window > Customize Perspective...</b></li> |
55 <li>Select the <b>Commands</b> tab</li> |
34 <li>Select the <b>Commands</b> tab</li> |
56 <li>Select the checkbox for <b>Carbide.c++ Examples Action Set</b><br/> |
35 <li>Select the checkbox for <b>Carbide.c++ Examples Action Set</b><br/> |
57 <br/> |
36 <br/> |
58 <img src="../img/show_examples_menu.jpg" width="711" height="501"/></li> |
37 <img src="../img/show_examples_menu.jpg" width="711" height="501"/></li> |
59 </ol> |
38 </ol> |
60 <p>Click OK, and you should now see the Carbide menu in the menu bar.</p> |
39 <p>Click OK, and you should now see the Carbide menu in the menu bar. You can now examine the source code and run it in the debugger. See <a href="launchconfig.htm">debugging a debugging a Carbide.c++ plug-in</a> for information on setting up a plug-in debug session. </p> |
61 <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></div> |
40 <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></div> |
62 </body> |
41 </body> |
63 </html> |
42 </html> |