Skip to content

Latest commit

 

History

History
49 lines (43 loc) · 1.77 KB

BUILDING.md

File metadata and controls

49 lines (43 loc) · 1.77 KB

To build pdfHTML, Maven must be installed.

Running install without a profile will generate the pdfHTML jar:

$ mvn clean install \
    -Dmaven.test.skip=true \
    -Dmaven.javadoc.failOnError=false \
    > >(tee mvn.log) 2> >(tee mvn-error.log >&2)

To run the tests, Ghostscript and Imagemagick must be installed.

$ mvn clean install \
    -Dmaven.test.failure.ignore=false \
    -DgsExec=$(which gs) \
    -DcompareExec=$(which compare) \
    -Dmaven.javadoc.failOnError=false \
    > >(tee mvn.log) 2> >(tee mvn-error.log >&2)

Starting from version 6.1.0 pdfHtml supports native image compilation using GraalVM. Follow the instructions at Getting started to build your first native application out of java sources.

To run tests in native mode GraalVM for JDK 22 or higher must be installed and native profile must be used as follows

$ mvn clean install -Pnative -DskipTests=false \
    -Dmaven.test.failure.ignore=false \
    -DgsExec=$(which gs) \
    -DcompareExec=$(which compare) \
    -Dmaven.javadoc.failOnError=false \
    > >(tee mvn.log) 2> >(tee mvn-error.log >&2)

You can use the supplied Vagrantfile to get a Vagrant VM (Ubuntu 14.04 LTS - Trusty Tahr, with VirtualBox) with all the required software installed.

$ vagrant box add ubuntu/trusty64
$ vagrant up
$ vagrant ssh -- \
    'cd /vagrant ; mvn clean install -Dmaven.test.skip=true -Dmaven.javadoc.failOnError=false' \
    > >(tee mvn.log) 2> >(tee mvn-error.log >&2)