이번 릴리즈의 새로운 내용

GroupDocs.Viewer for Java 25.12는 공개 API에 영향을 미치는 세 가지 새로운 기능, 두 가지 개선 사항 및 여덟 가지 버그 수정을 도입합니다.

ID 카테고리 요약
VIEWERNET‑5239 새로운 기능 문서를 HTML로 변환할 때 JavaScript 보존을 선택적으로 비활성화합니다.
VIEWERNET‑5486 새로운 기능 각 포맷 패밀리마다 구별되는 글꼴 유형을 도입합니다.
VIEWERNET‑5484 새로운 기능 WordProcessing 패밀리 포맷에 대해 모든 글꼴을 가져올 때 대체 글꼴을 리스트에 표시합니다.
VIEWERNET‑5490 개선 Spreadsheet 문서를 임베디드 HTML로 변환할 때 글꼴을 포함합니다.
VIEWERNET‑5475 개선 Spreadsheet 문서를 HTML로 렌더링할 때 “상위 행 고정”을 지원합니다.

새로운 글꼴 관련 API

이번 릴리즈에서는 패밀리별 글꼴 모델을 추가했습니다.

  • com.groupdocs.viewer.fonts.IFontInfo – 기본 인터페이스.
  • 구현 클래스: WordProcessingFontInfo, WordProcessingSubstitutedFontInfo, PdfFontInfo, SpreadsheetFontInfo, PresentationFontInfo.

이전의 com.groupdocs.viewer.fonts.UsedFontInfo 클래스는 삭제되었으며, FontStyles는 열거형에서 완전한 클래스로 변경되었습니다.

참고: 문서 항목 로드된 문서에서 사용된 모든 글꼴 가져오기 가 이번 변경 사항을 반영하도록 다시 작성되었습니다.

Spreadsheet → HTML에 임베디드 글꼴

Spreadsheet(.xls, .xlsx 등)를 임베디드 HTML 로 렌더링할 때, 팩토리 메서드 HtmlViewOptions.forEmbeddedResources() 를 사용하면 isExcludeFonts() 플래그를 true 로 명시적으로 설정하지 않는 한 글꼴이 자동으로 (Base‑64 인코드된 형태로) 포함됩니다.

// 예시: Spreadsheet를 임베디드 HTML로 변환하면서 글꼴을 포함하기
HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources("output.html")
options.setExcludeFonts(false); // 기본값은 false

Viewer viewer = new Viewer("sample.xlsx");
viewer.view(options);

임베디드 글꼴이 없는 HTML 출력이 필요하다면 options.setExcludeFonts(true) 를 호출하십시오.

수정 및 개선

ID 카테고리 요약
VIEWERNET‑5060 버그 .NET Framework 4.6.2에서 CustomTempFonts 폴더가 계속 증가함 (Java와는 무관하지만 문서에 명시).
VIEWERNET‑5145 버그 PPTX를 이미지와 함께 HTML로 저장할 때 글자가 겹쳐 보임.
VIEWERNET‑5379 버그 PPTX를 HTML로 변환할 때 오른쪽 하단에 로고가 누락됨.
VIEWERNET‑5417 버그 JPEG → PDF 변환 시 손상된 PDF가 생성되어 Adobe Acrobat에서 오류가 발생함.
VIEWERNET‑5378 버그 PDF → HTML 변환 중 예외가 발생함.
VIEWERNET‑5374 버그 PDF 첨부 파일이 HTML로 렌더링될 때 형태가 깨짐.
VIEWERNET‑5345 버그 PDF → HTML 변환 시 배경 그라디언트가 잘못 렌더링됨.
VIEWERNET‑3780 버그 특정 PSD 파일을 로드하지 못함.
VIEWERNET‑5475 개선 Spreadsheet 문서를 HTML로 렌더링할 때 “상위 행 고정” 지원을 추가함.
VIEWERNET‑5490 개선 Spreadsheet → 임베디드 HTML에 임베디드 글꼴 지원 (위 코드 샘플 참조).

공개 API 변경 사항

추가된 내용

  • com.groupdocs.viewer.fonts.IFontInfo – 기본 인터페이스.
  • 구체적인 글꼴 정보 클래스:
    • WordProcessingFontInfo
    • WordProcessingSubstitutedFontInfo
    • PdfFontInfo
    • SpreadsheetFontInfo
    • PresentationFontInfo
  • com.groupdocs.viewer.fonts.FontStyles – 이제 다양한 속성을 가진 완전한 클래스(이전에는 enum).

제거된 내용

  • com.groupdocs.viewer.fonts.UsedFontInfo – IFontInfo 계층 구조로 대체됨.
  • com.groupdocs.viewer.fonts.FontStyles enum – 새로운 클래스로 교체됨.

이러한 변경 사항은 https://reference.groupdocs.com/viewer/java/ 에서 업데이트된 Javadoc에 반영되어 있습니다.

업데이트 방법

이 라이브러리는 Maven Central을 통해 배포됩니다. pom.xml(또는 Gradle 빌드 파일)을 최신 버전으로 업데이트하십시오.

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

또는 공식 릴리즈 페이지에서 컴파일된 JAR 파일을 다운로드할 수 있습니다:
https://releases.groupdocs.com/viewer/java/new-releases/groupdocs-viewer-for-java-25-12/

자료