EmForge - Wiki

BuildEmForge

Build instruction for EmForge Project

Tools Required to Work with EmForge

Java 1.5 of course :)
Eclipse 3.2 to develop the project
- WTP 1.5 - provides APIs for J2EE and Web-centric application development
- Subversive to get Sources from Repository (Installation instructions)
Maven 2 to build the project
Subversion Client to get Sources from Repository omitting Eclipse.
By Default build-in HSQL database is used, so, you do not need any addional database server installed;
Tomcat 5.5 - used as Servlet-Container

Get sources from Repository

Sources available by URL: http://svn.emforge.org/svn/emforge/EmForge/trunk

Just Get it into some folder (for example c:/work/EmForge/trunk)


svn checkout http://svn.emforge.org/svn/emforge/EmForge/trunk trunk

As result you will receive 3 projects: emforge-api, emforge-web and EmForgeProcesses which currently not used in development.

Build with Maven

To build project with Maven you need from project's root folder call


mvn install

If build will be success you can find EmForge.war package in target folder.

Prepeare Eclipse Workspace

To work with EmForge from Eclipse you need:

Setup JDK (not JRE) - it is required for Tomcat: Window -> Preferences... -> Java - Installed JREs
Add Tomcat Server Runtime: Windows -> Preferences... -> Server -> Installed Runtimes
Add Tomcat Server instance: J2EE Perspective -> Servers Tab -> New -> Server
Add Required Database JDBC driver {TomcatHome}/common/lib
Prepeare Workspace to work with Maven by command (exit from Eclipse before, see Maven Site for details):


mvn -Declipse.workspace={path-to-eclipse-workspace} eclipse:add-maven-repo

Import downloaded EmForge projects into workspace

Prepare Database Server

Development environment is using HSQL build-in database, so, to start use EmForge you will not need to install and setup any additional database. During build required hsql jar will be downloaded by maven and database with required scheme will be created during first run.