將 AI 轉換為 PDF 並使用 GroupDocs.Viewer for Java 進行渲染

將 AI 轉換為 PDF(以及其他網頁友好格式)是開發人員在顯示或分享 Adobe Illustrator 設計時的常見需求。在本教學中,您將學會如何 將 AI 轉換為 PDF,以及使用 GroupDocs.Viewer for Java 將 AI 檔案渲染為 HTML、JPG 與 PNG。完成本指南後,您將擁有一套清晰、可投入生產環境的工作流程,能有效處理向量圖形。

Render AI Files with GroupDocs.Viewer for Java

快速解答

  • GroupDocs.Viewer 能將 AI 轉換為 PDF 嗎? 是的 – 只需一次呼叫 PdfViewOptions 即可完成轉換。
  • 在正式環境使用需要授權嗎? 需要商業授權;可使用免費試用版進行測試。
  • 支援哪個 Java 版本? Java 8 或更高版本。
  • 可以渲染成 HTML 嗎? 當然可以 – 使用 HtmlViewOptions.forEmbeddedResources()
  • 除了 PDF,還能輸出哪些格式? 完全支援 JPG、PNG 與 HTML。

什麼是將 AI 轉換為 PDF?

將 AI 轉換為 PDF 是將 Adobe Illustrator(.ai)向量檔案轉換為可攜式文件格式(PDF)的過程,該格式保留圖層、字型與向量品質。這使得檔案在跨平台檢視、列印與分享時更加便利。PDF 亦可進一步支援 OCR、數位簽章與歸檔等後續處理,同時維持原始設計的真實度。

為什麼使用 GroupDocs.Viewer 進行 AI 渲染?

GroupDocs.Viewer 支援 50+ 輸入與輸出格式,包括 AI,且能在不將整個檔案載入記憶體的情況下渲染上百頁文件。其 Java API 在提供高保真度輸出的同時,保持低記憶體使用量,非常適合伺服器端批次處理。

先決條件

  • 基本的 Java 程式設計知識。
  • 已安裝 JDK 8 或更新版本。
  • 使用 Maven 進行相依管理。

所需的函式庫與相依性

pom.xml 中加入 GroupDocs.Viewer 作為 Maven 相依項目。以下佔位符提供了完整的 XML 片段。

Maven 設定

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/viewer/java/</url>
   </repository>
</repositories>

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-viewer</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

授權取得

GroupDocs.Viewer 提供免費試用版供評估。正式部署時,請從 購買頁面 取得永久授權。

設定 GroupDocs.Viewer for Java

讓我們在專案中安裝並啟用此函式庫。

  1. 安裝 – 加入上述的 Maven 相依項目。
  2. 初始化 – 在 try‑with‑resources 區塊中建立 Viewer 實例,使其自動關閉。

如何使用 GroupDocs.Viewer for Java 將 AI 轉換為 PDF?

Viewer 是提供載入與渲染文件方法的主要類別。使用 new Viewer("file.ai") 載入 AI 檔案,然後呼叫 viewer.view(document, PdfViewOptions.forFile("output.pdf"))PdfViewOptions 設定 PDF 專屬參數,如頁面大小、壓縮與字型嵌入。此一行程式會讀取向量資料,必要時光柵化,並產生保留圖層與向量路徑的 PDF。此作業的時間複雜度為 O(n)(n 為頁數),且對於最多 300 頁的檔案,記憶體使用量低於 200 MB。

將 AI 文件渲染為 HTML

HtmlViewOptions 設定 HTML 輸出選項,例如嵌入資源。

  1. 設定路徑
    定義輸出資料夾與 HTML 檔案名稱。

    Path outputDirectory = Paths.get("YOUR_OUTPUT_DIRECTORY");
    Path pageFilePathFormat = outputDirectory.resolve("ai_result.html");
    
  2. 初始化 Viewer 與選項
    HtmlViewOptions.forEmbeddedResources() 告訴 API 將影像與 CSS 直接內嵌至 HTML 檔案中。

    try (Viewer viewer = new Viewer(TestFiles.SAMPLE_AI)) {
        HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);
        // Render the AI document to HTML with embedded resources.
        viewer.view(options);
    }
    

關鍵設定: forEmbeddedResources 方法確保產生的 HTML 為單一自包含檔案,適合快速的網頁預覽。

將 AI 文件渲染為 JPG

