Note: If you want to develop on the new MifosX platform, then refer to this page: Getting started - Contributing to MifosX
This page is about how to develop the Mifos platform.
- Install Eclipse JEE Helios http://www.eclipse.org/downloads/, see Workspace 2.0
- Install Java 6 for your platform
- Use Eclipse Preferences to configure Eclipse to use Java 6 by default. Note that this must be a 32-bit build, not a 64-bit build.
- If you use a Mac, see Mifos Mac OS X Install
- Install Maven 3.x
- Install plugins via Software Updates:
- Install Maven Integration for Eclipse Plugin - eclipse update site URL
- Install TestNG Eclipse Plugin - eclipse update site URL
- Install Freemarker IDE plugin (via JBoss Tools download site) (optional) http://download.jboss.org/jbosstools/updates/stable
- Install EGit plugin - home page, eclipse update site URL
- Install the PMD plugin http://pmd.sourceforge.net/eclipse
- Install the FindBugs plugin http://findbugs.cs.umd.edu/eclipse/
- Install mysql for your platform
Once you have the plugins, you should be able to check out get the code, build, and run the latest trunk codeMifos.
| Warning |
|---|
Workspace 2.0 deprecates much of this page, see Workspace 2.0 first. |
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 source control.
...
- 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 Maven Build.
- More about Running Acceptance Tests.
- More about Hudson Continuous Integration - our build server builds and tests automcatically, doublechecking the tests developers run on their desktop machines.
Configure Eclipse
Please apply the following Workspace (not Project) Preferences
...
:
- General > Content Types > Java Properties File : Default encoding, type "UTF-88 " and click Update
- because Mifos Translation .properties files are UTF-8 8 encoded (while standard Java properties files are ISO-88598859 -1); see MIFOS-4851 4851 for some background about this
- General > Editors > Text Editors > Insert spaces for tabs (instead of tabs)
- Web > CSS Files > Editor > Indent using spaces (instead of tabs)
- Web > HTML Editor > Indent using spaces (instead of tabs)
- XML > XML Files > Editor > Indent using spaces (instead of tabs)
- XML > XML Files > Editor > Indentation size: 4 (instead of 1)
Configure PMD
- No configuration should be necessary, as settings are checked into source control.
- However, to see the settings:
- General preferences are set in Window → Preferences → PMD
- Project settings are here: Navigator Pane → right click → Properties → PMD
...