Skip to content

Releases

Export4j 0.1.0-rc.3

Export4j 0.1.0-rc.3 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 13 Nov 02:36
7a912d9

Java 21 document layout and generation engine.

Maven BOM: com.mirakyux.export4j:export4j-bom:0.1.0-rc.3.

All 16 library JARs and the BOM were verified and consumed from Maven Central using Gradle metadata and POM-only resolution.

Build commit: 7a912d9d6c4737578ad11d5c9bd4339dae0f9adf. Source release run: https://github.com/mirakyux/export4j/actions/runs/43349185087.

Bundle SHA-256: 53017f437ca2898f9ef17a2ea9a4df60f718ba92388ab2980b65a773af1d04ee.

GitHub Release recovery completed successfully: https://github.com/mirakyux/export4j/actions/runs/43353332394. The original Central release succeeded; its GitHub step failed and was recovered without uploading to Central again.

This is a prerelease; APIs may change.

Export4j 0.1.0-rc.3

本页记录 RC3 相对 RC2 的变化及发布前本地证据;正式发布日期、签名制品和远端消费结果以发布规范中的实际记录为准。Java 基线仍为 21,16 个库与 BOM 统一版本;源码默认构建继续使用 0.1.0-SNAPSHOT。

主要变化

  • DocumentEngine 可以携带不可变的布局及组件预算默认值,普通导出、逐页导出、块源、重放和目标转换继承这些值。单次请求可明确覆盖,修改一个请求不影响复用引擎或其他请求。专用长表入口继续使用自己的预算。
  • PDF 普通 TrueType 文字分别管理 Unicode、CID 和实际 GID,修复不同 Unicode 共用一个字形时提取原文混淆的问题。普通、逐页及 spool 路径保留原文与显式字距;编码容量耗尽时另建字体资源,补充平面码点保留完整映射。
  • 新增 InlineVector/VectorResource,将调用方已生成的有界矢量轮廓及逻辑文字作为一个不可拆分对象,支持正文、表格、固定页区和流式路径。HTML/Markdown 图片占位符可通过显式资源注册映射到矢量,模型编辑、模板求值和重放保留对象与来源的原子绑定。
  • 对符合条件的图文混排行保留原生 PDF 文字,改善常规提取器对中文表头的提取;同时修复字段/矢量原子标记长度与展开文字长度混用导致的后续链接偏移。原生路径限于 LTR、静态 TTF、无装饰、实际码点与 GID 逐一对应的安全整行,复杂塑形及含字段/矢量的行继续使用原轮廓路径。
  • 只含 Fixed/Auto 列的语义表格为不可拆分的行内图片、字段及矢量保留内容下限,避免有可行列宽分配时仍被相邻长文字挤窄。显式最大列宽和页面空间仍须足够,跨列约束按真实覆盖区间处理。
  • 字体载入、段落查找、PDF 字形映射、子集及 spool 资源继续采用有明确上限和生命周期的复用。JDK 物理字体加载改用私有 FontData 的独立只读游标,省去传入前的整份字节克隆;加载边界仍做防御复制,不改变文档、公式和图片质量。
  • 公开文档站提供中英文指南、完整 API 侧栏和当前页面的语言切换,补充行内矢量 API 与实际接入说明。可选本地设计器继续在 Maven 库与 BOM 发布范围之外。

其他修复

  • 完整布局与逐页入口统一累计脚注、正文和尾注的语义源预算,组件绘制累计计费并响应取消,避免通过分块或嵌套绕过已有工作上限。
  • DOCX 路径写出使用同目录原子替换,失败保留原目标;取消与有界读取贯穿相关输入和转换路径。借用输出流仍由调用方拥有,失败可能留下部分字节。
  • PDF 语义恢复保留阅读顺序;列表推断不补造缺失数字父项,混合缩进、跳级和零序号等不确定结构保留完整标记及正文并报告损失。
  • 离线 PDF 信任验证可遍历多条候选证书链,逐条验证约束及匹配撤销证据;循环、搜索和证据工作共享有限预算并响应取消,不读取系统信任库或自动联网。
  • 修复 SVG miter limit 一致性及设计器字体、资源历史、预览状态和表格手势;设计器的有界请求队列隔离上传、取消和静态资源请求。

