| <?php require_once($_SERVER['DOCUMENT_ROOT'] . "/eclipse.org-common/system/app.class.php"); require_once($_SERVER['DOCUMENT_ROOT'] . "/eclipse.org-common/system/nav.class.php"); require_once($_SERVER['DOCUMENT_ROOT'] . "/eclipse.org-common/system/menu.class.php"); $App = new App(); $Nav = new Nav(); $Menu = new Menu(); include($App->getProjectCommon()); |
| |
| $pageTitle = "Generating the SWT PI Code for Cocoa"; |
| |
| ob_start(); |
| ?> |
| <div id="midcolumn"> |
| <h1>Generating the SWT PI Code for Cocoa</h1> |
| |
| <p>Most of the platform interface and C code used by SWT on the Mac/Cocoa port is generated by the <b>MacGeneratorUI</b> |
| class included in the SWT Tools plugin available on the <a href="updatesite.php">SWT Tools Update Sites</a>. This page |
| describes how to use this tool when fixing bugs or adding features to SWT for cocoa.</p> |
| |
| <h3>Installing the plugin</h3> |
| |
| <ol> |
| <li>Install the plugin using the <a href="updatesite.php">SWT Tools Update Site</a>. |
| <p></p> |
| <li>Restart Eclipse and show the view <b>Mac Generator</b> from the <b>SWT Tools</b> category. |
| <p></p> |
| </ol> |
| |
| <h3>Using the tool</h3> |
| |
| <ol> |
| <li>The tool shows a list of Mac frameworks on the left side. |
| <p></p> |
| <p></p> |
| <center><img src="images/macgen.jpg" alt="MacGeneratorUI"></center> |
| <p></p> |
| <li>Items from the list can be checked to be generated. |
| <p></p> |
| <li>Once the desired items are checked, press the generate tool bar button to generate |
| all the necessary JNI code. This includes the java binding for Cocoa classes, |
| the C source for the JNI Natives and also supporting files for the tool. All files are under |
| <tt>Eclipse SWT PI/cocoa</tt> directory and if appropriate should be released. |
| <p></p> |
| <li>Compile the new C code. |
| <p><b> On Eclipse 3.5.1 and newer releases:</b></p> |
| To compile the code, right-click on the <tt>build.xml</tt> file in the |
| <tt>tasks</tt> directory, and choose |
| <i>"Run As -> Ant Build..."</i>. Select the JRE tab, and check "Run in the same JRE as the workspace". |
| Select the Targets tab, and check <b>build_cocoa_x86_and_ppc</b> or <b>build_cocoa_x86_64</b> according to |
| platform you wish to target. See the instructions at the beginning of the build.xml file for more |
| information. |
| <center><img src="images/buildxml2.png" alt="build.xml"></center> |
| <p></p> |
| <p><b> On Eclipse 3.5 and older releases:</b></p> |
| To compile the code, right-click on the <tt>build.xml</tt> file in the |
| <tt>Eclipse SWT PI/cocoa/library</tt> directory, and choose |
| <i>"Run As -> Ant Build..."</i>. Select the JRE tab, and check "Run in the same JRE as the workspace". |
| Select the Refresh tab, and check "Refresh resources upon completion" to refresh your workspace |
| after running the build to ensure Eclipse picks up the fresh binaries. Now select the "Run" button. |
| <p></p> |
| <center><img src="images/buildxml.png" alt="build.xml"></center> |
| <p></p> |
| <p></p> |
| </ol> |
| |
| </div> |
| <?php |
| $html = ob_get_clean(); |
| |
| # Generate the web page |
| $App->generatePage($theme, $Menu, $Nav, $pageAuthor, $pageKeywords, $pageTitle, $html); |
| ?> |