Prise en main de la version Java d'iText 7

iText 7 est disponible sous deux licences :

Cliquez sur la flèche pour développer les informations sur nos bibliothèques.

Les instructions de téléchargement sont identiques pour les deux et décrites en détails ci-après.


Matrice de compatibilité

iText 7 Core7.0.07.0.17.0.27.0.37.0.47.0.57.1.0

iText

3.0.0

Oui

Oui

Oui

Oui

Oui

Oui

Oui

pdf2Data

1.2.0

-

-

Oui

Oui

Oui

Oui

Oui

pdfCalligraph

2.0.0

-

-

-

-

-

-

Oui

pdfDebug

2.0.0

-

Oui

Oui

Oui

Oui

Oui

Oui

pdfHTML

2.0.0

-

-

-

-

-

-

Oui

pdfInvoice

2.0.0

-

Oui

Oui

Oui

Oui

Oui

Oui

pdfSweep

2.0.0

-

-

-

-

-

Oui

Oui

pdfXFA

2.0.0

Oui

Oui

Oui

Oui

Oui

Oui

Oui


Comment télécharger iText 7 Community et les extensions open source ?

Gestion automatisée des dépendances pour la version .NET d'iText 7 Community

Si vous utilisez Maven comme outil de construction pour Java, ajoutez l'extrait de code XML suivant dans votre fichier pom.xml. Vous aurez toujours besoin des éléments kernel, io et layout. Si vous n'avez pas besoin de certaines fonctionnalités d'iText 7 Community, vous pouvez uniquement ajouter les modules dont vous avez besoin.

<dependencies>

    <!-- always needed -->
    <dependency>
        <groupId>com.itextpdf</groupId>
        <artifactId>kernel</artifactId>
        <version>7.1.0</version>
    </dependency>

    <!-- always needed -->
    <dependency>
        <groupId>com.itextpdf</groupId>
        <artifactId>io</artifactId>
        <version>7.1.0</version>
    </dependency>

    <!-- always needed -->
    <dependency>
        <groupId>com.itextpdf</groupId>
        <artifactId>layout</artifactId>
        <version>7.1.0</version>
    </dependency>

    <!-- only needed for forms -->
    <dependency>
        <groupId>com.itextpdf</groupId>
        <artifactId>forms</artifactId>
        <version>7.1.0</version>
    </dependency>

    <!-- only needed for PDF/A -->
    <dependency>
        <groupId>com.itextpdf</groupId>
        <artifactId>pdfa</artifactId>
        <version>7.1.0</version>
    </dependency>

    <!-- only needed for digital signatures -->
    <dependency>
        <groupId>com.itextpdf</groupId>
        <artifactId>sign</artifactId>
        <version>7.1.0</version>
    </dependency>

    <!-- only needed for barcodes -->
    <dependency>
        <groupId>com.itextpdf</groupId>
        <artifactId>barcodes</artifactId>
        <version>7.1.0</version>
    </dependency>

    <!-- only needed for Asian fonts -->
    <dependency>
        <groupId>com.itextpdf</groupId>
        <artifactId>font-asian</artifactId>
        <version>7.1.0</version>
    </dependency>

    <!-- only needed for hyphenation -->
    <dependency>
        <groupId>com.itextpdf</groupId>
        <artifactId>hyph</artifactId>
        <version>7.1.0</version>
    </dependency>

</dependencies>

Si vous avez besoin de tous les modules iText 7 Community, vous n'avez pas besoin d'ajouter les modules individuels et vous n'avez qu'à ajouter ces éléments à votre fichier pom.xml. Maven fera ensuite le nécessaire et téléchargera les modules nécessaires depuis le référentiel central Maven.

<dependencies>

    <!-- add all iText 7 Community modules -->
    <dependency>
        <groupId>com.itextpdf</groupId>
        <artifactId>itext7-core</artifactId>
        <version>7.1.0</version>
        <type>pom</type>
    </dependency>

</dependencies>

Version Java d'iText 7 Community sur GitHub

Le code source est disponible sur GitHub. iText 7.1.0 est la dernière version actuelle. Elle a été lancée le 6 décembre 2017.

  • Vous pouvez télécharger les modules (fichiers .jar) d'iText 7 Community en un seul fichier ZIP : iText 7 Community.
  • Les développeurs peuvent cloner les projets git suivants pour accéder au code source : iText 7 Community.
  • Téléchargez pdfHTML : pdfHTML.
  • Téléchargez pdfSweep : pdfSweep.
  • Téléchargez pdfInvoice : pdfInvoice.
  • Téléchargez pdfDebug : pdfDebug.


