Difference between revisions of "Developer Guide"
From OpenKM Documentation
| Line 16: | Line 16: | ||
* [[Configure Java in Eclipse]] | * [[Configure Java in Eclipse]] | ||
| − | * [[Configure | + | * [[Configure tomcat server in Eclipse]] |
* [[Maven installation]] | * [[Maven installation]] | ||
* [[Checkout source from Subversion]] | * [[Checkout source from Subversion]] | ||
| Line 22: | Line 22: | ||
* [[Browsing embeded database]] | * [[Browsing embeded database]] | ||
* [[Debugging OpenKM]] | * [[Debugging OpenKM]] | ||
| − | + | ||
* [[Debugging with GWT]] | * [[Debugging with GWT]] | ||
* [[Profiling OpenKM]] [[File:Padlock.gif]] | * [[Profiling OpenKM]] [[File:Padlock.gif]] | ||
| Line 42: | Line 42: | ||
* Maven Integration for Eclipse - http://m2eclipse.sonatype.org/sites/m2e/ | * Maven Integration for Eclipse - http://m2eclipse.sonatype.org/sites/m2e/ | ||
* Maven Integration for Eclipse Extras - http://m2eclipse.sonatype.org/sites/m2e-extras/ | * Maven Integration for Eclipse Extras - http://m2eclipse.sonatype.org/sites/m2e-extras/ | ||
| + | |||
| + | == Deprecated == | ||
| + | === OpenKM version 5.x and older === | ||
| + | * [[Configure JBoss server in Eclipse]] | ||
| + | * [[Debugging remote server]] | ||
== Changelog == | == Changelog == | ||
Revision as of 12:22, 24 October 2012
The developer environment can be set in any Operating System (Linux, Windows, etc.) since it is a multi-platform system, but Linux is recommended, because is what it is being used.
You need to install Maven, eclipse IDE and some plugins. For OpenKM 4.0 and 5.0 you have these requirements:
- Maven at http://maven.apache.org/
- Eclipse Galileo (Eclipse IDE for Java EE Developers) at http://www.eclipse.org/galileo/
- Subversion eclipse plugin at http://subclipse.tigris.org
- Maven to eclipse plugin at http://m2eclipse.sonatype.org
- Java JDK 1.6 at http://java.sun.com/javase/downloads/index.jsp
 |
Starting from Eclipse Helios you have a Marketplace accessible from Help > Eclipse Marketplace... Here you can search for "maven" to install the "Maven Integration for Eclipse" and "Maven Integration for Eclipse (Extras)" solutions. Also you can search for "subversion" to find the "Subclipse" plugin. |
 |
The easier way to get an Eclipse installation with the required plugins is using JBoss Developer Studio. |
Once all them are installed, you can download OpenKM and build it.
- Configure Java in Eclipse
- Configure tomcat server in Eclipse
- Maven installation
- Checkout source from Subversion
- Development tips
- Browsing embeded database
- Debugging OpenKM
- Debugging with GWT
- Profiling OpenKM
- Doxygen OpenKM 5.0.x ( OpenKM packages & classes & files documentation )
- Doxygen OpenKM 5.1.x ( OpenKM packages & classes & files documentation )
Note: You can configure Eclipse to integrate with MantisBT. Read Mylyn-Mantis Repository Connectofor more info.
Eclipse Development Quick Install Guide
This quick install is valid for Eclipse Indigo.
- Download Eclipse IDE for Java EE Developers from http://www.eclipse.org/downloads/.
- Go to Help > Eclipse Marketplace and install these plugins:
Alternative: Add repository
- Subclipse 1.6.x Update Site -> http://subclipse.tigris.org/update_1.6.x
- Maven Integration for Eclipse - http://m2eclipse.sonatype.org/sites/m2e/
- Maven Integration for Eclipse Extras - http://m2eclipse.sonatype.org/sites/m2e-extras/
Deprecated
OpenKM version 5.x and older
Changelog
Changes between developer guide 5.0 to 6.0
- GWT 2.4.0
- OpenKM now is executed under tomcat
Changes between developer guide 4.0 to 5.0
- Development tips changes ( how to enable OpenKM extensions in compilation and disable automatic GWT compilation )
- GWT 2.0.4
- Java package has been refactoring to "com.openkm" all references to older package in configuration files has been changed
Changes between developer guide 2.0 to 4.0
- Changed to Eclipse Galileo
- Now we use maven in replacement of JBoss Tools
Changes between developer guide 1.2 to 2.0
- Changed IDE to Eclipse Europa / JBoss tools, before was JBoss IDE.
- GWT 1.5.3 is needed to compile, before was version 1.4.6
- Changed packaging to new jboss tools packaging.
- Changed GWT generating to temporary JBoss folder to project folders to developing.
- Added new generateback.sh and generateback.bat to GWT admin.
- Upgraded JBoss server to version 4.2.2.GA
Changes between developer guide 1.0 and 1.1 to 1.2
- GWT 1.4.6 is needed to compile, before was version 1.3.3.
- Changes on GWT shell configuration, now not uses GWTDS variable ( code deleted ).
- Configured generate.sh to deploy to tmp JBoss with OpenKM.ear deployed to fast developing.
- Added gecko to Main.gwt.xml to fast compiling only gecko when is uncommented.
