1. IronPDF
  2. Comenzar
  3. Uso de claves de licencia

Curtis Chau
Curtis Chau
Actualizado:

Aplicar una clave de licencia a IronPDF for Java desbloquea toda la capacidad de producción. Sin una clave de licencia válida, IronPDF se ejecuta en modo de prueba y estampa una marca de agua en cada PDF generado — aceptable para desarrollo y evaluación, pero no adecuado para despliegue en vivo. Esta guía muestra tres formas de aplicar una clave de licencia: en el código Java al inicio, a través de un archivo config.properties, y cómo verificar que la clave esté activa.

Inicio rápido: Aplicar una clave de licencia de IronPDF en Java

**Aplica una clave de licencia de IronPDF en cuatro pasos:** 1. Añade IronPDF a tu `pom.xml` como una dependencia de Maven (o descarga el `.jar` directamente). 2. Llama a `License.setLicenseKey("YOUR-LICENSE-KEY")` al inicio de tu aplicación, antes de que se use cualquier clase de IronPDF. 3. Alternativamente, establece `IRONPDF_LICENSE_KEY=YOUR-LICENSE-KEY` en tu archivo `config.properties`. 4. Llama a `License.isValidLicense("YOUR-LICENSE-KEY")` para confirmar que la clave está activa.

¿Cómo obtener una clave de licencia de IronPDF?

IronPDF for Java es gratuito para evaluar en desarrollo. En modo de prueba, cada PDF producido lleva una marca de agua de IronPDF. Para eliminar la marca de agua e implementar en producción, se requiere una clave de licencia pagada o de prueba.

Hay dos opciones disponibles:

Una vez que la clave llega por correo electrónico, mantenla disponible para los pasos siguientes. La misma clave funciona para métodos de aplicación basados ​​en código y en archivo.

¿Cómo agregar IronPDF como una dependencia de Java?

Antes de aplicar una clave de licencia, IronPDF debe estar en el classpath. Hay dos maneras de lograr esto: declararlo como una dependencia de Maven o añadir el archivo .jar manualmente.

Opción 1: Maven (pom.xml)

Añade las siguientes dos entradas al bloque <dependencies> en tu pom.xml. El primero trae la biblioteca de IronPDF; el segundo agrega el registrador SLF4J que IronPDF utiliza internamente.

//:path=pom.xml
<dependencies>
    <!-- IronPDF for Java — use the latest release version - Usará el renderizador WebKit antiguo por defecto
    <dependency>
        <groupId>com.ironsoftware</groupId>
        <artifactId>ironpdf</artifactId>
        <version>20xx.xx.xxxx</version>
    </dependency>

    <!-- SLF4J simple logger required by IronPDF - Usará el renderizador WebKit antiguo por defecto
    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-simple</artifactId>
        <version>2.0.3</version>
    </dependency>
</dependencies>
//:path=pom.xml
<dependencies>
    <!-- IronPDF for Java — use the latest release version - Usará el renderizador WebKit antiguo por defecto
    <dependency>
        <groupId>com.ironsoftware</groupId>
        <artifactId>ironpdf</artifactId>
        <version>20xx.xx.xxxx</version>
    </dependency>

    <!-- SLF4J simple logger required by IronPDF - Usará el renderizador WebKit antiguo por defecto
    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-simple</artifactId>
        <version>2.0.3</version>
    </dependency>
</dependencies>
XML

Reemplaza 20xx.xx.xxxx con la última versión de IronPDF for Java. Después de guardar pom.xml, ejecuta mvn install (o deja que tu IDE sincronice) para descargar la dependencia.

Opción 2: JAR Manual

Si Maven no es parte de la cadena de herramientas de compilación, descarga el archivo .jar de IronPDF Java y agrégalo manualmente al classpath del proyecto. Este enfoque es adecuado para construcciones basadas en Ant o proyectos que gestionan dependencias sin un administrador de paquetes.

¿Cómo se aplica una clave de licencia en código Java?

El método más directo es llamar a License.setLicenseKey() al inicio del arranque de la aplicación, antes de que se ejecute cualquier operación de PDF. Colocar la llamada en el método main es el enfoque más seguro.

//:path=MyApplication.java
import com.ironsoftware.ironpdf.License;

public class MyApplication {
    public static void main(String[] args) {
        // Apply your license key before using any IronPDF feature
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // IronPDF is now fully licensed — no watermarks on output PDFs
        System.out.println("IronPDF license applied.");
    }
}
//:path=MyApplication.java
import com.ironsoftware.ironpdf.License;

public class MyApplication {
    public static void main(String[] args) {
        // Apply your license key before using any IronPDF feature
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // IronPDF is now fully licensed — no watermarks on output PDFs
        System.out.println("IronPDF license applied.");
    }
}
JAVA

Este enfoque funciona en todos los tipos de proyectos Java: aplicaciones independientes, servicios Spring Boot, aplicaciones Jakarta EE y proyectos Android. La clave se almacena en la memoria durante la vida útil del proceso JVM; no se producen escrituras en el sistema de archivos.