Comment télécharger iText 7 Core et les extensions ?

Clé de licence et bibliothèque

Si vous avez acheté une licence commerciale pour iText 7 et/ou ses extensions, vous disposez d'une clé de licence. Pour l'utiliser, vous devez télécharger la bibliothèque de clés de licence appropriée. Obtenez davantage d'informations sur les bibliothèques de clés de licence. Une FAQ sur la clé de licence est disponible ici.

Utilisation du référentiel central

iText 7 Core pour Java est disponible via Maven dans le référentiel central. Seules les extensions open source peuvent être téléchargées à partir du référentiel central de Maven. Les extensions fermées peuvent être téléchargées uniquement à partir des serveurs iText (voir ci-dessous).
Il vous suffit d'ajouter iText 7 Core en tant que dépendance à votre fichier pom.xml :

<dependencies>

    <!-- add all iText 7 Core modules -->
    <dependency>
        <groupId>com.itextpdf</groupId>
        <artifactId>itext7-core</artifactId>
        <version>7.1.0</version>
        <type>pom</type>
    </dependency>

</dependencies>

Utilisation du serveur iText Artifactory

Les extensions pdfCalligraph, pdfXFA et pdf2Data ainsi que la bibliothèque de clés de licence ne sont pas open source, elles ne sont donc pas disponibles dans le référentiel central Maven.

Vous pouvez les obtenir à partir du serveur iText Artifactory. iText 7 Core est également disponible au même endroit.

Vous pouvez ajouter ce serveur en tant que référentiel Maven supplémentaire dans la section repositories de votre fichier pom.xml ou settings.xml, comme décrit dans la documentation Maven. Maven interrogera ensuite automatiquement ce référentiel pour les fichiers .jar de l'extension.

Vous pouvez également parcourir le serveur iText Artifactory et télécharger les fichiers .jar manuellement.

<repositories>
  <repository>
    <id>itext</id>
    <name>iText Repository - releases</name>
    <url>https://repo.itextsupport.com/releases</url>
  </repository>
</repositories>

2. Add the dependencies to .pom project file:

<dependencies>

  <!-- pdfSweep -->
  <dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>cleanup</artifactId>
    <version>2.0.0</version>
  </dependency>

  <!-- pdfCalligraph -->
  <dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>typography</artifactId>
    <version>2.0.0</version>
  </dependency>

  <!-- pdfInvoice -->
  <dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>zugferd</artifactId>
    <version>2.0.0</version>
  </dependency>

  <!-- pdfHTML -->
  <dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>html2pdf</artifactId>
    <version>2.0.0</version>
  </dependency>

  <!-- pdfXFA -->
  <dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>pdfxfa</artifactId>
    <version>2.0.0</version>
  </dependency>

</dependencies>

Bibliothèque de clés de licence

La bibliothèque de clés de licence (itext-licensekey-xyzjar) doit être sur le chemin de classe. Elle est téléchargeable depuis notre référentiel.
REMARQUE : Utilisez la dernière version de la bibliothèque de clés de licence lors de l'utilisation de votre clé de licence. La dernière version est 3.0.0. Pour iText 5, utilisez la version 1.

Vous pouvez également utiliser Maven pour résoudre cette dépendance. Pour ce faire, ajoutez le serveur iText Artifactory (https://repo.itextsupport.com/releases) en tant que référentiel supplémentaire dans la section repositories de votre fichier pom.xml, comme décrit dans la documentation Maven. Vous pouvez ensuite ajouter la dépendance suivante à vos dépendances :

<dependencies>
  <!-- iText 7 License Key Library -->
  <dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>itext-licensekey</artifactId>
    <version>3.0.0</version>
  </dependency>
</dependencies>

Le fichier de licence (généralement itextkey.xml) doit être chargé avant d'appeler le code propriétaire. Pour ce faire, utilisez la méthode statique LoadLicenseFile() de la classe LicenseKey : LicenseKey.loadLicenseFile("path/to/itextkey.xml") Vous pouvez également utiliser cette méthode avec la classe InputStream pour le fichier de licence.


Comment désinstaller iText 7 Community ou Core ?

Version Java - Maven


Pour installer iText 7, procédez comme suit :

  1. Extrayez le code iText de votre projet.
  2. Exécutez la commande Maven mvn dependency:purge-local-repository -DreResolve=false.
  3. Extrayez les dépendances iText de votre fichier pom.xml.
Référence : http://maven.apache.org/plugins/maven-dependency-plugin/purge-local-repository-mojo.html