Skip to content
This repository has been archived by the owner on Jan 22, 2024. It is now read-only.

Development Environment

Jump to bottom
Chuck Dumont edited this page May 23, 2014 · 19 revisions

We primarily use eclipse(Indigo) when developing this project. We use maven to build it with the m2e and egit plugins in eclipse. Due to the presence of java.nio.files dependencies in jaggr-core, developers running from within eclipse should use a java7 jre/jdk for development and running the bundles out of the eclipse workspace. Maven will generate java6 compatible jars from the command line.

The project root consists of 3 child maven projects:

  1. jaggr-assembly
  2. jaggr-service - The aggregator core functionality
  3. jaggr-service - The aggregator OSGi specific functionality.
  4. jaggr-sample - A sample application that uses the aggregator.
  5. jaggr-sample-dojo - A sample bundle that provides dojo (currently 1.8) for the sample webapp.

Once all of the maven projects are imported into your workspace, you should build the parent project at least once (which will build the children projects and provide you with osgi bundles that you can deploy to a server to test)

You can build any of the projects by right clicking on it and choosing: Run As -> Maven build

Getting the source code

Note: These instructions may vary slightly over time.

  1. Ensure that you've installed egit and jgit too if you don't have git installed on your machine.
    You will also need to install m2e. We've had the best luck installing at least version 1.2 from the repository listed on the m2e site.
  2. Create a fork of this project and obtain the url for your fork (standard GitHub stuff)
  3. Right click -> Import...
    Import
  4. Choose Git -> Projects from Git, Next, then URI
  5. Fill in the info from step 2 and click Next
    git
  6. Chose the options that suit you on the next few screens
  7. When you get to the project import screen, choose to import the existing project
    gitwizard
  8. Select the jaggr project and choose finish. You should now have the jaggr project in your workspace.
  9. Right click on the jaggr project and choose Import... then Maven -> Existing Maven Projects
  10. Select the jaggr-assembly, jaggr-core, jaggr-service, jaggr-sample, and jaggr-sample-dojo projects and click finish.

Building the source code

There will probably be errors in your workspace after the projects are imported. This is normal if the maven build has not been run yet.

  1. Right click on the jaggr project and choose Run As -> Maven build...
  2. Fill in the Goals section, enter install and click Run
  3. This should kick off the maven build and build all 3 projects. After this parent build is done, you may build any of the children independently following the same steps as above.
Clone this wiki locally