우리는 GroupDocs.Conversion for Java 26.10의 출시를 기쁘게 발표합니다. 이 버전은 2026년 10월부터 사용할 수 있습니다. 이번 릴리스는 ISO 및 UUE(uuencode) 아카이브 변환 지원, 구성 가능한 디코더 커넥터를 통한 HEIC 이미지 변환, 그리고 WordProcessing, Spreadsheet, Presentation 및 PDF 문서 변환 시 내장 및 사용자 정의 문서 메타데이터를 제거할 수 있는 기능을 도입합니다. 또한 파일 유형 감지, 페이지 크기 지정, 여백 보존을 개선하고 여러 버그를 수정했으며, 특히 26.9 버전에서 첫 번째 License.setLicense() 호출이 실패하던 중요한 회귀 문제를 해결했습니다.

이번 릴리스의 새로운 기능

  • [Feature] ZIP, 7z, TAR 및 CPIO 아카이브를 ISO로 변환 (CONVERSIONNET-7079)
  • [Feature] ISO 아카이브를 ZIP, 7z, TAR 및 CPIO로 변환 (CONVERSIONNET-7078)
  • [Feature] UUE를 Bzip2, Gzip, Lzip, LZMA, XZ, Unix Z, Zstandard, UUE 및 지원되는 아카이브 형식으로 변환 (CONVERSIONNET-7154)
  • [Feature] Bzip2, Gzip, LZMA, XZ, Unix Z 및 Zstandard를 UUE로 변환 (CONVERSIONNET-7155)
  • [Feature] 디코더 커넥터를 통한 HEIC 이미지 변환 지원 (CONVERSIONNET-7140)
  • [Enhancement] LoadOptions에 형식이 지정되지 않은 경우 파일 유형 감지를 개선 (CONVERSIONNET-7161)
  • [Enhancement] PDF 문서 변환 시 메타데이터 제거 (CONVERSIONNET-7131)
  • [Enhancement] Presentation 문서 변환 시 메타데이터 제거 (CONVERSIONNET-7130)
  • [Enhancement] Spreadsheet 문서 변환 시 메타데이터 제거 (CONVERSIONNET-7129)
  • [Enhancement] WordProcessing 문서 변환 시 메타데이터 제거 (CONVERSIONNET-7128)
  • [Bug] 파일 이름으로 변환할 때 LoadOptions에 지정된 파일 유형을 존중 (CONVERSIONNET-7089)
  • [Bug] macOS 및 Linux에서 다이어그램을 이미지로 변환하는 문제 수정 (CONVERSIONNET-7088)
  • [Bug] 요청된 페이지 크기를 올바르게 적용 (CONVERSIONNET-7080)
  • [Bug] 변환 출력에 사용자 정의 MPP 열 포함 (CONVERSIONNET-6905)
  • [Bug] HTML을 PDF를 통해 RTF로 변환하는 문제 수정 (CONVERSIONNET-6969)
  • [Bug] Word 문서에 포함된 원본 및 변환된 텍스트 파일 추출 문제 수정 (CONVERSIONNET-7138)
  • [Bug] PDF 문서 정보 검색 문제 수정 (CONVERSIONNET-7183)
  • [Task] 변환 작업 및 저장기에서 취소 토큰 구현 (CONVERSIONJAVA-3265)
  • [Task] 변환을 취소 가능하도록 만들기 (CONVERSIONJAVA-3266)
  • [Bug] 첫 번째 License.setLicense() 호출 시 IllegalAccessError를 수정, 이로 인해 라이브러리가 평가 모드에 머물던 문제(26.9 회귀) 해결 (CONVERSIONJAVA-3300)

공개 API 변경 사항

ISO 및 UUE 변환 지원

CompressionConvertOptions.setFormat(...) 메서드에 CompressionFileType.Iso 또는 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 간 변환을 지원합니다.
UUE는 Bzip2, Gzip, Lzip, LZMA, XZ, Unix Z, Zstandard, UUE, ZIP, 7z, TAR, CPIO 및 ISO로 변환할 수 있습니다.
UUE로의 변환은 Bzip2, Gzip, LZMA, XZ, Unix Z 및 Zstandard에서 지원됩니다. Lzip에서 UUE로의 변환은 지원되지 않습니다.

HEIC 변환 지원

com.groupdocs.conversion.integration.heic.IHeicConnector 구현을 RasterImageLoadOptions.setHeicConnector(...) 로 구성하고, HEIC 이미지를 로드할 때 해당 로드 옵션을 Converter에 전달하십시오. 커넥터는 HEIC 디코더를 제공하며, HEIC 변환을 위해서는 디코더 구현이 필요합니다.

IHeicConnector.getBitmapInfo(InputStream)은 디코딩된 비트맵을 반환합니다. 기본 getDecodedBitmapInfo(InputStream) 메서드는 해당 비트맵을 com.groupdocs.conversion.contracts.BitmapInfo에 맞게 변환합니다. 커넥터는 후자의 메서드를 재정의하여 디코딩된 픽셀 데이터를 직접 제공할 수 있습니다.

메타데이터 제거

WordProcessingLoadOptions, SpreadsheetLoadOptions, PresentationLoadOptions, 및 PdfLoadOptions는 IMetadataLoadOptions를 구현하고 setClearBuiltInDocumentProperties(boolean) 및 setClearCustomDocumentProperties(boolean) 메서드와 해당 getter를 제공합니다. 두 옵션 모두 기본값은 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());
}

Nullable 페이지 여백 및 스프레드시트 기본값

IPageMarginConvertOptions, PdfConvertOptions, 및 WordProcessingConvertOptions의 여백 getter가 이제 float 대신 Float를 반환합니다. 여백은 기본값이 null이며, 이는 해당되는 경우 원본 문서의 여백을 보존합니다. setter는 nullable Float 값을 허용하며, 원시 float setter 오버로드는 여전히 사용할 수 있습니다.

업데이트된 라이브러리를 대상으로 애플리케이션을 다시 컴파일하십시오. 여백 getter 결과를 언박싱하는 코드는 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>

리소스