Home > Developers > Wiki > Cheetah Developer Setup
Views

This page is about how to develop software on Cheetah. Right now this is specific to running the springapp2 spike (demo).

  • Use Eclipse Preferences to configure Eclipse to use Java 6 by default
  • Install Maven 2.0.9 or greater
  • 2.0.9 is required due to Maven bug MNG-2923 (noted fixed in 2.0.7, but actually fixed in 2.0.9)
  • Install plugins via Software Updates:
  • Install mysql for your platorm

Once you have the plugins, you should be able to check out and run the current cheetah snapshot.

SVN line endings

  • Set the "svn:eol-style" property to "native" on the command line or in Eclipse by doing the following:

About the project

  • You must do a maven build from the commandline before using WTP
  • For convenience, the project is set to build using the Eclipse Java builder, which does not use maven. If you want to update dependencies via maven or just be sure that the project is being built correctly, you must build using maven from the command line: mvn clean install - the Java builder does not completely build the project, but only builds the class files, ftl files, and properties files.
  • You can use the maven builder from inside eclipse, but be warned - it's annoying, as it touches many files, causing Eclipse to frequently pop up dialog boxes.
  • In the Navigator pane, right click on the project
  • Select Builders
  • Uncheck the Java builder to disable it.
  • Check the Maven2 builder to enable it.
  • Now you can right-click on the project, and select the M2 menu for maven goals.
  • The project uses PMD and FindBugs as poka-yoke (mistake proofing) tools to help us catch bugs before checking them into svn.

Import the cheetah trunk project from SVN

  • Navigator pane
  • Right click, select Import
  • Type svn in the search box
  • Select Checkout projects from SVN
  • Click Next
  • Create a new repository location: https://mifos.dev.java.net/svn/mifos/cheetah/trunk, click Next
  • Select the trunk/ directory, click Finish

Building

  • From the command line
  • mvn clean install will build the project, placing the war in the target/ directory. This will run the acceptance tests. To run only the unit tests, run 'mvn clean test'. To run only the acceptance tests, run 'mvn integration-test'.
  • More about the CheetahMavenBuild.
  • More about CheetahAcceptanceTests.
  • More about CheetahHudsonContinuousIntegration - our build server builds and tests automcatically, doublechecking the tests developers run on their desktop machines.

Configure PMD

  • No configuration should be necessary, as settings are checked into svn.
  • However, to see the settings:
  • General preferences are set in Window > Preferences > PMD
  • Project settings are here: Navigator Pane > right click > Properties > PMD

Configure FindBugs

  • No configuration should be necessary, as settings are checked into svn.
  • However, to see the settings:
  • Project settings are here: Navigator Pane > right click > Properties > Find Bugs

To see the Maven2 console:

  • Set Eclipse to build automatically.
  • Do Window > Show View > Console, then click the pushpin icon to "pin" the console.
  • Click the Console tab
  • Click the Window + icon and select Maven console from the drop down menu.
  • Click the Monitor triangle icon and select the Maven console.

To see the Tomcat console:

  • Click the console tab
  • Click the Window + icon and select new console.
  • Click the pushpin icon to "pin" the console.
  • Click the Window + icon and select Tomcat console from the drop down menu.
  • Click the Monitor triangle icon and select the Tomcat console.


subtopics:


Grameen logo