Wiki Markup |
---|
{style}
.panel {-moz-border-radius: 7px;
border-radius: 7px;}
.panelMacro table {-moz-border-radius: 15px;
border-radius: 15px;}
{style} |
Panel | ||
---|---|---|
| ||
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. |
...
- JDK 6 or higher (Sun or OpenJDK)
Maven 2.2 or higher (http://maven.apache.org/guides/index.html)
Note If your computer is behind a proxy server, configure maven.
- 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 | ||||
---|---|---|---|---|
| ||||
git clone git://github.com/nroduit/Weasis.git
|
...
Note | |||||||
---|---|---|---|---|---|---|---|
| |||||||
Check out a tag version to build a stable version, see tag list.
|
Building all Plug-ins
- Go in the Weasis directory, Compile and install all the plug-ins in the local Maven repository
Code Block | ||||
---|---|---|---|---|
| ||||
mvn clean install
|
Anchor | ||||
---|---|---|---|---|
|
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 title pack200 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 title For 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 title Single 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 title Possible 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.
...