Differences between revisions 87 and 100 (spanning 13 versions)
← Revision 87 as of 2009-04-28 17:27:51 →
Size: 22358
Editor: KeiichiroOno
Comment:
← Revision 100 as of 2009-05-08 18:00:45 →
Size: 20719
Editor: KeiichiroOno
Comment:
Deletions are marked like this. Additions are marked like this.
Line 8: Line 8:
 * (!) Document revesion 1.3.1. Cytoscape IDE plugin is a bit out-of-date, so please install plugins one by one if you have any problems.: KeiichiroOno  * Document revesion 1.3.1. Cytoscape IDE plugin is a bit out-of-date, so please install plugins one by one if you have any problems.: KeiichiroOno
 * (!) Document revesion 1.4: Updated for Cytoscape IDE 0.1.1. This is not finished yet. Will be ready 5/8/2009: KeiichiroOno (5/7/2009)
Line 24: Line 25:
$ java -version
java version "1.5.0_16"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_16-b02)
Java HotSpot(TM) 64-Bit Server VM (build 1.5.0_16-b02, mixed mode)
}}}

=== 2. Maven (Command-Line version) ===
'''This step is no longer necessary. You can use embedded version of Maven if you use latest versions.'''

Although you will use most of the functions from Eclipse IDE, it is better to install command line version of Maven in case you need to test your code from terminal. Also, internally this version of Maven will be used by Eclipse (will be described later).
 * [[http://maven.apache.org/download.html|Download Maven]]
 * [[MavenInfo|Maven Tutorial]]
 * [[Cytoscape_3.0/Eclipse/M2EclipsePlugin|Introduction to Maven Integration for Eclipse]]

From terminal, type '''''mvn --version''''' and if you see something like the following, you are ready to use Maven:
 		java version "1.6.0_13"
Java(TM) SE Runtime Environment (build 1.6.0_13-b03)
Java HotSpot(TM) Client VM (build 11.3-b02, mixed mode)
}}}

I strongly recommend to use Java 6 if it is available for your platform.

=== 2. Eclipse PDE ===

  {{attachment:eclipse_plugins0.png}}

This tutorial is based on the latest version of Eclipse 3.4, called ''Ganymede''. Several distributions are available on [[http://www.eclipse.org/downloads/packages/|Eclipse web site]]. In this tutorial, we use '''''Eclipse for RCP/Plug-in Developers version 3.4'''''. This distribution includes PDE (Plugin development environment). '''''I recommend to install latest version of Eclipse PDE to a new directory on your machine. Otherwise, the screenshots may be different due to Eclipse plugins you have already installed on your machine'''''.

You can install Eclipse by just extracting archive file (zip/gzip) to a directoly of your choice. By default, the ''eclipse'' directory should look like the following:


  {{attachment:eclipse_default1.png}}

To keep your Eclipse up-to-date, you can update plugins by software updater (help-->software updates...)

==== For Windows Users: Set JDK JVM ====
Usually, Eclipse for Windows use JRE virtual machine instead of JDK's VM. To use JDK's VM, create a shortcut and edit the shortcut's property:
 
Line 41: Line 49:
$ mvn --version
Maven version: 2.0.9
Java version: 1.5.0_16
OS name: "linux" version: "2.6.18-92.1.13.el5" arch: "amd64" Family: "unix"
}}}

=== 3. Eclipse PDE ===

  {{attachment:eclipse_plugins0.png}}

This tutorial is based on the latest version of Eclipse 3.4, called ''Ganymede''. Several distributions are available on [[http://www.eclipse.org/downloads/packages/|Eclipse web site]]. In this tutorial, we use '''''Eclipse for RCP/Plug-in Developers version 3.4'''''. This distribution includes PDE (Plugin development environment). '''''I recommend to install latest version of Eclipse PDE to a new directory on your machine. Otherwise, the screenshots may be different due to Eclipse plugins you have already installed on your machine'''''.

You can install Eclipse by just extracting archive file (zip/gzip) to a directoly of your choice. By default, the ''eclipse'' directory should look like the following:


  {{attachment:eclipse_default1.png}}

To keep your Eclipse up-to-date, you can update plugins by software updater (help-->software updates...)


=== 4. Cytoscape IDE ===
==== Important Note ====
'''Not all of the plugins in this Eclipse plugin are up-to-date. If you want to use the latest versions of plugins, please try to install the following individually.'''
 * subclipse
 * m2eclipse
 * Spring IDE
 * Pax-Cursor

 		eclipse.exe -vm "c:¥path to jdk¥bin¥javaw.exe"
}}}