兼容性与已知限制

  • 公共 API 仍处于候选阶段。本轮 RC3 构建相对已发布 RC2 检查了 741 个可访问类型,结果为 0 项不兼容、28 项新增、0 项第三方类型泄漏。签名兼容不保证所有布局、提取顺序及渲染像素保持不变。
  • 表头继续计入源行预算,例如 10,000 行正文加一行表头需要至少 10,001 源行额度;增加这一额度不会同时提高其他文字、绘制、资源或输出上限。
  • 矢量入口不解析任意 TeX、SVG 或 MathML,不提供 TeX↔OMML 转换。PDF 用实际轮廓和 ActualText 保留逻辑文字,忽略该属性的提取器不保证能恢复原公式。DOCX/Web 默认拒绝矢量,只有明确 INLINE_VECTOR/DEGRADE 才保留逻辑文字并报告损失;XML v1 保存对所有策略均拒绝矢量。
  • 生产依赖继续采用未修改的官方 PDFBox/FontBox 3.0.8,没有内嵌 FontBox 源码、定制同名类或可选补丁构建。字体内部快照和解析分配仍存在,close() 不代表仍被引用的堆数据立即回收。
  • 缓存限额及源字节预算不等于实际堆或进程 RSS 上限。本次文献验收没有重新测量分配、耗时、堆、RSS 或容量,不提供固定提速、内存减半或普遍容量保证。

已有本地验证

本轮明确使用 0.1.0-rc.3 版本,完成 build、sbom、publishLocalBundle 及 production/capabilities/inlineVectors 样例生成。Java 测试报告合计 2,441 项,失败、错误及跳过均为 0;部分任务从 Gradle 构建缓存恢复,不将该数量描述为全部测试逐例重新运行。候选文档站 407 页生产构建通过。

本批新 SBOM 中 13 项第三方 Java 运行依赖在 2026-11-13 的 OSV 查询中没有已知公告命中。这是确切版本在查询时点的结果,不构成安全保证,也不覆盖未收录缺陷、原生载荷、字体、JDK 或构建工具。

开发版本接入批次已完成全仓构建、SBOM、本地 Maven 包和 API 检查,分别验证 Gradle 元数据、仅 POM 的 Gradle 消费以及真实隔离 Maven 消费。检查覆盖 16 个库及 BOM,48 个自研二进制/源码/Javadoc JAR 没有内嵌 FontBox;官方 FontBox 的 192 个类各只有一个提供者。临时密钥签名演练覆盖 82 项制品及篡改拒绝,该测试身份不是正式发布签名身份。

独立矢量样例包含 1 页、3 个资源、8 次呈现,完成实际路径、基线、原子标记、PDFium 原 TeX 搜索/选区,以及 PDF 双引擎、SVG 和 PNG 全页对照;5 项负控制均被拒绝。它不替代任意公式或真实文献验收。

两篇真实文献共 17 页,保留 10 张表、26 个合并单元格、29 处公式 PNG 及 1 张原图;这 29 处公式没有转为矢量。27,077 个稳定字符框及 3,416 处源空白边界通过检查,三种提取器均恢复目标中文表头。Poppler/PDFium 共 34 次同引擎比较中,32 次全页像素相同;中文第 2 页保留明确记录的原生字形差异、表头提取顺序修正及一处最多 4 灰阶的旧空格淡像素差异。全部页面和差异已复查,没有将结果写成全文像素相同。

本轮本地 RC3 的 16 个库二进制 JAR 与上述 17 页验收批次逐项字节相同,合计 2,151 个 ZIP 条目、1,287 个类;因此复用该批次的 17 页结构、提取及双引擎渲染证据,没有将其描述为重新生成的文献验收。

RC3 新版本的 Gradle 元数据及仅 POM 两种隔离消费均通过。每种模式实际解析的 16 个库 JAR 均与本地候选制品 SHA-256 匹配,16 个库与 BOM 共 17 个项目组件均为 0.1.0-rc.3。新 API 验证任务从这些 JAR 编译并运行 InlineVector 样例,生成 PDF/SVG/PNG;两种模式共 4 份 PDF 完成真实路径、基线、逻辑文字及链接框的独立检查,最大几何误差约 0.00000125 pt,144 DPI 的 Poppler/PDFium、PNG 与 resvg 对照通过。

production 独立验收通过;capabilities 使用临时自签测试证书,通过 OpenSSL 实际验签及篡改拒绝,这不是 Maven 正式发布签名。发布工作流已配置生成并独立检查 inlineVectors 样例,隔离消费脚本包含新 API 验证任务;这些配置不表示远端工作流已运行。

