Consejos de desarrollo

Despliegue de la aplicación en Tomcat

Para un desarrollo más rápido, recomendamos no desplegar directamente OpenKM_.war_; en su lugar, cree en $TOMCAT_HOME/webapps un alias de carpeta de target/openkm:

Compilar solo el módulo frontend de GWT

Para compilar los módulos de GWT individualmente, ejecute el comando:

$ mvn gwt:compile -Dgwt.module=com.openkm.frontend.Main

Configurar la compilación de GWT desde Eclipse

Vaya a “Run configurations”, elija “Maven build” y haga clic con el “botón derecho del ratón” para “añadir” una nueva compilación de Maven.

Compilar solo una permutación del frontend de GWT

De forma predeterminada, GWT compila seis permutaciones, cada una para distintos navegadores. Cada permutación consume muchos recursos de hardware (RAM y CPU).

Para un desarrollo más rápido y un menor tiempo de compilación, habilite una única permutación.

Reducir el número de permutaciones habilitadas disminuirá el tiempo total de compilación necesario.

También puede declarar varias permutaciones al mismo tiempo; por ejemplo, para habilitar Firefox y Chrome puede utilizar:

<set-property name="user.agent" value="gecko1_8, safari"/>

Habilitar solo la permutación de Firefox

Edite el fichero main.gwt.xml del proyecto OpenKM:

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

Habilitar solo la permutación de Chrome

Edite el fichero main.gwt.xml del proyecto OpenKM:

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

Habilitar solo la permutación de IE

Edite el fichero main.gwt.xml del proyecto OpenKM:

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

Configurar el número de CPU que se utilizarán para compilar el frontend de GWT

El proceso de compilación de GWT puede utilizar más de una CPU. Puede establecer el número de CPU que se utilizarán con el parámetro “localWorkers”.

Edite el fichero pom.xml del proyecto.

<plugins>
      <plugin>
        <groupId>org.codehaus.mojo</groupId>
        <artifactId>gwt-maven-plugin</artifactId>
        <version>${gwt.version}</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>
          <localWorkers>4</localWorkers>
        </configuration>
      </plugin>

Ejemplo de script de despliegue

Puede utilizar un script de despliegue:

#!/bin/bash
# @author: Kenneth Walter

#Cleans and re-compiles the source files
mvn -Dmaven.test.skip=true clean gwt:compile install $*

#Set the TARGET_DIRECTORY to the path of your tomcat installation
TARGET_DIRECTORY=~/Downloads/tomcat-8.5.69/
FILE_TO_MOVE=target/openkm.war
#This will only attempt to replace the existing WAR if the new WAR exists
if [ -f $FILE_TO_MOVE ]
then
   echo 'Deploying WAR to Tomcat Directory'
   cp -v $FILE_TO_MOVE $TARGET_DIRECTORY/webapps/.
   echo 'Done'
fi