Skip to content

Dependencies

Patrick Corless edited this page Nov 3, 2026 · 2 revisions

The POMs on Maven Central bring in everything icepdf needs, so most projects only declare icepdf-core (and a viewer). This page is for builds that assemble the class path by hand, or that want to leave optional parts out.

On this page: Core · Encryption and signatures · Fonts · Images · Viewers

Core

<dependency>
    <groupId>com.github.pcorless.icepdf</groupId>
    <artifactId>icepdf-core</artifactId>
    <version>8.0.0</version>
</dependency>

Encryption and signatures

Needed to open encrypted documents and to validate or create digital signatures.

<dependency>
    <groupId>org.bouncycastle</groupId>
    <artifactId>bcprov-jdk18on</artifactId>
</dependency>
<dependency>
    <groupId>org.bouncycastle</groupId>
    <artifactId>bcpkix-jdk18on</artifactId>
</dependency>

Fonts

Apache FontBox reads the fonts embedded in documents:

<dependency>
    <groupId>org.apache.pdfbox</groupId>
    <artifactId>fontbox</artifactId>
</dependency>
<dependency>
    <groupId>commons-logging</groupId>
    <artifactId>commons-logging</artifactId>
</dependency>

icepdf-fonts is optional. It provides the fonts used when icepdf writes text into annotation and signature appearances; see Fonts.

<dependency>
    <groupId>com.github.pcorless.icepdf</groupId>
    <artifactId>icepdf-fonts</artifactId>
    <version>8.0.0</version>
</dependency>

Images

CCITT fax

Nothing to add: since 8.0, icepdf decodes CCITT fax images itself. TwelveMonkeys ImageIO is no longer a dependency.

JBIG2

<dependency>
    <groupId>org.apache.pdfbox</groupId>
    <artifactId>jbig2-imageio</artifactId>
</dependency>

JPEG 2000

Since 8.0 JPEG 2000 images are decoded by jpx-imageio, a core dependency, so there's nothing to add. If you added com.github.jai-imageio:jai-imageio-jpeg2000 for an earlier version, you can drop it.

<dependency>
    <groupId>com.github.pcorless</groupId>
    <artifactId>jpx-imageio</artifactId>
</dependency>

Viewers

The Swing viewer is icepdf-viewer and needs nothing beyond core. The JavaFX viewer is icepdf-viewer-fx; it needs Java 17 and JavaFX 22 or later, which your application declares itself (JavaFX is per platform):

<dependency>
    <groupId>com.github.pcorless.icepdf</groupId>
    <artifactId>icepdf-viewer-fx</artifactId>
    <version>8.0.0</version>
</dependency>
<dependency>
    <groupId>org.openjfx</groupId>
    <artifactId>javafx-controls</artifactId>
    <version>22.0.2</version>
</dependency>

On JDK 23 or later use JavaFX 25 LTS. The JavaFX Viewer page has the details.

Clone this wiki locally