Skip to main content

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
[stellation-res] Easier setup in Eclipse: here it is.

Hello guys,

As an Eclipse user, I found the description on how to setup things
overly complex. So I invested a little time to make things much easier.

1) Eclipse has an Update Manager to install new and update existing
plugins. Stellation requires a number of third-party libraries (ORO,
Log4J, JDOM and JDBC drivers. Except for the JDBC drivers, I have
packaged the other three libraries as plugins and these are installable
now through the Update Manager. The "setting_up_html_patch.txt" file in
attachment contains the changes to the Eclipse set up documentation.

2) Now that you have the plugins available in your Eclipse workbench,
you can just select these plugins as required plugins for the
Stellation core plugin. The "core_plugin_xml_patch.txt" is a patch
against plugin.xml file of the Stellation core plugin. 

3) By setting up everything using required plugins instead of
additional runtime libraries, the SWT variable was no longer needed in
the Stellation UI plugin. I removed all the documentation of setting
the SWT variable in Eclipse from the Eclipse set-up documentation.

Hope everything is clear. If not, put your questions on the mailing
list!

Ringo

__________________________________________________
Do You Yahoo!?
Everything you'll ever need on one web page
from News and Sport to Email and Music Charts
http://uk.my.yahoo.com
Index: plugin.xml
===================================================================
RCS file: /home/technology/org.eclipse.stellation/plugins/org.eclipse.stellation.core/plugin.xml,v
retrieving revision 1.1
diff -u -r1.1 plugin.xml
--- plugin.xml	5 Jul 2002 00:23:58 -0000	1.1
+++ plugin.xml	17 Jul 2002 07:53:13 -0000
@@ -9,21 +9,15 @@
       <library name="scmcore.jar">
          <export name="*"/>
       </library>
-      <library name="jakarta-oro-2.0.6.jar">
-         <export name="*"/>
-      </library>
       <library name="jdbc7.2dev-1.2.jar">
          <export name="*"/>
       </library>
-      <library name="jdom.jar">
-         <export name="*"/>
-      </library>
-      <library name="log4j.jar">
-         <export name="*"/>
-      </library>
    </runtime>
    <requires>
       <import plugin="org.apache.xerces"/>
+      <import plugin="org.apache.log4j" version="1.2.5"/>
+      <import plugin="org.apache.oro"/>
+      <import plugin="org.jdom"/>
    </requires>
 
 
Index: setting-up.html
===================================================================
RCS file: /home/technology/org.eclipse.stellation/plugins/org.eclipse.stellation.misc/doc/manuals/setting-up.html,v
retrieving revision 1.1
diff -u -r1.1 setting-up.html
--- setting-up.html	14 Jul 2002 21:45:12 -0000	1.1
+++ setting-up.html	17 Jul 2002 08:19:09 -0000
@@ -64,11 +64,7 @@
     projects into your Eclipse workspace. Before you can do this,
     there's a bit of preparation that needs to be done.</p>
 
-    <p>First, create a directory "~/stellation/lib". This is where
-    you'll be putting copies of the libraries that Stellation
-    requires for the command-line tool.</p>
-
-    <p>Next, download and install the things that Stellation
+    <p>Download and install the things that Stellation
     depends on</p>
 
     <ol>
@@ -84,27 +80,28 @@
         "jdbc7.2dev-1.2.jar" for later.</p>
       </li>
 
