Compiling Community Source Code

http://www.ephesoft.com/wiki/index.php?title=Compiling_Community_Source_Code

Ephesoft, being an open source community allows its users to compile and test the source code of the Community Edition. To compile the community source code follow the steps below.

1. Create a new workspace in the local system and use the same workspace for the eclipse. Download the Ephesoft source code from the Google Code Mercurial repository in the workspace.The whole source code will be downloaded in this folder as "dcma-root".

   [http://code.google.com/p/ephesoft/ Ephesoft Community Edition Google Code Project Page]

2. Copy the Ephesoft maven repository to the same local folder location. Use the following link to downlaod the repository:

   [http://www.ephesoft.com/images/Ephesoft/community-repository-maven-dependencies.zip Community Maven Dependencies.zip]

3. There are two changes need to be made in the "settings.xml" file located in the community-repository-dependencies folder we just downloaded in step 2. Open the settings.xml file using any editor like notepad++ or notepad. Look for the following code line(approximately line number 54).

Update the path in the line for example:

  <localRepository>C:/Users/Ephesoft/Desktop/cummunity-repository-maven-dependencies/cummunity-repository</localrepository>

For the second change look for the following code in the same settings.xml file: approximately line numbers 157-162.

  <mirror>
      <id>mirrorRepo</id>
      <mirrorOf>ephesoft-public-repository</mirrorof>
      <name>Ephesoft Public Maven Repository Group</name>
      <url>http://172.16.1.106/repo</url>
  </mirror>

Delete or comment out the above lines of the code and save the file.

4. To point this folder (in Eclipse), Go to Window/Preferences/Maven/User Settings and point to settings.xml file. For example: set the user settings path to

   C:\Users\Ephesoft\Desktop\community-repository-maven-dependencies\community-repository\settings.xml

 '''Note:''' ''Maven 2.2.1 is required for successful compilation of the project. Download for Maven 2.2.1 is available from here [http://www.apache.org/dyn/closer.cgi/maven/binaries/apache-maven-2.2.1-bin.zip Apache-maven-2.2.1]

5. Right click on the eclipse, select the Import option, select the Existing Maven Projects, select the "dcma-root" folder in the Root Directory, select all the projects and press the Finish Button. Wait until eclipse stop importing all the projects.

6. Once the import is finished, right click on the "dcma-root" project, select "Run As", select "Maven Build.." and type "clean install", check "Skip Tests" and press Run.

7. Project will compile all the projects one by one, creating binaries for every project and final build will be placed inside target folder of "dcma-webapp" project. For example:

  \dcma-root\dcma-webapp\target\dcma-webapp-0.0.10-SNAPSHOT\

8. User can use the same build to deploy the Ephesoft application.

9. Add source to remove the compilation error from the "dcma-batch" project:

   dcma-batch/Properties/Java Build Path/Add Folder and select the source folder and click OK. 

Select the box for src-generated main java

Select the box for src-generated main resources

Select the box for src-generated-hocr main java

Select the box for src-generated-hocr main resources

10. Add source to remove the compilation error from the "dcma-lucene" project

   dcma-lucene/Properties/Java Build Path/Add Folder select the source folder and click OK.

Select the box for src-3rd-party main java

11. Add source to remove the compilation error form the "dcma-fuzzydb" project:

   dcma-fuzzydb Properties/Java Build Path/ Add Folder select the source folder and click OK.

Select the box for src-3rd-party main java