Difference between revisions of "CompileProtege4InEclipse"

From Protege Wiki

Jump to: navigation, search
(Creating a Runnable for Windows or Linux)
(Creating a Runnable for OS X)
Line 44: Line 44:
 
== Creating a Runnable for OS X ==
 
== Creating a Runnable for OS X ==
  
OS X users have to work a bit harder to get a working runnable.  They
+
OS X users have to work a bit harder to get a working runnable.  I have figured out the following workaround but am looking for a better way.
need to checkout the ide project as a general project from svn at  
+
First, checkout the ide project as a general project from svn at http://smi-protege.stanford.edu/repos/protege/protege4/small-projects/ide/trunk. In the following instructions I assume that it is checked out as the project "ide".  Now the runnable can be created with the following steps:
http://smi-protege.stanford.edu/repos/protege/protege4/small-projects/ide/trunk.
+
# Click "Run -> Debug Configurations".  A dialog box will come up.
Then they must
+
# Select "Java Application" and click the "New" button at the top.
#  
+
# Change the name of the "New_Configuration" to something more meaningful.
# Set the working directory to ${workspace_loc:ide}.
+
# Select the "Main" tab and
# Set the classpath to be ide/org.eclipse.osgi.jar
+
## Change the "Main Class" to be org.eclipse.core.runtime.adaptor.EclipseStarter.
# Set the -D plugin.in vars
+
#Select the "Arguments" tab and
 +
## Set the working directory to ${workspace_loc:ide}.
 +
##Add the following -D options
 +
### -Dorg.protege.plugin.extra.0=${workspace_loc:com.owldl.pellet}
 +
### -Dorg.protege.plugin.extra.1=${workspace_loc:org.coode.dlquery}
 +
### -Dorg.protege.plugin.extra.2=${workspace_loc:org.coode.owlviz}
 +
### -Dorg.protege.plugin.extra.3=${workspace_loc:org.protege.editor.core.application}
 +
### -Dorg.protege.plugin.extra.4=${workspace_loc:org.protege.editor.owl}
 +
### -Dorg.protege.plugin.extra.5=${workspace_loc:org.semanticweb.owl.owlapi}
 +
# Select the "Classpath" tab and
 +
## Add ide/org.eclipse.osgi.jar as a jar to the class path.
 +
# Click "Apply" to save your changes
 +
# Click "Debug" to run the runnable.
  
 
At this point, mac users can create Eclipse Plug-in projects to create
 
At this point, mac users can create Eclipse Plug-in projects to create
 
their own plug-ins. But the
 
their own plug-ins. But the

Revision as of 13:52, February 4, 2009

Compile and run the Protege 4 OWL editor from Eclipse

This document is in progress. While it is not fully documented yet it does represent the recommended way to set up a protege 4 environment in eclipse. If this documentation is insufficient the fall back is to go to the generic ide instructions.

  1. Download the protege plug-ins with linked source. Currently these can be found [[1]] but soon there will be a standard download page connected to each of our releases.
  2. Create a new eclipse workspace
  3. Click "File -> Import..." This will bring up a dialog box.
  4. Choose "Plug-in Development -> Plug-ins and Fragments" and click "Next". This will bring up a dialog box.
  5. Unselect "The target platform (as specified in the Preferences)"
  6. Click the browse button and browse to the directory where you downloaded the protege plug-ins with linked source
  7. Don't worry about the warning at the top of the dialog box. The "Plug-ins and Fragments to Import" box should say "Select from all plug-ins..." and the "Import As" box should say "Binary projects".
  8. Click next bringing up a new dialog box.
  9. Click "Add All".
  10. Click "Finish"

This is a milestone. You should now see the Protege bundles as imported Plug-in projects.

Creating a Runnable for Windows or Linux

We now need to create a runnable. As far as I can tell Mac users cannot get the following steps to work. It is possible that this does work on intel macs but I have not been able to test this. There are claims made on the web saying that this issue is solved. ... Here ... is my current status on this issue. Mac users need to use an alternative method.

Windows and Linux users now do the following to make a runnable.

  1. Click "Run -> Debug Configurations". This will bring up a dialog box.
  2. Select "OSGi Framework" and click the "New" Icon at the top.
  3. Name the "New_Configuration" something useful like "Protege".
  4. In the Bundles box, scroll down to where it says "Target Platform". Unselect all the bundles from the target platform (one click to the left of "Target Platform")
  5. Click on "Add Required Bundles".
  6. Click "Apply" to save your changes.
  7. Click "Debug" and Protege should come up.

Windows and Linux users should now be able to easily use eclipse to develop their plug-ins. To start a new bundle just create a new Eclipse Plug-in project. These projects will automatically get attached to the Protege runnable.

Creating a Runnable for OS X

OS X users have to work a bit harder to get a working runnable. I have figured out the following workaround but am looking for a better way. First, checkout the ide project as a general project from svn at http://smi-protege.stanford.edu/repos/protege/protege4/small-projects/ide/trunk. In the following instructions I assume that it is checked out as the project "ide". Now the runnable can be created with the following steps:

  1. Click "Run -> Debug Configurations". A dialog box will come up.
  2. Select "Java Application" and click the "New" button at the top.
  3. Change the name of the "New_Configuration" to something more meaningful.
  4. Select the "Main" tab and
    1. Change the "Main Class" to be org.eclipse.core.runtime.adaptor.EclipseStarter.
  5. Select the "Arguments" tab and
    1. Set the working directory to ${workspace_loc:ide}.
    2. Add the following -D options
      1. -Dorg.protege.plugin.extra.0=${workspace_loc:com.owldl.pellet}
      2. -Dorg.protege.plugin.extra.1=${workspace_loc:org.coode.dlquery}
      3. -Dorg.protege.plugin.extra.2=${workspace_loc:org.coode.owlviz}
      4. -Dorg.protege.plugin.extra.3=${workspace_loc:org.protege.editor.core.application}
      5. -Dorg.protege.plugin.extra.4=${workspace_loc:org.protege.editor.owl}
      6. -Dorg.protege.plugin.extra.5=${workspace_loc:org.semanticweb.owl.owlapi}
  6. Select the "Classpath" tab and
    1. Add ide/org.eclipse.osgi.jar as a jar to the class path.
  7. Click "Apply" to save your changes
  8. Click "Debug" to run the runnable.

At this point, mac users can create Eclipse Plug-in projects to create their own plug-ins. But the

Personal tools