-      <li><i>JDOM</i>. An XML manipulation library downloadable
-      from <a target="_top" href="www.jdom.org">jdom.org</a>. Put the jdom jar in
-      "~/stellation/lib", under the name "jdom.jar".</li>
-
-      <li><i>log4j</i>. A flexible logging package from the Apache
-      jakarta project. Downloadable from <a target="_top" href=
-      "http://jakarta.apache.org/log4";>apache.org</a>. Put the
-      log4j jar in "~/stellation/lib/log4j.jar".</li>
-
-      <li><i>Xerces</i>. You need the xerces jars that come with
-      Eclipse. These can be found under your eclipse installation
-      under
-      <code>"eclipse/plugins/org.apache.xerces_4.0.3/"</code>. Copy
-      the two jars from this directory into
-      "~/stellation/lib".</li>
-
-      <li><i>ORO</i>. ORO is a regular expression matching project
-      from <a target="_top" href=
-      "http://jakarta.apache.org/oro";>jakarta.apache.org</a>. We
-      currently use version 2.0.6. Copy the jar to
-      "~/stellation/lib/jakarta-oro-2.0.6.jar".</li>
+      <li><i>JDOM</i>,<i>log4j</i> and <i>ORO</i>. These three libraries
+      have been packaged as an Eclipse plugin by 
+      <a href="mailto:ridesmet@xxxxxxxxxxxxxxxxxxxxx";>Ringo De Smet</a>.
+      To install these, you can use the Eclipse Update Manager. The
+      Update Manager can be started through the <i>Help</i> menu,
+      <v>Software Updates</i> and then <i>Update Manager</i>.
+      In the <i>Feature Updates</i> window, open the popup menu on
+      <i>Sites to Visit</i> and select <i>New...</i> -> <i>Site Bookmark</i>.
+      Fill in a name and use the following URL:
+      <p>
+      <CODE>http://idisk.mac.com/ridesmet/Public/eclipse/updates</CODE>
+      <p>
+      Press the <i>Finish</i> button to close the dialog. A new entry 
+      should have been added now. Expand this entry until you see
+      the Log4J, ORO and JDOM leaf elements. One by one, select
+      a package and press the <i>Install</i> button in the <i>Preview</i>
+      pane. Follow the on-screen instructions.
+      <p></li>
+
+      <li><i>Xerces</i>. This XML parser is already provided by the
+      Eclipse 2.0 distribution.</li>
+
     </ol>
 
     <h2>Checking Out into Eclipse</h2>
@@ -119,59 +116,6 @@
       application" radio button, the click "Select All", then
       "Apply".</li>
 
-      <li>
-        Now select "Preferences/Java/Classpath Variables". You
-        should see defined variables for "ECLIPSE_HOME" and a
-        number of "JRE_" and "_ORG_ECLIPSE_" variables. 
-
-        <p>You must add a variable for the version of SWT used on
-        in your Eclipse installation (this is a build-time platform
-        dependency, but -- hopefully -- not an issue for a regular
-        deployed plugin).</p>
-
-        <p>To add the SWT variable:</p>
-
-        <ul>
-          <li>Note the value of the ECLIPSE_HOME variable.</li>
-
-          <li>Click the New button (New Variable Entry dialog
-          should appear)</li>
-
-          <li>Enter SWT as the name, then click the File button
-          (Jar Selection dialog should appear)</li>
-
-          <li>Navigate manually to wherever your copy of Eclipse is
-          installed (Yes, I know this is a pain). To do this,
-          change the value of the Filter textfield at the top of
-          the dialog to the value of ECLIPSE_HOME, followed by
-          '/plugins/*'. On my system, ECLIPSE_HOME is opt/eclipse,
-          so I use the Filter value '/opt/eclipse/plugins/*'. BTW -
-          do NOT change the Selection field value at the bottom of
-          the dialog; it seems like it should work, but it
-          doesn't.</li>
-
-          <li>In the list box, scroll down to the
-          org.eclipse.swt.PLATFORM_2.0.0 item. On my system (using
-          Motif), this is org.eclipse.swt.motif_2.0.0. Other
-          platforms are (presumably) something like
-          org.eclipse.swt.gtk_2.0.0, org.eclipse.swt.win32_2.0.0,
-          etc.</li>
-
-          <li>Double-click on the SWT item you just found. The list
-          box should now contain four items. Double-click on the
-          path item ending '/ws'.</li>
-
-          <li>There are now three list items visible (On my system,
-          at least). Double-click the 'ws/PLATFORM' item (on my
-          system: 'ws/motif')</li>
-
-          <li>The Files list (righthand side of dialog) should now
-          display 'swt.jar' Click on set.jar, and then click the OK
-          button; then click OK again (in the 'Edit Variable Entry'
-          dialog).</li>
-        </ul>
-      </li>
-
       <li>Now, finally, you're ready to import the Stellation
       projects. To do this, open the CVS Repository Explorer in
       Stellation, and create a new Repository Location using the
@@ -187,9 +131,9 @@
       <li>For each of the directories under plugin, right-click and
       select "Check out as project".</li>
 
-      <li>Once this is done, copy the jars from "~/stellation/lib"
+      <li>Once this is done, copy PostgreSQL JDBC drivers jar
       into the "org.eclipse.stellation.core" directory. Then,
-      refresh org.eclipse.stellation.core so that the jars are
+      refresh org.eclipse.stellation.core so that the jar is
       visible in the Navigator.</li>
 
       <li>Finally, re-enable autobuild, and do a "Rebuild

Back to the top