正式 Maven 制品签名、Central 上传及远端消费由发布工作流分别核验;本地验收不替代这些结果,具体状态以发布规范中的实际记录为准。

用法见引擎预算、文字 API、行内矢量、自动列宽及文献接入。

What's Changed

  • release: prepare Export4j 0.1.0-rc.3 by @mirakyux in #2

Full Changelog: v0.1.0-rc.2...v0.1.0-rc.3

Export4j 0.1.0-rc.2

Export4j 0.1.0-rc.2 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 06 Nov 18:04
88d2bcd

Java 21 document layout and generation engine.

Maven BOM: com.mirakyux.export4j:export4j-bom:0.1.0-rc.2.

All 16 library JARs and the BOM were verified and consumed from Maven Central. Assets include the signed Maven publication bundle, public key, SBOM and verification reports.

Bundle SHA-256: 98bd7289a77aa2b579de15a6d97fe155aec0f90ea624a3086780bd0ea0978c67.

This is a prerelease; APIs may change.

Export4j 0.1.0-rc.2

本候选版本补充常用 API 短入口、普通文档逐页导出及按需块源,并降低完整布局和 PDF 写出的重复资源占用。Java 基线保持为 21,16 个库与 BOM 使用同一版本;可选设计器不在 Maven 发布范围内。

主要变化

  • 常用输出入口支持 Path、File、字符串本地路径和借用的 OutputStream;补充字体组合、图片尺寸、页面单位、行源及文档转换的便捷入口。HTML/Markdown 的字符串正文与文件路径仍使用明确不同的方法。
  • DocumentEngine.exportPaged 按页交付布局和绘制结果,返回轻量摘要;exportSemantic/exportReplay 使用按需 BlockSource,分别提供准确总页数的单遍导出和稳定来源的显式重放。
  • 有界复用相等的模型样式、单元格和表格几何值,减少字符串校验、字体程序和绘制资源的额外副本;PDF 逐页后端进一步复用字体子集、图片及磁盘索引。
  • 普通 PDF 保存关闭对象流打包,降低保存阶段的额外全图索引占用。正文、字体和图片流继续使用各自既有压缩。

兼容性与已知限制

  • 既有完整布局和导出入口继续返回完整 Layout IR/Display List,内存需求随输入和页数增长。需要降低大文档工作集时,显式选择逐页、块源或长表行源入口,并配置适合输入规模的有限预算。
  • 本轮万页复杂样例中,128 MiB Java 堆的单向块源加 PdfSpoolBackend 三次成功;512 MiB 的完整模型、完整布局加普通后端三次成功,但堆余量有限。128 MiB 的完整模型入口仍出现内存不足。这些有限样例不构成任意内容、页数或堆配置的容量保证。
  • 关闭对象流打包会使部分 PDF 增大;本轮普通万页样例由约 34.56 MiB 增至 43.57 MiB,增加约 26.1%。文件体积取决于内容,不能把该比例当作固定成本。
  • PdfSpoolBackend 输出普通 PDF,不扩展 PDF/A、PDF/UA、加密或签名支持。逐页入口不支持的交互和来源声明会明确拒绝;可编辑表单等需求继续使用相应完整入口。
  • 路径输出继续采用同目录原子替换,失败保留旧目标;输出流由调用方拥有,失败可能留下部分字节。重放要求相同业务快照和确定性组件,不隐式重新查询动态数据。
  • 公共 API 仍处于候选阶段。本轮相对已审查候选基线的 JVM 签名检查没有不兼容项;此检查不等同于所有行为和视觉结果均保持不变。

发布前验证

Windows/Java 21 本地批次完成全仓构建、本地 Maven 包和隔离调用方验证,2,347 项 Java 测试无失败、错误或跳过。独立结构检查、Poppler/PDFium 渲染及视觉抽样覆盖受影响输出;容量验证包含大表、多字体、不同透明图片、重复调用、并发、取消和预算失败。归档样例通过 veraPDF PDF/A-2b 检查。

这些是发布前本地结果。正式 RC2 制品由发布工作流重新构建、签名、审计依赖、核对 BOM/SBOM、验证签名篡改拒绝,并在上传前后分别使用隔离 Maven 调用方验证准确制品。远端 CI 和正式发布状态以对应 Actions 运行结果为准。

用法与边界见常用链式 API、逐页文档导出、语义长表与重放及发布规范。

What's Changed

New Contributors

Full Changelog: https://github.com/mirakyux/export4j/commits/v0.1.0-rc.2