Difference between revisions of "Development tips OpenKM 5.0"

Revision as of 12:45, 7 November 2010

We recommend downloading JBoss+OpenKM from SourceForge, remove OpenKM.war and develop with this JBoss server configuration. For better development we recommend not deploying OpenKM.war file it's better setting in $JBOSS_HOME/server/default/deploy some alias to target/OpenKM folder:

It's mandatory registering sample-1.0-full.jar into maven repository. File is into ext-libs folder. It must be executed some maven command to registering ( then compilation will execute right ).

mvn install:install-file -DgroupId=com.openkm.extension -DartifactId=sample-full -Dversion=1.0 -Dpackaging=jar -Dfile=sample-1.0-full.jar

In case you're making strong changes in OpenKM UI (GWT) we recommend disabling pom compile directive

<plugin>
        <groupId>org.codehaus.mojo</groupId>
        <artifactId>gwt-maven-plugin</artifactId>
        <version>1.2</version>
        <executions>
          <execution>
            <goals>
              <goal>compile</goal>
              <!-- <goal>generateAsync</goal> -->
              <!-- <goal>test</goal> -->
            </goals>
          </execution>
        </executions>
        <configuration>
          <runTarget>com.openkm.frontend.Main/index.html</runTarget>
          <modules>
            <module>com.openkm.frontend.Main</module>
          </modules>
        </configuration>
      </plugin>

Is possible to compile GWT modules individually by this way: $ mvn gwt:compile -Dgwt.module=com.openkm.frontend.Main

You might be interested in running frontend and backend GWT packaging from eclipse. Go to run configurations and add in maven build

To achieve a faster compile we use to development Firefox, uncommenting gecko line on file Main.gwt.xml GWT compilation only for gecko browser runs fine. Don't forget at finish to comment it and try application with IE or other browsers.

<!-- Compile for Firefox only -->
<set-property name="user.agent" value="gecko"/>

To enable OpenKM extensions it's needed to uncomment into pom.xml the extension dependency.

<!-- OpenKM extensions -->
    <dependency>
      <groupId>com.openkm.extension</groupId>
      <artifactId>sample-full</artifactId>
      <version>1.0</version>
    </dependency>