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

快速解答
- 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
讓我們在專案中安裝並啟用此函式庫。
- 安裝 – 加入上述的 Maven 相依項目。
- 初始化 – 在 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 輸出選項,例如嵌入資源。
設定路徑
定義輸出資料夾與 HTML 檔案名稱。Path outputDirectory = Paths.get("YOUR_OUTPUT_DIRECTORY"); Path pageFilePathFormat = outputDirectory.resolve("ai_result.html");初始化 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 渲染參數,例如解析度與品質。
設定路徑
Path outputDirectory = Paths.get("YOUR_OUTPUT_DIRECTORY"); Path pageFilePathFormat = outputDirectory.resolve("ai_result.jpg");初始化 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 檔案的每個像素。
設定路徑
Path outputDirectory = Paths.get("YOUR_OUTPUT_DIRECTORY"); Path pageFilePathFormat = outputDirectory.resolve("ai_result.png");初始化 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 專屬設定,例如頁面大小、壓縮與字型嵌入。
設定路徑
Path outputDirectory = Paths.get("YOUR_OUTPUT_DIRECTORY"); Path pageFilePathFormat = outputDirectory.resolve("ai_result.pdf");初始化 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: 可以 – JpgViewOptions 與 PngViewOptions 提供解析度與壓縮設定,讓您微調輸出大小與品質。
Q: 如果遇到問題,我該向哪裡尋求協助?
A: 請前往官方 支援論壇 取得社群協助與 GroupDocs 團隊的官方支援。
資源
- 文件說明:GroupDocs Viewer Java 文件說明
- API 參考指南:API 參考指南
- 下載:GroupDocs.Viewer for Java 下載
最後更新: 2026-06-15
測試環境: GroupDocs.Viewer for Java 23.12 (latest stable)
作者: GroupDocs