我們很高興宣布 GroupDocs.Conversion for Java 26.10 已於 2026年10月 發佈。此版本引入了對 ISO 和 UUE（uuencode）壓縮檔案的轉換支援、透過可配置的解碼器連接器進行 HEIC 圖像轉換，以及在將 WordProcessing、Spreadsheet、Presentation 和 PDF 文件轉換時移除內建和自訂文件中繼資料的功能。它還包括對檔案類型偵測、頁面尺寸、邊距保留的改進，並修復了多個錯誤——其中包括自 26.9 版起首次呼叫 License.setLicense() 失敗的嚴重回歸問題。

此版本的新功能

  • [功能] 將 ZIP、7z、TAR 和 CPIO 壓縮檔轉換為 ISO (CONVERSIONNET-7079)
  • [功能] 將 ISO 壓縮檔轉換為 ZIP、7z、TAR 和 CPIO (CONVERSIONNET-7078)
  • [功能] 將 UUE 轉換為 Bzip2、Gzip、Lzip、LZMA、XZ、Unix Z、Zstandard、UUE 以及支援的壓縮檔格式 (CONVERSIONNET-7154)
  • [功能] 將 Bzip2、Gzip、LZMA、XZ、Unix Z 和 Zstandard 轉換為 UUE (CONVERSIONNET-7155)
  • [功能] 支援透過解碼器連接器將 HEIC 圖像轉換 (CONVERSIONNET-7140)
  • [增強] 當 LoadOptions 未指定格式時改進檔案類型偵測 (CONVERSIONNET-7161)
  • [增強] 從 PDF 文件轉換時移除中繼資料 (CONVERSIONNET-7131)
  • [增強] 從 Presentation 文件轉換時移除中繼資料 (CONVERSIONNET-7130)
  • [增強] 從 Spreadsheet 文件轉換時移除中繼資料 (CONVERSIONNET-7129)
  • [增強] 從 WordProcessing 文件轉換時移除中繼資料 (CONVERSIONNET-7128)
  • [錯誤] 依檔名轉換時遵守 LoadOptions 中指定的檔案類型 (CONVERSIONNET-7089)
  • [錯誤] 修正 macOS 與 Linux 上圖表轉圖片的轉換問題 (CONVERSIONNET-7088)
  • [錯誤] 正確套用請求的頁面尺寸 (CONVERSIONNET-7080)
  • [錯誤] 在轉換輸出中包含自訂的 MPP 欄位 (CONVERSIONNET-6905)
  • [錯誤] 修正透過 PDF 的 HTML 轉 RTF 轉換 (CONVERSIONNET-6969)
  • [錯誤] 修正從 Word 文件中嵌入的原生與已轉換文字檔的提取 (CONVERSIONNET-7138)
  • [錯誤] 修正 PDF 文件資訊的取得 (CONVERSIONNET-7183)
  • [任務] 在轉換操作與儲存器中實作取消令牌 (CONVERSIONJAVA-3265)
  • [任務] 使轉換可被取消 (CONVERSIONJAVA-3266)
  • [錯誤] 修正首次呼叫 License.setLicense() 時的 IllegalAccessError，該錯誤導致庫處於評估模式（26.9 版的回歸） (CONVERSIONJAVA-3300)

公開 API 變更

ISO 與 UUE 轉換支援

Use CompressionConvertOptions.setFormat(...) with CompressionFileType.Iso or CompressionFileType.Uue.

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.filetypes.CompressionFileType;
import com.groupdocs.conversion.options.convert.CompressionConvertOptions;

CompressionConvertOptions options = new CompressionConvertOptions();
options.setFormat(CompressionFileType.Iso);

try (Converter converter = new Converter("input.zip")) {
    converter.convert("converted.iso", options);
}

ISO 支援與 ZIP、7z、TAR、CPIO 之間的相互轉換，以及 ISO 到 ISO 的轉換。
UUE 可以轉換為 Bzip2、Gzip、Lzip、LZMA、XZ、Unix Z、Zstandard、UUE、ZIP、7z、TAR、CPIO 以及 ISO。
支援從 Bzip2、Gzip、LZMA、XZ、Unix Z 與 Zstandard 轉換為 UUE。Lzip 轉 UUE 不受支援。

