...
Go to the most outer project directory and run:
Code Block |
---|
mvn clean install
|
It will compile, run tests, build all artifacts and install them to your local repo. Built artifacts are located in the target directory of each module (api/web/webapp)
To build the project, but skip running tests (you must run tests when building for the first time in order to create test artifacts):
Code Block |
---|
mvn clean install -DskipTestsDmaven.test.skip=true |
To run individual tests:
Code Block |
---|
mvn test -Dtest=Classname
|
This will run the tests from Classname. So to run tests from ConceptTest, you need to go to api folder and type: {pre}mvn test \ Wiki Markup
Pre |
---|
mvn test -Dtest=ConceptTest |
...
Compile and Start Jetty for hot deployment
Must be run from the webapp directory. Starts up Jetty and deploys OpenMRS.
Requires increasing memory for Maven
Code Block |
---|
mvn jetty:run
|
Open the Internet browser and go to http://localhost:8080/openmrs
...
For working only with trunk, no file editing is necessary. For working with trunk and one or more module(s), please first edit webapp/pom.xml. Search for the string JRebel, and follow instructions regarding relevant modifications that must be done for working with JRebel and one or more modules.
Code Block |
---|
export MAVEN_OPTS="-noverify -javaagent:PATHTOJREBELJAR/jrebel.jar"
mvn jetty:run -P jrebel
|
Generate HTML Junit Report
Code Block |
---|
mvn surefire-report:report
|
...
Generates Javadoc html for each module in target/apidocs and packages to target/<artifact>-<VERSION>-javadoc.jar. For more details, see the Maven Javadoc Plugin
Code Block |
---|
mvn javadoc:jar
|
Generates Javadoc html for entire project in target/apidocs and packages to target/openmrs-<VERSION>-javadoc.jar. For more details, see the Maven Javadoc Plugin
Code Block |
---|
mvn javadoc:aggregate-jar
|
...
Creates a branch based on trunk. Also allows incrementing trunk version to next SNAPSHOT version. For more details, see the Maven Release Plugin
Code Block |
---|
mvn release:branch -DbranchName= -Dusername= -Dpassword=
|
Increasing memory for Maven
In Linux: Add a file called ".mavenrc" to your home directory with this content:
No Format MAVEN_OPTS="$MAVEN_OPTS -Xms512m -Xmx1024m -XX:PermSize=256m -XX:MaxPermSize=512m"
In Windows: Add a new environment variable called MAVEN_OPTSand set it to
No Format -Xms512m -Xmx1024m -XX:PermSize=256m -XX:MaxPermSize=512m
In Eclipse: Within the relevant Run Configuration, select the JRE tab and set the VM Argumentsto
No Format -Xms512m -Xmx1024m -XX:PermSize=256m -XX:MaxPermSize=512m
...