JpgViewOptions 控制 JPEG 渲染參數,例如解析度與品質。

  1. 設定路徑

    Path outputDirectory = Paths.get("YOUR_OUTPUT_DIRECTORY");
    Path pageFilePathFormat = outputDirectory.resolve("ai_result.jpg");
    
  2. 初始化 Viewer 與選項

    try (Viewer viewer = new Viewer(TestFiles.SAMPLE_AI)) {
        JpgViewOptions options = new JpgViewOptions(pageFilePathFormat);
        // Render the AI document to a JPG image.
        viewer.view(options);
    }
    

關鍵設定: JPEG 輸出在檔案大小與視覺品質之間取得平衡,適用於報告與簡報。

將 AI 文件渲染為 PNG

PngViewOptions 提供無損影像渲染,完整保留來源 AI 檔案的每個像素。

  1. 設定路徑

    Path outputDirectory = Paths.get("YOUR_OUTPUT_DIRECTORY");
    Path pageFilePathFormat = outputDirectory.resolve("ai_result.png");
    
  2. 初始化 Viewer 與選項

    try (Viewer viewer = new Viewer(TestFiles.SAMPLE_AI)) {
        PngViewOptions options = new PngViewOptions(pageFilePathFormat);
        // Render the AI document to a PNG image.
        viewer.view(options);
    }
    

關鍵設定: PNG 輸出保留透明度與細節,適合圖形密集的應用程式。

將 AI 文件渲染為 PDF

PdfViewOptions 定義 PDF 專屬設定,例如頁面大小、壓縮與字型嵌入。

  1. 設定路徑

    Path outputDirectory = Paths.get("YOUR_OUTPUT_DIRECTORY");
    Path pageFilePathFormat = outputDirectory.resolve("ai_result.pdf");
    
  2. 初始化 Viewer 與選項

    try (Viewer viewer = new Viewer(TestFiles.SAMPLE_AI)) {
        PdfViewOptions options = new PdfViewOptions(pageFilePathFormat);
        // Render the AI document to a PDF file.
        viewer.view(options);
    }
    

關鍵設定: PDF 渲染器預設支援 300 dpi,若有需要可調整更高解析度,確保向量圖形保持清晰。

實務應用

  • 網頁開發: 使用 HTML 渲染選項,即時且具回應式的預覽 Illustrator 藝術作品,無需瀏覽器外掛。
  • 數位行銷: 將 AI 檔案轉換為 JPG 或 PNG,用於社群媒體、電子郵件活動與印刷廣告的高衝擊視覺。
  • 文件管理: 將 AI 設計存為 PDF 以便歸檔、合規或在團隊間輕鬆共享。

效能考量

  • 記憶體管理: 處理超過 100 MB 的檔案時,至少配置 2 GB 堆積記憶體,以避免 OutOfMemoryError
  • 串流處理: 必須關閉所有輸入與輸出串流;前述的 try‑with‑resources 模式會自動處理。
  • 快取策略: 若同一 AI 資產需多次轉換,可將產生的輸出 (HTML、JPG、PNG 或 PDF) 快取於 Redis 或記憶體儲存,以降低最高 70 % 的 CPU 使用率。

常見問題與解決方案

  • PDF 出現空白頁面: 確認 AI 檔案未包含不支援的特效;使用 PdfViewOptions.setRenderMode(RenderMode.Vector) 強制向量渲染。
  • 大型檔案渲染緩慢: 增加 Viewer 設定中的執行緒池大小,或在轉換前將 AI 檔案拆分為較小的畫板。
  • 缺少字型: 在原始 AI 文件中嵌入字型,或透過 ViewerConfig.setFontDirectory("/path/to/fonts") 提供自訂字型資料夾。

常見問答

Q: 使用 GroupDocs.Viewer 可以將 AI 文件轉換為哪些格式?
A: 您可以直接透過 API 將 AI 檔案渲染為 HTML、JPG、PNG 與 PDF。

Q: 是否需要特定的 Java 版本?
A: 需要 Java 8 或更新版本;此函式庫完全相容於 Java 11、17 以及後續的 LTS 版本。

Q: 如何處理非常大的 AI 檔案?
A: 配置足夠的堆積記憶體,使用串流 API,並考慮在轉換前將文件拆分為多個畫板。

Q: 在轉換為 JPG 或 PNG 時,我能控制影像品質嗎?
A: 可以 – JpgViewOptionsPngViewOptions 提供解析度與壓縮設定,讓您微調輸出大小與品質。

Q: 如果遇到問題,我該向哪裡尋求協助?
A: 請前往官方 支援論壇 取得社群協助與 GroupDocs 團隊的官方支援。

資源


最後更新: 2026-06-15
測試環境: GroupDocs.Viewer for Java 23.12 (latest stable)
作者: GroupDocs

相關教學