Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Wiki Markup
{style}
.panel {-moz-border-radius: 7px;
border-radius: 7px;}
.panelMacro table {-moz-border-radius: 15px;
border-radius: 15px;}
{style}

Panel
borderColor2

These instructions describe how to build Weasis directly from the Git repository on any platform. For building Weasis from an IDE, see Plug-in Development Guidelines.

...

  1. JDK 6 or higher (Sun or OpenJDK)
  2. Maven 2.2 or higher (http://maven.apache.org/guides/index.html)

    Note

    If your computer is behind a proxy server, configure maven.

  3. Git (or directly download source from gitub), one of the following client:
    • CLI on Linux or Mac OS X -  Install git-core package
    • Windows - Tortoise Git - (When installing msysgit be sure to choose Unix style line endings)
    • Eclipse - Install egit

...

To clone the repository, first install GIT and either clone using a graphical GIT client (such as Tortoise Git) or directly from the command line using the command:

Code Block
none
none

git clone git://github.com/nroduit/Weasis.git

...

Note
titleThe trunk is not a stable version and snapshot version is not retained in cache for the web distribution (it means the files will be every times downloaded)

Check out a tag version to build a stable version, see tag list.

Code Block
none
none

git checkout <TAG_NAME>

Building all Plug-ins

  • Go in the Weasis directory, Compile and install all the plug-ins in the local Maven repository
Code Block
none
none

mvn clean install

Anchor
distrib
distrib

Building Weasis Distributions

  • Requires to install all the plug-ins in the local Maven repository (see above Building all Plug-ins).

    Code Block
    none
    none
    
    cd weasis-distributions
    mvn clean package
    
    Tip
    titlepack200 compression

    From 1.1.2 it is possible to use the compression pack200 that reduces jar size considerably. Note: it is recommended to use the Oracle jdk with this option (openjdk can throw packging errors).

    Code Block
    none
    none
    
    mvn clean package -P pack200
    
    Infowarning
    titleFor the WEB distribution

    For using Weasis through Java Webstart, it is required to sign jar files with your own certificate (replace by replacing values in the command below by your own values). You can generate one with keytoolA trust-worthy certificate from a certificate authority is now required to run Java Web Start applications. A self signed certificate generate by keytool will always display a security warning message.
    The parameters must be placed in the maven user setting or has to be the options in the Maven command:

    Code Block
    none
    none
    
    mvn clean package -Djarsigner.alias="your_alias" -Djarsigner.storepass="your_pwd" -Djarsigner.keystore="your_path/keystore"
    

    Note: On Mac OS X 10.8 and from JRE 1.7.0_51, a trust-worthy certificate from a certificate authority is now required to run Java Web Start applications without changing the security level of the system.

  • Add the "-Dportable=true" option for building the portable distribution (cdrom or removable device).

    Code Block
    none
    none
    
    mvn clean package -Dportable=true
    
    Tip
    titleSingle instance for Windows executable (from version 2.0)

    To disable single instance in portable version, set windowsName property empty. By default, Windows executable is a single instance application.

    Code Block
    none
    none
    
    mvn clean package -Dportable=true -DwindowsName=
    
    Note
    titlePossible issue

    On 64-bit system, it requires to install the 32-bit compatibility libraries to build the windows executable. On Linux you need to install ia32-libs package.
    Do not place the sources in a path that contains directories with blanks or national characters, the compilation of the win32 executable can fail.

...