HEIC 轉換支援

使用 RasterImageLoadOptions.setHeicConnector(...) 配置 com.groupdocs.conversion.integration.heic.IHeicConnector 的實作，並在載入 HEIC 圖像時將該載入選項傳遞給 Converter。此連接器提供 HEIC 解碼器；HEIC 轉換需要解碼器的實作。

IHeicConnector.getBitmapInfo(InputStream) 會回傳已解碼的位圖。其預設的 getDecodedBitmapInfo(InputStream) 方法會將該位圖轉換為 com.groupdocs.conversion.contracts.BitmapInfo。連接器可以覆寫後者方法，以直接提供已解碼的像素資料。

中繼資料移除

WordProcessingLoadOptions、SpreadsheetLoadOptions、PresentationLoadOptions 與 PdfLoadOptions 實作 IMetadataLoadOptions，並提供 setClearBuiltInDocumentProperties(boolean) 與 setClearCustomDocumentProperties(boolean) 以及相應的取得方法。兩個選項的預設值皆為 false。

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PdfConvertOptions;
import com.groupdocs.conversion.options.load.WordProcessingLoadOptions;

WordProcessingLoadOptions loadOptions = new WordProcessingLoadOptions();
loadOptions.setClearBuiltInDocumentProperties(true);
loadOptions.setClearCustomDocumentProperties(true);

try (Converter converter = new Converter("input.docx", () -> loadOptions)) {
    converter.convert("converted.pdf", new PdfConvertOptions());
}

可為 null 的頁面邊距與試算表預設值

IPageMarginConvertOptions、PdfConvertOptions 與 WordProcessingConvertOptions 中的邊距取得方法現在回傳 Float 而非 float。邊距預設為 null，在適用時會保留來源文件的邊距。設定方法接受可為 null 的 Float 值；原有的原始型別 float 設定方法仍然可用。

請針對更新後的函式庫重新編譯應用程式。對取得的邊距結果進行拆箱的程式碼必須處理 null。若需固定邊距佈局，請設定明確的邊距值。

SpreadsheetLoadOptions.getAllColumnsInOnePagePerSheet() 與 getSkipEmptyRowsAndColumns() 現在預設為 false。若您的應用程式需要所有欄位顯示於同一頁或省略空白列與欄，請明確將其設為 true。

電子郵件載入選項

已移除過時的 EmailLoadOptions.getDisplayEmailAddress() 與 setDisplayEmailAddress(boolean) 方法。請改用 getDisplayFromEmailAddress() 與 setDisplayFromEmailAddress(boolean)。

載入選項格式偵測

涵蓋多種檔案類型的載入選項不再指派預設格式。當 Format 未指定時，會從輸入檔案偵測來源格式。若以檔名載入且明確指定格式，則會遵守該指定格式。

新功能

此版本引入了新格式、中繼資料控制以及轉換修正：

  • 新增 ISO 壓縮檔的相互轉換。
  • 新增 UUE（uuencode）的相互轉換，格式對應列於下方。
  • 新增透過可配置的解碼器連接器進行 HEIC 圖像轉換。
  • 新增在轉換 WordProcessing、Spreadsheet、Presentation 與 PDF 文件時移除內建與自訂文件屬性的選項。
  • 改進檔案類型偵測、頁面尺寸以及保留來源文件邊距。
  • 修正 macOS 與 Linux 上圖表轉圖片的轉換、MPP 自訂欄位、嵌入文字提取，以及 PDF 頁面選取。
  • 修正 26.9 版中首次呼叫 License.setLicense() 時拋出 IllegalAccessError 並使庫處於評估模式的回歸問題。

程式碼範例

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.filetypes.CompressionFileType;
import com.groupdocs.conversion.options.convert.CompressionConvertOptions;

CompressionConvertOptions options = new CompressionConvertOptions();
options.setFormat(CompressionFileType.Iso);

try (Converter converter = new Converter("input.zip")) {
    converter.convert("converted.iso", options);
}

如何取得更新

Maven

透過 Maven 升級至最新的 GroupDocs.Conversion 套件：

GroupDocs.Conversion for Java 26.10

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-conversion</artifactId>
    <version>26.10</version>
</dependency>

資源