本次发布的新功能

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 也已从枚举改为功能完整的类。

Note: 文档章节 获取已加载文档中使用的所有字体 已重新编写，以涵盖这些更改。

Spreadsheet → HTML 的嵌入式字体

在使用工厂方法 HtmlViewOptions.forEmbeddedResources() 将 Spreadsheet（.xls、.xlsx 等）渲染为 嵌入式 HTML 时，字体将自动以 Base‑64 编码方式嵌入，除非显式将 isExcludeFonts() 标志设置为 true。

// Example: Convert a Spreadsheet to embedded HTML with fonts embedded
HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources("output.html")
options.setExcludeFonts(false); // default is 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 – 现在是一个拥有众多属性的完整类（此前为枚举）。

已移除

  • com.groupdocs.viewer.fonts.UsedFontInfo – 已由 IFontInfo 层次结构取代。
  • com.groupdocs.viewer.fonts.FontStyles 枚举 – 已被新类取代。

这些更改已在更新后的 Javadoc 中体现：https://reference.groupdocs.com/viewer/java/。

如何获取更新

该库通过 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/

资源