=== 3. Cytoscape IDE ===
Line 95: Line 78:
=== Replace Maven Executable Used in Eclipse ===
[[http://m2eclipse.codehaus.org/|m2eclipse plugin]] has embedded version of Maven, but it sometimes causes problems to work with PAX tools. To avoid this problem, you can use command-line version of Maven from Eclipse.

 1. Open '''''Preferences''''' window from '''''Window''''' menu
 1. Specify your local installation of Maven. '''''Note: this is not the bin directory, the root of Maven installation'''''

    {{attachment:maven1.png}}

 1. Set user '''''settings.xml''''' file location. This file can be copied from ''conf'' directory in the Maven root.
 1. Apply settings
Line 111: Line 82:
   * Eclipse 3.4 Ganymede (64 bit version)
   * Apache Maven 2.0.9
   * Subclipse Plugin 1.4.1
   * m2eclipse Plugin 0.9.5.20080717-1821
   * Pax Cursor Plugin 0.6.0 		   * Eclipse PDE 3.4.2 Ganymede
Line 118: Line 85:
   * RHEL 4 Workstation
   * Java SE 5 update 15

 * Test Platform 2 (Windows) __Still have some issues__
   * Windows XP SP3
   * JDK SE 6 update 7 '''''Important Note: You should use JDK, not JRE.'''''

 * Test Platform 3 (Mac) '''''Confirmed to work'''''
   * Mac OS X Tiger (10.4.11)
   * Apple's Java SE 5 (1.5.0_13) 		   * RHEL 5 Desktop 64 bit
   * Java SE 6 update 13 64 bit

 * Test Platform 2 (Windows) __Still have small issues__
   * Windows XP SP3 32 Bit
   * JDK SE 6 update 13 '''''Important Note: You should use JDK, not JRE.'''''

 * Test Platform 3 (Mac)
Line 137: Line 102:
 1. If you are a core developer, use '''''svn+ssh://grenache.ucsd.edu/common/svn'''''. You need id and apssword. Otherwise, use '''''http://chianti.ucsd.edu/svn'''''. You can checkout the project from this URL, but cannot checkin.  1. If you are a core developer, use '''''svn+ssh://grenache.ucsd.edu/common/svn'''''. You need id and pssword. Otherwise, use '''''http://chianti.ucsd.edu/svn'''''. You can checkout the project from this URL, but cannot checkin.
Line 145: Line 110:
 1. Click '''''Finish'''''  1. Make sure '''''Check out All projects''''' checkbox is unchecked. Then click '''''Finish'''''
Line 150: Line 115:

 1. You will be asked to select maven projects you want to import. Select '''top-level pom''' and '''application''' ONLY.

  {{attachment:select_pom.png}}
Line 154: Line 124:
== Step 3. Build Project and Run Cytoscape 3 on Felix ==
First, let's build and run Cytoscape 3 from Eclipse.

 1. Select '''''core''''' project on the workspace. Right click and select '''''Run As > Maven install'''''. This command builds and install Cytoscape 3 bundles to your local maven repository and it takes several minutes to complete (depends on your machine power). 		== Step 3. Build and Run Cytoscape 3 on OSGi Frameworks ==

  {{attachment:cs3_nimbus1.png}}

  ~-(Cytoscape 3 running on Windows XP + Java 6 update 13 with Nimbus L&F)-~

First, let's build and run Cytoscape 3 from Eclipse workspace.

 1. Select '''''core''''' project on the workspace. Right click and select '''''Run As > Maven install'''''. When you select this command, Eclipse builds and installs Cytoscape 3 bundles to your local maven repository ('''''$HOME/.m2'''''). It takes several minutes to complete (depends on your machine power).
Line 161: Line 136:
   * If you cannot complete this process due to failing tests, try the following:
      1. Select '''''Run > Run Configurations'''''
      1. Right-click Maven Build and create new setting
      1. Set '''''core''''' as the base directory
      1. Set '''''install''''' for ''goal'' and check '''''Skip Tests'''''
      1. '''''Apply''''' and '''''Run'''''

        {{attachment:maven_install2.png}}
   
   This is a workaround for failing tests in Windows environment. We are working on this issue and once it is solved, you can call ''install'' goal from right-click menu. 		 1. You will see the message in the console if it is successful.

  {{attachment:maven_install_success.png}}
Line 175: Line 143:
 1. Set the goal to '''''pax:provision'''''  1. Set the goal to '''''pax:run'''''

Checkout, Compile, and Test Cytoscape 3 Core on Eclipse

Status

  • Document revesion 1.0 release: KeiichiroOno

  • Document revesion 1.1 release. Fixed minor issues based on feedback: KeiichiroOno

  • Document revesion 1.2 release. OSGi Project Nature section added: KeiichiroOno

  • Document revesion 1.2.1 release. VM Argument added for look & feel problem: KeiichiroOno

  • Document revesion 1.3.0 release. Tutorial is based on CytoscapeIDE: KeiichiroOno

  • Document revesion 1.3.1. Cytoscape IDE plugin is a bit out-of-date, so please install plugins one by one if you have any problems.: KeiichiroOno

  • (!) Document revesion 1.4: Updated for Cytoscape IDE 0.1.1. This is not finished yet. Will be ready 5/8/2009: KeiichiroOno (5/7/2009)

Contents

  1. Checkout, Compile, and Test Cytoscape 3 Core on Eclipse
    1. Status
    2. Introduction
  2. Tutorial
    1. Step 1. Setup Your Environment
      1. 1. Java Development Kit (JDK)
      2. 2. Eclipse PDE
        1. For Windows Users: Set JDK JVM
      3. 3. Cytoscape IDE
        1. Note: My Testing Environment
    2. Step 2. Checkout and Create Cytoscape 3 Eclipse Project
      1. Checkout Cytoscape 3 Trunk
    3. Step 3. Build and Run Cytoscape 3 on OSGi Frameworks
      1. Add OSGi Project Nature
    4. Step 4. Debug Cytoscape 3 on Eclipse with PAX Cursor
      1. Working with Felix OSGi Console
    5. Notes
    6. Troubleshooting
    7. Appendix
      1. Install Required Eclipse Plugins One by One
          1. Subversion Client (Subclipse)
          2. PAX Cursor
          3. Maven Integration for Eclipse (m2eclipse)

Introduction

This tutorial is for Java developers who wants to learn how to checkout code, compile, and test Cytoscape 3 with Eclipse PDE and other Eclipse plugins.

Tutorial

Step 1. Setup Your Environment

To develop Cytoscape 3 on Eclipse, you need to install several software packages.

1. Java Development Kit (JDK)

You need to install JDK version 5 or 6. Should work on both 32 bit and 64 bit versions. I tested this tutorial with the following JDK: 

java version "1.6.0_13"
Java(TM) SE Runtime Environment (build 1.6.0_13-b03)
Java HotSpot(TM) Client VM (build 11.3-b02, mixed mode)

I strongly recommend to use Java 6 if it is available for your platform.

2. Eclipse PDE

  • eclipse_plugins0.png

This tutorial is based on the latest version of Eclipse 3.4, called Ganymede. Several distributions are available on Eclipse web site. In this tutorial, we use Eclipse for RCP/Plug-in Developers version 3.4. This distribution includes PDE (Plugin development environment). I recommend to install latest version of Eclipse PDE to a new directory on your machine. Otherwise, the screenshots may be different due to Eclipse plugins you have already installed on your machine.

You can install Eclipse by just extracting archive file (zip/gzip) to a directoly of your choice. By default, the eclipse directory should look like the following:

  • eclipse_default1.png

To keep your Eclipse up-to-date, you can update plugins by software updater (help-->software updates...)

For Windows Users: Set JDK JVM

Usually, Eclipse for Windows use JRE virtual machine instead of JDK's VM. To use JDK's VM, create a shortcut and edit the shortcut's property: 

eclipse.exe -vm "c:¥path to jdk¥bin¥javaw.exe"

3. Cytoscape IDE

  • cytoscape_ide1.png

You can install all required Elcipse plugins for Cytoscape 3 development at once by installing Cytoscape IDE Plugin for Eclipse.

  1. Select Help-->Software Updates...

  2. Select Available Software tab

  3. Click Add Site button and type http://chianti.ucsd.edu/kono/cyide in the Location text box. Then press OK.

    • cytoscape_ide2.png

  4. Eclipse automatically scans the location and displays available plugins. You have to choose only one plugin, Cytoscape IDE for Eclipse

    • cytoscape_ide3.png

  5. Press Install button and follow instructions. This process takes several minutes because it installes lots of plugins at once. When installation is complete, you will be asked to restart Eclipse. Press Yes and restart Eclipse.

  6. Select Window-->Open Perspective-->Other. Then you can find Cytoscape IDE as a new perspective. Select it and press OK

    • cytoscape_ide4.png

  7. If your workspace layout looks like the following, Eclipse is ready to develop Cytoscape 3.

    • cytoscape_ide5.png

Note: My Testing Environment

I've tested the following tutorial on these platforms:

  • Common
    • Eclipse PDE 3.4.2 Ganymede

  • Test Platform 1 (Unix) Confirmed to work

    • RHEL 5 Desktop 64 bit
    • Java SE 6 update 13 64 bit

  • Test Platform 2 (Windows) Still have small issues

    • Windows XP SP3 32 Bit

    • JDK SE 6 update 13 Important Note: You should use JDK, not JRE.

  • Test Platform 3 (Mac)

Step 2. Checkout and Create Cytoscape 3 Eclipse Project

In this section, you will learn how to create an Eclipse project from the fresh Cytoscape 3 checkout.

Checkout Cytoscape 3 Trunk

  1. Start Eclipse. I recommend to use an empty, new workspace only for Cytoscape 3 project since it creates tons of new bundle projects in your workspace. Make sure Cytoscape IDE perspective is selected.

  2. <!> Turn off automatic build. (uncheck Project > Build Automatically)

  3. Select SVN Repository tab. Cytoscape subversion repository will appear automatically.

  4. If you are a core developer, use svn+ssh://grenache.ucsd.edu/common/svn. You need id and pssword. Otherwise, use http://chianti.ucsd.edu/svn. You can checkout the project from this URL, but cannot checkin.

  5. The Cytoscape 3 repository is cytoscape3/trunk.

    • eclipse_repository1.png

  6. From SVN Repository window, right-click cytoscape3 > trunk and select Check out as Maven project...

  7. Select Source Code Management (SCM) system type to svn and make sure the URL is set to http://chianti.ucsd.edu/svn/cytoscape3/trunk (for core developers, svn+ssh://grenache.ucsd.edu/common/svn/cytoscape3/trunk).

  8. Make sure Check out All projects checkbox is unchecked. Then click Finish

    • eclipse_core11.png

    This process takes 5-10 minutes depends on your network connection.

  9. You will be asked to select maven projects you want to import. Select top-level pom and application ONLY.

    • select_pom.png

  10. Select Package Explorer tab. Your Eclipse workspace looks like the following:

    • eclipse_ws_default.png

Step 3. Build and Run Cytoscape 3 on OSGi Frameworks

  • cs3_nimbus1.png

    (Cytoscape 3 running on Windows XP + Java 6 update 13 with Nimbus L&F)

First, let's build and run Cytoscape 3 from Eclipse workspace.

  1. Select core project on the workspace. Right click and select Run As > Maven install. When you select this command, Eclipse builds and installs Cytoscape 3 bundles to your local maven repository ($HOME/.m2). It takes several minutes to complete (depends on your machine power).

    • maven_install.png

  2. You will see the message in the console if it is successful.

    • maven_install_success.png

  3. Select Run → Run Configurations

  4. Create new Maven Build and name it

  5. Set the Base directory to core bundle

  6. Set the goal to pax:run

    • eclipse_core20.png

  7. Apply and Run. You can use Felix Shell commands on the console.

    • eclipse_core21.png

  8. Quit Cytoscape

Add OSGi Project Nature

At this point, each project in your workspace is defined as Maven Project and Eclipse can handle maven-specific features including dependency management and maven style source code directory structure. You can also add one more project nature to view/edit OSGi metadata file MANIFEST.MF by adding OSGi project nature.

  1. Select Run > Run Configurations...

  2. Create new Maven Build

  3. Name it Add OSGi Project Nature

  4. Click Browse Workspace and select project you want to add OSGi project nature. In this example, attribute browser project is selected.

  5. Set pax:eclipse for goals

  6. Apply and Run. This process may take 1-5 minutes depends on your network connection because it downloads source code of the dependent libraries from public repository.

    • osgi_nature1.png

  7. Once it is done, refresh the workspace (press F5). You can see META-INF directory and under the folder, you can find MANIFEST.MF file. This is the metadata

    • osgi_nature2.png

Editing this metadata file by writing BND statements is beyond the scope of this tutorial and will be discussed later in Plugin Development section. However by using this feature, you can see what packages are available for the selected project (bundle), and what packages will be exported as public API.

  • osgi_nature3.png

Step 4. Debug Cytoscape 3 on Eclipse with PAX Cursor

In this section, you will learn how to debug Cytoscape 3 on Eclipse.

  1. First, let's set a sample break point in CytoscapeInit class, which is the class to startup Cytoscape. It is in application/src/main/java/cytoscape/CytoscapeInit.java. You can set breakpoint anywhere in the public boolean init(CyInitParams params) method.

    • debug0.png

      pax0.png

  2. From Eclipse main window, select Run → Debug Configurations

  3. Right click on OSGi Framework and select New

  4. Name the configuration Cytoscape 3

  5. Switch framework to Felix 1.0.4

  6. None of the files should be selected in the bundle list

    • pax1.png

  7. Click Arguments tab

  8. Add the following VM Arguments 

    -Xbootclasspath/a:bundles/com.jgoodies.looks_2.1.2.jar:bundles/cytoscape-sun.jhall_1.0.0.jar

    • pax100.png

  9. Click the Pax Cursor tab

  10. Click Add Pom. Then select pom file under runner directory. To get the deploy-pom.xml file to show, you have to change the File of type ComboBox to have Any File.

    • pax2.png

  11. Apply and Debug

    • [ATTACH]

  12. Now you can see Cytoscape running on Felix and debugger shows current status of variables

    • pax4.png

    Just like other applications, Eclipse debugger stops execution at the break-point you specified in the source code. To start again, you need to press green triangle (Resume button).

    • [ATTACH]

Basically, the debugging process is same as regular Java projects. Once you edit something in the source code, you can rebuild and deploy it to local repository by Maven install command. Then you can repeat the procedure above to check internal states of Cytoscape 3 by Eclipse debugger.

Working with Felix OSGi Console

Cytoscape 3 is an OSGi application and you can check the status of bundles from OSGi console. After you start Cytoscape 3 from Eclipse, you can see a prompt on the Console window (if not, hit enter in the console to show the prompt). The following is some useful command to check internal states of the OSGi system. For more information, please visit [Felix web site].

  • help - display help message 

    -> help
bundlelevel <level> <id> ... | <id> - set or get bundle start level.
cd [<base-URL>]                     - change or display base URL.
headers [<id> ...]                  - display bundle header properties.
help                                - display impl commands.
install <URL> [<URL> ...]           - install bundle(s).
packages [<id> ...]                 - list exported packages.
ps [-l | -s | -u]                   - list installed bundles.
refresh [<id> ...]                  - refresh packages.
resolve [<id> ...]                  - attempt to resolve the specified bundles.
services [-u] [-a] [<id> ...]       - list registered or used services.
shutdown                            - shutdown framework.
start <id> [<id> <URL> ...]         - start bundle(s).
startlevel [<level>]                - get or set framework start level.
stop <id> [<id> ...]                - stop bundle(s).
uninstall <id> [<id> ...]           - uninstall bundle(s).
update <id> [<URL>]                 - update bundle.
version                             - display version of framework.

  • ps - List loaded bundles 

    -> ps
START LEVEL 4
   ID   State         Level  Name
[   0] [Starting   ] [    0] System Bundle (1.0.4)
[   1] [Active     ] [    4] cytoscape.util.intr [cytoscape] (1.0.0.SNAPSHOT)
[   2] [Active     ] [    4] cytoscape.graph.fixed [cytoscape] (1.0.0.SNAPSHOT)
[   3] [Active     ] [    4] cytoscape.graph.dynamic [cytoscape] (1.0.0.SNAPSHOT)
[   4] [Active     ] [    4] org.cytoscape.network [org.cytoscape] (1.0.0.SNAPSHOT)
[   5] [Active     ] [    4] cytoscape.render.immed [cytoscape] (1.0.0.SNAPSHOT)
[   6] [Active     ] [    4] cytoscape.geom.spacial [cytoscape] (1.0.0.SNAPSHOT)
[   7] [Active     ] [    4] cytoscape.render.stateful [cytoscape] (1.0.0.SNAPSHOT)
[   8] [Active     ] [    4] cytoscape.geom.rtree [cytoscape] (1.0.0.SNAPSHOT)
[   9] [Active     ] [    4] cytoscape.render.export [cytoscape] (1.0.0.SNAPSHOT)
[  10] [Active     ] [    4] org.cytoscape.attributes (1.0.0.SNAPSHOT)
[  11] [Active     ] [    4] org.cytoscape.tunable (1.0.0.SNAPSHOT)
[  12] [Active     ] [    4] cytoscape.task [cytoscape] (1.0.0.SNAPSHOT)
[  13] [Active     ] [    4] phoebe.dnd [phoebe] (1.0.0.SNAPSHOT)
[  14] [Active     ] [    4] undo (1.0.0.SNAPSHOT)
[  15] [Active     ] [    4] org.cytoscape.view (1.0.0.SNAPSHOT)
[  16] [Active     ] [    4] org.apache.commons.cli             [org.apache] (1.0.0.SNAPSHOT)
[  17] [Active     ] [    4] Apache Commons Lang (2.4.0)
[  18] [Active     ] [    4] org.cytoscape.layout (1.0.0.SNAPSHOT)
[  19] [Active     ] [    4] org.cytoscape.vizmap (1.0.0.SNAPSHOT)
[  20] [Starting   ] [    4] cytoscape.application              [cytoscape] (1.0.0.SNAPSHOT)
[  21] [Resolved   ] [    4] JDOM DOM Processor (1.0.0)
[  22] [Resolved   ] [    4] Java Activation API (1.1.0)
[  23] [Installed  ] [    4] Concurrent (1.3.4)
[  24] [Resolved   ] [    4] Lowagie iText (2.0.8)
[  25] [Installed  ] [    4] csplugins.automatic.layout [csplugins] (1.0.0.SNAPSHOT)
 .
 .
 .

  • services - show list of available OSGi Services

  • services BUNDLE_ID - show detail of services abailable from the bundle 

    -> services 25

csplugins.automatic.layout [csplugins] (25) provides:
-----------------------------------------------------
name = force-directed
objectClass = org.cytoscape.layout.CyLayoutAlgorithm
preferredMenu = Cytoscape Layouts
service.id = 21
----
name = circular
objectClass = org.cytoscape.layout.CyLayoutAlgorithm
preferredMenu = Cytoscape Layouts
service.id = 22
----
name = hierarchical
objectClass = org.cytoscape.layout.CyLayoutAlgorithm
preferredMenu = Cytoscape Layouts
service.id = 23
----
.
.
.

  • services -u - show usage of services. 

    -> services -u

System Bundle (0) uses:
-----------------------
org.osgi.service.startlevel.StartLevel

org.cytoscape.layout (18) uses:
-------------------------------
org.cytoscape.layout.CyLayoutAlgorithm
org.cytoscape.layout.CyLayoutAlgorithm
org.cytoscape.layout.CyLayoutAlgorithm
org.cytoscape.layout.CyLayoutAlgorithm
org.cytoscape.layout.CyLayoutAlgorithm

  • services -u BUNDLE_ID - show more detail about service usage of the bundle 

    org.cytoscape.layout (18) uses:
-------------------------------
name = force-directed
objectClass = org.cytoscape.layout.CyLayoutAlgorithm
preferredMenu = Cytoscape Layouts
service.id = 21
----
name = circular
objectClass = org.cytoscape.layout.CyLayoutAlgorithm
preferredMenu = Cytoscape Layouts
service.id = 22
----
name = hierarchical
objectClass = org.cytoscape.layout.CyLayoutAlgorithm
preferredMenu = Cytoscape Layouts
service.id = 23
----
.
.
.

Note: The behaviour of Cytoscpae 3 running on Felix will be different from time to time. This is because budle loading timing is not properly controlled now. This will be solved by organizing bundle/service dependency. I'm working on this issue now and hopefully it will be solved soon.

Notes

Now you are ready to hack Cytoscape 3 on Eclipse. As you can see on your workspace, Cytoscape 3 is a collection of OSGi bundles. Each bundle is built as a Maven project and has a pom.xml file.

Currently, the desktop version of Cytoscape 3 is called application bundle. Under src/main/java you can see the source tree. You can edit these source files just like 2.x series, and create the bundle by running maven commands. To run them, you need to select (right click) the project name and then select maven command from Run As menu:

  • eclipse_core6.png

  • maven clean - clean all classes from target directory.
  • maven install - build everything under the selected project, create bundles, run tests, and install them to your local Maven repository

To run your modified code, you just need to do maven install and run debugger.

Troubleshooting

  1. Somehow Cytoscape 3 Eclipse project is broken and I cannot compile it anymore

    • From terminal, run mvn pax:clean pax:eclipse. This cleans up everything and gives you a fresh workspace.

  2. pax:provision fails. What should I do?

    • Cleaning up the working space (maven clean) and rebuilding it (maven install) solves this problem in most cases.

  3. Cannot compile application bundle. Eclipse display some warning messages and cannot complete install goal

    • Comment out following lines in pom.xml in core directory: 

      • <showWarnings>true</showWarnings>
<showDeprecation>true</showDeprecation>
      We are working on this problem.

  4. Eclipse and Cytoscape are frozen after splashscreen is displayed. What happened?

    • On Windows, somehow Felix shell waits user's key entry after Cytoscape displays splashscreen. To proceed, you need to hit enter key in the console window (see below):

      • ts1.png

Appendix

Install Required Eclipse Plugins One by One

  • eclipse_plugins1.png

Subversion Client (Subclipse)

Cytoscape 3 source code is managed by Subversion. To access the repository, you need to install subversion client for Eclipse. In this tutorial, I'll use Subclipse. You can install the plugin from the eclipse's update manager. Do not forget to install SVNKit. Otherwise, you will get an error message when you try to check out repository ("Unable to load default SVN Client")

You can install the Subclipse plugin from Help > Software Updates... Click Available Software tab and add this URL by pressing Add Site button: http://subclipse.tigris.org/update_1.4.x

PAX Cursor

PAX Cursor is an Eclipse plugin developed by OPS4J developers. Basically, it is an Eclipse integration for PAX-Runner. By this plugin, you can run set of bundles on multiple platforms including Felix, Equinox, and Knopflerfish.

To install this Eclipse plugin, just follow the standard plugin installation procedure discussed above.

Maven Integration for Eclipse (m2eclipse)

Cytoscape build system has been moved to Maven. To use maven from Eclipse, you need to follow this instruction. Even if you run all maven commands from Eclipse, you still need to install command-line version of Maven since Eclipse embedded version of maven have issues to execute some maven goals.

This document is written by KeiichiroOno

If you have any questions, please e-mail me (kono at ucsd dot edu. English or Japanese)

Outdated_Cytoscape_3.0/Eclipse/CoreDevelopment (last edited 2011-02-24 15:54:45 by PietMolenaar)

Funding for Cytoscape is provided by a federal grant from the U.S. National Institute of General Medical Sciences (NIGMS) of the Na tional Institutes of Health (NIH) under award number GM070743-01. Corporate funding is provided through a contract from Unilever PLC.

MoinMoin Appliance - Powered by TurnKey Linux