1. IronPDF
  2. 開始使用
  3. 使用授權金鑰

Curtis Chau
Curtis Chau
更新:

為 IronPDF for Java 套用授權金鑰，即可解鎖完整生產環境功能。 若無有效的授權金鑰，IronPDF 將以試用模式運行，並在每個生成的 PDF 檔案上加蓋浮水印 — 此模式適用於開發與評估，但不適合實際部署。 本指南將逐步說明三種套用授權金鑰的方法：在 Java 程式碼啟動時套用、透過 config.properties 檔案套用，以及如何驗證金鑰是否有效。

快速入門：在 Java 中套用 IronPDF 授權金鑰

**透過四個步驟套用 IronPDF 授權金鑰：** 1. 將 IronPDF 加入您的 `pom.xml` 作為 Maven 依賴項（或直接下載 `.jar`）。 2. 請在應用程式最開頭 — 即在使用任何 IronPDF 類別之前 — 呼叫 `License.setLicenseKey("YOUR-LICENSE-KEY")`。 3. 或者，在您的 `config.properties` 檔案中設定 `IRONPDF_LICENSE_KEY=YOUR-LICENSE-KEY`。 4. 呼叫 `License.isValidLicense("YOUR-LICENSE-KEY")` 以確認金鑰是否有效。

如何取得 IronPDF 授權金鑰？

IronPDF for Java 提供免費開發版供評估使用。 在試用模式下，生成的每份 PDF 文件均會帶有 IronPDF 水印。 若要移除浮水印並部署至生產環境，需具備付費或試用授權金鑰。

提供兩種選項：

收到電子郵件中的金鑰後，請將其備妥以供後續步驟使用。 此關鍵字同時適用於基於程式碼與基於檔案的應用程式方法。

如何將 IronPDF 加入為 Java 依賴項？

在套用授權金鑰之前，IronPDF 必須位於類別路徑中。 有兩種方法可以達成此目標：將其宣告為 Maven 依賴項，或手動新增 .jar 檔案。

選項 1：Maven (pom.xml)

請將以下兩項條目新增至您的 pom.xml 中的 <dependencies> 區塊中。 第一個會引入 IronPDF 函式庫； 第二項新增了 IronPDF 內部使用的 SLF4J 日誌記錄器。

//:path=pom.xml
<dependencies>
    <!-- IronPDF for Java — use the latest release version --&gt;
    <dependency>
        <groupId>com.ironsoftware</groupId>
        <artifactId>ironpdf</artifactId>
        <version>20xx.xx.xxxx</version>
    </dependency>

    <!-- SLF4J simple logger required by IronPDF --&gt;
    <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 --&gt;
    <dependency>
        <groupId>com.ironsoftware</groupId>
        <artifactId>ironpdf</artifactId>
        <version>20xx.xx.xxxx</version>
    </dependency>

    <!-- SLF4J simple logger required by IronPDF --&gt;
    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-simple</artifactId>
        <version>2.0.3</version>
    </dependency>
</dependencies>
XML

請將 20xx.xx.xxxx 替換為最新的 IronPDF for Java 版本。 儲存 pom.xml 後，執行 mvn install（或讓您的 IDE 自動同步）以下載依賴項。

選項 2：手動 JAR

若 Maven 未包含在建置工具鏈中，請下載 IronPDF Java .jar 檔案，並手動將其加入專案的類別路徑中。 此方法適用於基於 Ant 的建置，或未使用套件管理器的專案。

如何在 Java 程式碼中套用授權金鑰？

最直接的方法是在應用程式啟動之初——即在執行任何 PDF 操作之前——呼叫 License.setLicenseKey()。 將呼叫置於 main 方法中是最安全的做法。

//: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

此方法適用於所有類型的 Java 專案：獨立應用程式、Spring Boot 服務、Jakarta EE 應用程式以及 Android 專案。 該金鑰會在 JVM 進程存活期間儲存在記憶體中； 不會發生任何檔案系統寫入操作。