Skip to content

Releases

v0.16.0

Choose a tag to compare

@donglua donglua released this 19 Nov 06:10

发布页面:v0.16.0 Release。

本版本新增 XLSX 单元格与区域选择复制全端支持(core / Android / HarmonyOS NEXT / macOS)、PPTX 图表与预设几何/虚线描边/连接线箭头扩展,以及 DOCX 表格单元格边框、背景底纹与垂直对齐全端支持,项目名称统一更名为 JZOfficeKit,schemaVersion 保持 9 不变。

排版与特性

  • DOCX 表格单元格边框、背景底纹与垂直对齐(core / Android / HarmonyOS NEXT / macOS):

    • 核心解析(core):Element 新增可选矩阵字段 cellValigns(0 顶部、1 垂直居中、2 底部)与 cellBorders(每格四边 [top, right, bottom, left] 的 { color, width },w:val="none" | "nil" 时为 0),继承表格级/单元格级边框与 <w:shd> 底纹解析(schemaVersion 保持 9)。
    • 三端渲染:Android(viewer)、HarmonyOS NEXT(viewer-ohos)与 macOS(viewer-macos)同步实现单元格四边独立边框绘制、合并单元格填充与单元格级垂直对齐排版。
  • XLSX 单元格与区域选择复制(Android / HarmonyOS NEXT / macOS):

    • 三端同构选区模型:新增零 UI 依赖的纯逻辑模型 SheetSelectionModel(Java / TypeScript / Swift),统一实现二维网格锚点-焦点选区、合并单元格不动点闭包扩张(选区与任何合并区域相交即并入其完整范围并迭代到稳定,避免选区被合并区域切开)、冻结窗格感知的 hitTest(按冻结边界消解滚动偏移,锁定轴不叠加滚动量,拖拽时按 clampToBounds 钳位到表格边缘继续扩选)、全选范围与 TSV 格式化。三端模型由同一套 111 项断言逐条校验,语义完全一致。
    • 合并单元格闭包吸附:单格落在合并区域内即自动扩张为整个合并区域;恰好覆盖单个合并区域时视为"逻辑单格",直接输出该单元格文本而非带尾随制表符的网格。
    • TSV 剪贴板格式:多格选区按行优先导出,同行可见列以 \t 分隔、跨行以 \n 分隔;隐藏行与隐藏列整条跳过(不留空列空行);合并区域从属位置输出空串以保持矩形对齐;含制表符/换行/回车/双引号的文本按 RFC 4180 用双引号包裹并把内部引号翻倍;选区内全为空文本时返回空串,不复制出纯空白网格。
    • 四象限高亮裁剪:选区填充(#261A73E8)与外框(#FF1A73E8,1.5 物理像素)在滚动区与三个冻结象限分别平移并裁剪绘制,跨冻结边界的选区不会覆盖冻结区,也与 Excel / WPS 的分块观感一致。
    • 行列标头联动高亮:落在选区行/列范围内的行号与列标改为 #D2E3FC 底色与 #174EA6 加粗文字,四个标头段(可滚动列、冻结列、可滚动行、冻结行)各自一致生效。
    • 交互:移动端长按选格后不抬手即可拖动扩选,并支持拖拽选区左上/右下双角手柄拉伸(固定物理尺寸、24dp/vp 热区)与边缘自动滚动;macOS 支持鼠标点选与拖拽框选。浮动「复制 / 全选」气泡复用既有 SelectionPopupMenu / SelectionMenuBubble。
    • 公开 API 闭环:selectAll / clearSelection / hasSelection / getSelectedText / copySelection 三端在 XLSX 下全部生效,selectAll 选中整表可见数据区(空表返回 false);Android 无障碍的「全选文本 / 复制选中文本 / 清除选区」不再排除 XLSX;macOS 支持 Cmd+A / Cmd+C 与右键菜单。切表、双击缩放、重新加载与 clear() 均清除选区。
    • 手势零退化:单指平滑滚动、惯性 Fling、双击缩放与双指捏合缩放行为不变;选区拖拽期间平移手势主动让路。捏合缩放对表格保留选区(缩放停稳后气泡重新贴回),双击缩放按设计约定清除表格选区(缩放过后的旧选区已无参考意义),DOCX / PPTX 的文本选区行为完全不变。
  • PPTX 图表扩展(core):

    • 横向条形图:识别 barChart 且 barDir="bar"(grouping 为 clustered / standard),按分类均分槽高、按数值比例从左向右绘制条形,数值全非负时自动把 0 纳入数值轴范围。
    • 饼图与环形图:新增 pieChart 与 doughnutChart 支持,扇区以三次贝塞尔拟合圆弧(每段圆心角不超过 90°,控制点切向系数 4/3·tan(α/4));环形图解析 <c:holeSize>(合法 1..=90,默认 50,内径比钳位到 0.1..=0.9),生成外弧与反向内弧闭合路径;单扇区 100% 时直接绕外圆闭合,不产生中心半径线。
    • 扇区配色与图例:优先使用 <c:dPt> 声明的填充色,未声明时回退主题强调色;图例按分类名逐项生成色块与文本。
    • 无坐标轴容错:饼图与环形图不再要求存在 catAx / valAx,缺失坐标轴时仍可正常渲染。
  • 预设几何扩展(core):新增 22 种高频 prstGeom(合计 26 种可绘制形状),覆盖 parallelogram、trapezoid、pentagon、hexagon、octagon、plus/mathPlus、snip1Rect、round2SameRect、四向箭头与双向箭头、chevron、homePlate、notchedRightArrow、star4/star5、flowChartProcess/Decision/Data/Terminator/Document 与 wedgeRectCallout。统一提取 adj 调整值读取函数,非法公式仍按既有语义整体省略并告警。

  • 虚线描边与连接线箭头(core / Android / HarmonyOS NEXT / macOS):

    • core 解析 <a:prstDash> 并按线宽换算为 Element.strokeDash(Vec<f32>,实线时按 skip_serializing_if 省略,旧文档 JSON 结构不变),支持 dot/sysDot、dash/sysDash、lgDash、dashDot/sysDashDot、lgDashDot、lgDashDotDot/sysDashDotDot。
    • 连接线 headEnd / tailEnd 编译为主干与端点箭头子路径(triangle/stealth 实心三角、arrow 开叉双翼线、diamond/oval 端点),按 len/w 属性缩放并受线段长度约束,实心箭头自动内缩主干避免刺穿尖端。
    • 三端分别以 DashPathEffect(Android)、ctx.setLineDash(HarmonyOS NEXT / macOS)绘制虚线,并在每次描边后立即恢复实线,避免样式泄漏。

测试

  • 新增 core/tests/docx_table_styling.rs(15 项用例)与 Android PptxTableChecks 校验 DOCX 表格单元格边框、底纹与垂直对齐;同步扩展 DocumentDecoderChecks.java 与 macOS JZOfficeTests.swift(全套 47 项用例通过)。
  • 新增纯 JVM scripts/tests/SheetSelectionChecks.java(111 项断言)与纯 TS scripts/tests/SheetSelectionChecks.ts(111 项断言 + 24 项集成静态检查),两者逐条对齐,并接入 CI rust-and-jvm 作业。
  • 不动点闭包用例使用相互重叠的合并区域构造,并已通过变异测试验证:把 resolve 退化为单轮遍历时该用例以 endColumn=2 失败,确保「不动点」语义真正被锁定(相邻但不重叠的合并区域在合法数据下无法串联,无法区分单轮与不动点)。
  • 扩展 Android 设备端 selection 套件的 XLSX 段:全选整表 TSV、Tab/换行结构、高亮像素比对、剪贴板往返、长按选中单元格、拖动扩选成多格网格、单击清除、切表清除选区与单指滚动零退化。
  • 扩展 macOS JZOfficeTests.swift 新增 16 项 XLSX 选区用例(合并闭包、冻结四象限命中、TSV 与 RFC 4180 转义、四象限裁剪绘制、鼠标换算、切表/换文档清选区、剪贴板),全套 47 项通过。
  • 新增 core/tests/pptx_charts_geometry.rs(15 项用例)覆盖横向条形图、饼图/环形图扇区与配色、22 种预设几何、虚线换算与箭头端点。
  • 扩展纯 JVM scripts/tests/DocumentDecoderChecks.java 校验 strokeDash 解码与非法输入拦截(140 → 155 项断言)。
  • 扩展 macOS JZOfficeTests.swift 覆盖 strokeDash 解码回退与离屏虚线间断绘制(31 项用例全通过)。

细节修复与交互优化

  • 项目更名(全端):仓库与工程对外名称统一更名为 JZOfficeKit,同步更新 Gradle 发布配置、OHPM 包主页与三端文档链接。
  • XLSX 选区手势、冻结窗格与缩放细节(viewer / viewer-ohos / viewer-macos):
    • 统一修复三端拖拽扩选越入行列标头时的坐标钳位(clamp)。
    • Android 端修复向 hitTestSheetCell 传入未偏移视图坐标、修正冻结象限选区裁剪及缩放屏幕边界,并补充设备端缩放触摸与选区恢复校验。
    • HarmonyOS NEXT 端修复冻结窗格选区屏幕矩形映射、平移/惯性滑动/捏合缩放时隐藏与重定位选区气泡,以及拖拽手柄期间拦截长按并隔离单击/双击手势。
    • macOS 端保持跨缩放级别的固定选区描边线宽,并修复光标切换与鼠标按下处理;同时修复紧边界 TEXT 文本框不再被裁切。
  • PPTX 图表与箭头绘制修正(core):对齐条形图坐标轴、饼图图例布局、流程图终止符圆弧及连接线箭头端点细节。

v0.15.0

Choose a tag to compare

@donglua donglua released this 17 Nov 10:14

发布页面:v0.15.0 Release。

本版本主要新增 XLSX 冻结窗格全端支持(core / Android / HarmonyOS NEXT / macOS)与 DOCX / PPTX 正文划词选区及复制能力(Android / HarmonyOS NEXT),并修复 DOCX 行内图水平对齐、文本框自适应及选区交互手势等细节问题。

排版与特性

  • XLSX 冻结窗格(core / viewer / viewer-ohos / viewer-macos):

    • 核心解析(core):Sheet 新增可选字段 frozenRows / frozenColumns(schemaVersion 保持 9,值为 0 时不参与序列化,旧文档 JSON 结构不变);解析 <sheetViews>/<sheetView>/<pane> 的 state="frozen" 与 state="frozenSplit",支持仅冻结行、仅冻结列与行列交叉冻结,兼容 "2" 与 "2.0" 两种整数写法,冻结值按工作表行列维度安全钳位;非冻结的自由拆分(state="split" 或空 state 带非零拆分)只发告警不生效,非整数拆分向下取整并告警,非法数值返回 Error::Invalid。
    • 三端渲染:Android、HarmonyOS NEXT 与 macOS 均以单画布四象限裁剪绘制实现冻结区与滚动区共存,行列标头分段锁定,冻结交界处绘制 1px #9aa5b1 分割线;跨冻结边界的合并单元格在各象限分别平移裁剪绘制。
    • 视口占比保护:按 X/Y 轴独立判断冻结区是否超过可用正文区的 75%,高倍缩放或小窗口下仅取消超限的那个轴,避免正文被冻结区挤满。
    • 检索高亮与跳转避让:命中高亮按象限裁剪,滚动区高亮不会覆盖冻结区;跳转命中冻结行/列时该轴保持当前滚动位置,命中滚动区时才对齐到可滚动视口中心。
    • macOS 视口修正:.xlsx 分支改为传入真实滚动视口 docVisible,并在 NSScrollView 滚动时触发重绘,修正长表格滚动时连外围行列标头一起滚走的问题。
  • DOCX / PPTX 正文划词选区与复制(viewer / viewer-ohos):

    • 纯逻辑选区模型(双端同构):新增 TextSelectionModel.java(纯 Java 11,零 android.* 依赖)与 TextSelectionModel.ts(纯 TypeScript,零 ArkUI / @kit.* 依赖),语义与 macOS 端 TextSelectionModel.swift 保持一致:块索引 + UTF-16 码元偏移定位、锚点/焦点支持反向拖选、代理对边界夹紧、跨段落与跨块 \n 拼接、命中测试、分词选词、选区高亮矩形与手柄几何计算。core/ 与 schemaVersion 保持 9 不变。
    • 排版几何衔接(Android):新增 AndroidTextLayoutBuilder,把 OfficeRenderer 的 StaticLayout + Matrix 布局结果转换为文档文本索引,直接复用系统排版度量保证“所见即所选”,兼容多字体混排、上下标、字间距与四类对齐;表格按非空文本单元格聚合成独立块(行优先);PPTX 远端未排版页先建纯文本轻量占位块,滚入视口后再懒补行几何,blockIndex 在补全前后严格稳定。
    • 排版几何衔接(HarmonyOS):CanvasElementDrawer 新增 buildParagraphsBlockLines / buildElementTextBlocks / extractElementFullText / CanvasTextLineMetrics,行度量与既有检索高亮共用同一套坐标规则(两端对齐拉伸、字符间距、居中/右对齐偏移、段落 before/after 与元素垂直对齐);普通文本块由 Text/Span 统一为 Canvas 绘制,与绕排图文块排版间距完全一致。
    • 触屏交互:长按默认选词并支持不松手直接滑动扩选,松手展示起止水滴手柄与浮动气泡(「复制」/「全选」),支持拖拽手柄微调(可跨越锚点反向选择)与四边自动滚动;拖拽时对触点纵向补偿避免指腹遮挡。单击空白清除选区,双击缩放与双指捏合、惯性 Fling、单指滚动均不退化。
    • 绘制与无障碍:选区高亮 #551A73E8、光标竖线 2vp 与固定物理尺寸水滴手柄;Android 通过 onInitializeAccessibilityNodeInfo 补充“全选文本 / 复制选中文本 / 清除选区”自定义动作,HarmonyOS 浮动气泡样式对齐 OfficeSearchBar。
    • 编程控制 API(双端对齐):Android OfficePreviewView 与 HarmonyOS OfficePreviewController / OfficePreviewActions 均提供 selectAll、clearSelection、hasSelection、getSelectedText、copySelection;剪贴板分别经 ClipboardManager 与 pasteboard.setDataSync 同步写入。打开新文档、清空与组件销毁时同步取消自动滚动、隐藏气泡并清空选区。
    • 支持范围:本期覆盖 DOCX 与 PPTX 的正文段落、文本框、浮动绕排文本与内嵌表格单元格;XLSX 暂不参与自由划词(selectAll 返回 false)。
    • 测试:新增纯 JVM scripts/tests/TextSelectionChecks.java(javac --release 11 -Xlint:all -Werror,已接入 CI)与 Node.js scripts/tests/TextSelectionChecks.ts,并扩展 OhosGestureChecks.ts 覆盖长按与双击阈值回归;Android 端新增设备 selection 专项 suite。

细节修复与交互优化

  • DOCX 行内图水平对齐与自适应文本框(core / viewer / viewer-ohos / viewer-macos):
    • 保留行内 <wp:inline> 图片所在段落的 jc 水平对齐属性(left / center / right),并在 Android、HarmonyOS NEXT 与 macOS 三端正文及缩略图渲染中按 horizontalAlign 正确居中或右对齐绘制。
    • 修复部分无边框透明不换行文本框的 autofit 尺寸测量,避免文字被误换行或截断;macOS 端同步居中画布上的文档与行内图形。
  • 选区交互与排版细节(viewer / viewer-ohos):
    • Android 端修复 StaticLineMetrics 非尾行边界保留、双击缩放时收起选区浮动气泡以及 PPTX 滚动进视口页面的选区布局懒补全。
    • HarmonyOS NEXT 端对齐行边界手柄吸附偏好与反向选区矩形归一化,保留 PPTX 组合/元素变换到选区高亮中,对齐 DOCX 表格高亮、空段落高度及延迟索引构建,并消除长按选词/缩放与平移单击手势的冲突。

v0.14.0

Choose a tag to compare

@donglua donglua released this 16 Nov 02:54

发布页面:v0.14.0 Release。

本版本主要新增 DOCX 浮动图形、DrawingML 形状/文本框与文字环绕全端支持,引入元数据与首屏缩略图轻量路径、解析结果缓存及延迟构建搜索索引优化,并修复多项鸿蒙 NEXT 端渲染、交互与内存问题。

排版与特性

  • DOCX 浮动图形、DrawingML 形状与文字环绕(core / viewer / viewer-ohos / viewer-macos):
    • 核心模型与解析(core):支持 <wp:anchor> 浮动定位、环绕模式(SQUARE / TOP_AND_BOTTOM / TIGHT / THROUGH / 衬于文字下方 / 浮于文字上方)、水平对齐、层级关系(behindDoc)与四向环绕边距(distTop / distBottom / distLeft / distRight),保持无环绕段落流的连续性(仅在行内图片切分段落流时提示告警);支持解析 DrawingML 形状与组合图形(<wps:wsp> / <wpg:wgp>)及形状内部文本框(<wps:txbx>)。
    • 全端渲染与排布:Android(viewer)、HarmonyOS NEXT(viewer-ohos)与 macOS(viewer-macos)三端实现浮动元素 Z-order 分层绘制、文字避让环绕排布及检索高亮/选区坐标对齐,并补充各端解码与环绕排版回归测试。

性能

  • 元数据与缩略图的轻量路径(core / viewer / viewer-ohos / viewer-macos):
    • 新增 native 轻量元数据接口(metadata_path_to_json / NativeCore.metadata / readMetadataAsync / jz_office_metadata_path),元数据速读只读取判定格式与页数所需的少量 ZIP 部件,不再触发整篇文档的样式、几何与文本解析,输出独立的紧凑协议。
    • 缩略图改走首屏范围解析:PPTX 只渲染首张幻灯片,XLSX 只解析首个工作表,DOCX 只解析首屏正文块并在排版越过首页视口底部后停止。封面像素与完整解析一致,但不再承担整篇文档的解析与排版成本。
    • 新增按 文件路径 + 大小 + 修改时间 + 解析范围 命中的解析结果缓存。同一文件连续执行「元数据 → 缩略图 → 打开预览」不再重复解析;更完整的解析结果可直接服务封面请求,文件内容变化后自动失效。clear_package_cache / evict_package_cache 一并清理该缓存,避免检索索引与解析结果错配。
  • 延后构建全文检索索引(core):
    • 文档打开与解析时不再同步构建全文检索索引,改为首次检索时按需建立轻量索引,并按保留文本字节上限管理缓存淘汰;另提供 prewarm_search_index 接口供按需显式预热。
  • 鸿蒙端 PPTX 视口二分定位与离屏图片释放(viewer-ohos):
    • 新增 resolvePptxVisibleRange 按页面纵坐标二分定位当前视口可见幻灯片区间,drawPptx 仅遍历可见区间,消除长演示文稿每帧线性扫描的开销;修正 ImageStore 低清图命中后高清升级与并发解码所有权竞态,并在滑动离屏后主动释放非可见 PPTX 页面图片资源。

细节修复与交互优化

  • 鸿蒙端 XLSX 双层工作表标签栏(viewer-ohos):
    • SpreadsheetView 此前自绘一条工作表面板,接入标准组件 OfficeSheetTabs 后会额外再出现一条,形成上下两层重复的切表入口。现移除预览视图内嵌的标签条,切表 UI 统一由 OfficeSheetTabs 承担,与 Android、macOS 的组件分工一致;未接入该组件的宿主仍可通过 controller.selectSheet(n) 切表。
    • OhosGestureChecks 新增回归断言,禁止预览视图再次内嵌横向工作表标签栏。
  • 鸿蒙端惯性滑动按下即停与防误触双击缩放(viewer-ohos):
    • PPTX 与 XLSX 自绘视图原先只在 PanGesture.onActionStart 中终止惯性,而该回调需手指移动超过识别距离才触发,导致滑动惯性尚未衰减完时按住屏幕,内容仍继续滑走。改为在 onTouch 的 TouchType.Down 立即停止惯性,与 Android GestureDetector.onDown 的 scroller.forceFinished(true) 行为对齐。
    • 为 DOCX / PPTX / XLSX 视图的 TapGesture({ count: 2 }) 配置 distanceThreshold: 3,避免单指滑动被累计误触发双击缩放,并在单指 PanGesture 开始时取消旧缩放补间动画;OhosGestureChecks 已补充对应回归校验。

0.13.1

发布页面:v0.13.1 Release。

v0.13.1

Choose a tag to compare

@donglua donglua released this 12 Nov 12:58

发布页面:v0.13.1 Release。

本版本主要增强 DOCX 排版完整度(保留文本框文字内容、支持图片裁剪映射),并优化鸿蒙 NEXT 端 PPTX 滑动渲染性能与末页页码计算。

排版与特性

  • DOCX 文本框内容保留(core):
    • 支持解析 w:pict、w:object 和 w:txbxContent 内部文本框段落,将其内容按流式保留在文档正文中,避免此前直接跳过文本框导致文字丢失。
  • DOCX 图片裁剪映射(core):
    • 解析图形与内嵌图片的 a:srcRect 裁剪比例属性,映射并投影到现有数据模型的 imageBounds 中;各平台视图层(Android / HarmonyOS NEXT / macOS)无需修改即可自动正确显示裁剪后的局部图片。

细节修复与交互优化

  • 鸿蒙端 PPTX 滑动重绘与页码修正(viewer-ohos):
    • 优化高频滑动过程中的重绘通知逻辑,仅在页码实际变化时通知 ArkUI 状态与外部回调,降低冗余渲染开销。
    • 修正 PPTX 视口滚动到底部边界时因上一页可见面积较大而无法选中末页的问题,确保首尾边界页码准确对应。

v0.13.0

Choose a tag to compare

@donglua donglua released this 12 Nov 06:09

发布页面:v0.13.0 Release。

本版本主要支持跨平台字体族解析与排版修饰属性(字体回退、字间距、字重、上下标、删除线)、高级段落间距与网格间距补偿,以及全端文本高亮、段落底纹与段落边框高保真渲染。

排版与字体属性

  • 跨平台字体族解析与排版修饰(core / viewer / viewer-ohos / viewer-macos):
    • 核心模型下沉(core):数据模型新增完整 Typography 支持,涵盖西文字体族(font_family)、东亚字体族(font_family_east_asia)、通用字体族类别(GenericFontFamily:Serif / Sans-Serif / Monospace)、字间距(spacing)、基线偏移与上下标(baseline)、单/双删除线(strike / double_strike)以及标准化字重(weight 100–900)。
    • 文档解析支持:DOCX、PPTX 及 XLSX 全面支持字体族提取与东亚字体(中文字符)优先匹配规则;XLSX 单元格样式支持提取字体族、删除线及垂直对齐方式。
    • Android 端(viewer):引入通用字体族后备映射系统与 Typeface 缓存池,支持字重匹配、字间距(letterSpacing)、上下标基线对齐与删除线渲染;修复细字重(Light)与加粗样式的兼容表现。
    • HarmonyOS NEXT 端(viewer-ohos):支持字体族级联回退、Canvas 文字排版字间距补偿,以及 DOCX 上下标基线偏移对齐。
    • macOS 端(viewer-macos):接入 CoreText 字体匹配与系统通用字体回退;新增有界 TypefaceCache(LRU 缓存)避免高频文本测量与绘制时重复解析字体对象。

段落间距与网格补偿

  • DOCX 高级段落间距与网格补偿(core):
    • 支持行数单位段落间距(lineRule="auto" 行距计算),解析上下文间距标记(w:contextualSpacing)自动消除同级段落间的重复间距。
    • 引入文档网格行间距补偿算法(w:docGrid pitch compensation),精准对齐 Word 标准排版网格。
  • PPTX 段落间距与排版对齐(core):
    • 支持百分比与点数行距/段前段后间距(spcPct / spcPts)计算。
    • 支持两端对齐(justified alignment)排版。

底纹、边框与文本高亮

  • 文本高亮与段落底纹边框(core / viewer / viewer-ohos / viewer-macos):
    • 模型与解析(core):支持解析文本高亮颜色(w:highlight)、段落底纹填充(w:shd)及段落上下左右与段间边框(w:pBdr),并对边框线宽实施安全钳位与边界校验。
    • 全端绘制支持:Android Canvas、鸿蒙 NEXT Canvas 与 macOS CoreGraphics 原生预览层均已完整支持段落底纹区域填充、多边边框线条绘制与文本 run 背景高亮矩形渲染。

细节修复与稳定性

  • PPTX 属性继承修复:修复当幻灯片段落显式声明 baseline=0 时意外继承母版/上下文基线偏移的问题。
  • 排版与测试规范:统一修复核心层边框计算边界条件,规范测试用例断言风格与格式化。

v0.12.0

Choose a tag to compare

@donglua donglua released this 10 Nov 06:10

发布页面:v0.12.0 Release。

本版本主要支持 DOCX 表格单元格内图片解析与全端渲染对齐、表格边框样式支持,以及 macOS 原生预览端重大架构重构(接入 OfficeImageLoader 异步按需解码、视口裁剪虚拟化渲染与滚动页码感知)。

平台与架构

  • macOS 端视口虚拟化与异步解码架构(viewer-macos):
    • 解耦预加载:新增 OfficeImageLoader,文档打开阶段彻底解耦整篇图片预加载,采用异步队列按需解码与 LRU 内存预算管理。
    • 滚动视口监听:监听 NSClipView 滚动视口边界,动态计算可见区域并按需触发当前页及邻近页图片解码。
    • 绘制层视口裁剪:PPTX 幻灯片与 DOCX 页面接入视口可见区域裁剪,非视口内的元素直接跳过绘制,大幅降低长文档渲染与合成开销。
    • 动态页码与资源释放:支持基于视口滚动几何中心动态感知当前页码与跨页通知;离开视口的离屏图片资源受 LRU 内存预算管控并优雅释放。
    • 演示工程重构:规范 macOS Demo 入口为 JZOfficeMacDemoApp.swift,清理冗余 benchmark 文件。

DOCX 排版与特性

  • 表格单元格图片解析与排版(core / viewer / viewer-ohos / viewer-macos):
    • 解析核心(core):支持提取 DOCX 表格单元格内嵌入的图形图片(w:drawing / pic:pic),计算原始/建议宽高,并在数据模型中安全透出。
    • Android 端(viewer):OfficeRenderer 支持单元格图片异步加载、水平居中排版与上下内边距自适应,保持文本与图片混排稳定。
    • HarmonyOS NEXT 端(viewer-ohos):支持单元格图片异步读取与 Canvas 居中绘制,图片加载完成后触发局部脏重绘。
    • macOS 端(viewer-macos):支持单元格图片按需加载、自适应高宽比缩放与居中排版。
  • 表格边框样式支持:
    • Rust 核心与三端渲染层完善 DOCX 表格边框样式(top / bottom / left / right / insideH / insideV)解析与粗细/颜色渲染。

稳定性与修复

  • macOS 端图片缓存与生命周期修复:
    • 修复连续快速翻页时,前序页面图片被 LRU 缓存自我淘汰导致返回后出现灰块占位的问题。
    • 修复 OfficePreviewView 在 teardown 析构时越权关闭外部注入的共享 imageLoader 的问题。
    • 优化视口快速重入时的取消与请求队列复用,避免多线程竞态与无效重解。
    • 补充 OfficeImageLoader 视口虚拟化、预算超限淘汰及与 OfficePeek 的集成兼容性测试用例。
  • 代码规范:
    • 格式化 Rust 核心 docx_tables.rs,确保通过 cargo fmt 检查。

v0.11.0

Choose a tag to compare

@donglua donglua released this 09 Nov 08:47

发布页面:v0.11.0 Release。

本版本主要新增 macOS 原生平台支持、三端跨平台全文检索与搜索交互组件、DOCX 编号列表与表格合并排版增强,以及多项端侧渲染与稳定性优化。

平台与架构

  • macOS 原生平台支持(viewer-macos):
    • 新增基于 CoreGraphics / CoreText / ImageIO / SwiftUI 的原生预览组件,提供纯 Swift API 与标准预览控制接口。
    • 支持编译生成 Apple Silicon(arm64)与 Intel(x86_64)通用静态库及 XCFramework,并接入 GitHub Actions 自动化归档与发布。
    • 支持按页缩略图绘制、幻灯片跳转滚动以及矢量 PDF / PNG 导出能力。
    • 引入空间索引与文本选择模型(DocumentTextLayout),支持鼠标拖拽选区、连续多击选词/选行、光标适配与快捷键复制(⌘C)。
  • 三端全文检索与搜索组件(core / viewer / viewer-macos / viewer-ohos):
    • Rust 核心下沉跨平台全文检索协议,支持 DOCX、PPTX、XLSX 跨 run 文本匹配与 UTF-16 偏移精确计算。
    • Android、macOS 与 HarmonyOS NEXT 三端支持检索关键词高亮绘制、命中项视口居中平滑滚动以及开箱即用的搜索交互栏组件。
    • 优化 XLSX 表格全量检索命中绘制性能,避免高亮覆盖冻结表头与跨合并单元格错位。

DOCX 排版与特性

  • 编号与多级列表:解析 numbering.xml 自动编号与多级列表,正确继承外层占位符引用及数字格式。
  • 单元格合并:支持表格横向跨列(gridSpan)与纵向跨行(vMerge)合并,完善缺列闭合与覆盖单元格边界处理。
  • 排版对齐与缩进:支持字符单位段落缩进(leftChars / firstLineChars)与三端两端对齐(justified)拉伸排版。
  • 主题字体解析:支持从 word/theme/theme1.xml 解析 EastAsia 主题字体,优先匹配中文字体避免日文字体抢占。

渲染与修复

  • DOCX 属性与符号修复:修复段落标记 rPr 泄漏至所有 run 以及隐藏段尾符致整段消失的问题;修复带 bullet 段落搜索高亮重复累加偏移的问题。
  • HarmonyOS 端检索交互:修复检索命中样式在列表复用后不刷新、关键词变更后高亮未刷新以及 bullet 匹配渲染问题。
  • macOS 端坐标与选区:修复 DOCX 检索高亮坐标转换、段尾两端对齐及表格文本框选问题。

工程与文档

  • 升级 Android 构建插件至 9.5.1。
  • 将 Android 无障碍设备测试移出常规 Push/PR CI,转为独立按需手动触发工作流。
  • 新增英文版 README.en.md 并提供中英文互链。

v0.10.0

Choose a tag to compare

@donglua donglua released this 08 Nov 08:01

发布页面:v0.10.0 Release。

本版本主要新增 OfficeMetadata、OfficeThumbnail、OfficeSheetTabs 三个标准组件,并升级双端手势缩放越界回弹与鸿蒙 PPTX 统一矢量视口。

手势与视口

  • 缩放越界抵抗与回弹:双端引入橡胶带(rubber-band)阻尼,双指捏合越界后按抵抗曲线让步,松手以 220 ms 减速动画回弹到边界(1.0x/4.0x,表格为 0.5x/4.0x);双击与读屏无障碍缩放动作同样采用该补间。
  • 鸿蒙 PPTX 统一 2D 矢量视口:改用单层全屏 Canvas,支持全向拖拽、displaySync 驱动的惯性抛掷、焦点双指缩放与双击补间缩放,缩放直接作用于绘图矩阵保持矢量清晰,并加入视口裁剪与页码胶囊。

组件化与标准包装

  • 无头元数据读取(OfficeMetadata):Android 与 HarmonyOS NEXT 双端提供无头文档元数据快速读取接口(OfficeMetadata.read / readAsync 与 readOfficeMetadata),支持在不初始化 UI 视图的情况下快速获取文档格式(DOCX / PPTX / XLSX)、页数、宽高尺寸、工作表名称列表及告警信息。
  • 离屏封面/缩略图生成(OfficeThumbnail):Android 端提供 OfficeThumbnail.decode / load API,鸿蒙端提供 renderOfficeThumbnail(filePath, maxWidth, maxHeight),支持双端脱离 UI 视图离屏渲染文档首页面(PPTX 幻灯片、DOCX 首屏、XLSX 工作表)为指定最大边界的 Bitmap / PixelMap,带严格的内存预算与资源自动释放机制。
  • 多工作表切换标准组件(OfficeSheetTabs):
    • Android 沉淀 cn.jingzhuan.lib.office.widget.OfficeSheetTabs 组件,支持 attachTo(OfficePreviewView) 自动联动绑定及窗口重挂载恢复,Demo 模块已完成解耦接入并移除旧私有类。
    • 鸿蒙端导出声明式 @Component OfficeSheetTabs,支持仅传入 controller 自动订阅工作表列表与激活页码联动(非 XLSX 自动隐藏),并接入 demo-ohos 演示工程。
  • 双端多监听器扩展:Android OfficePreviewView 与鸿蒙 OfficePreviewController 均新增 addOnPageChangeListener 与 removeOnPageChangeListener,支持与外部扩展组件解耦联动。

v0.9.0

Choose a tag to compare

@donglua donglua released this 04 Nov 00:50

主要变化

特性与排版

  • PPTX 垂直簇状柱状图:DrawingML 图表管线新增支持垂直柱状图(<c:barChart>,barDir="col",簇状并列 grouping="clustered"),数值轴自动吸附 0 基准线(支持正负值双向延伸),槽位等宽划分并绘制柱体与色块图例;内置演示样例 sample.pptx 图表章节同步更新为柱状图演示页。
  • DOCX 页眉页脚支持:解析 sectPr 节属性中的 headerReference / footerReference 与 pgMar 页边距,Android 与 HarmonyOS NEXT 双端将页眉置于文档流首部、页脚追加至尾部随内容平滑滚动,并支持页眉页脚内独立图片 relationships 映射与多节文档继承逻辑。
  • 鸿蒙 hvigor 自动化增量构建:viewer-ohos/hvigorfile.ts 注册 BuildRustNative 增量任务,在 DevEco Studio 编译或运行 HAR 前自动增量编译 Rust 原生库并同步 .so 与 index.d.ts。

架构与性能

  • XLSX 几何计算下沉至 Rust Core:表格的列宽偏移、行高偏移、可见索引、起始行与合并单元格矩形(SheetGeometry)在 Rust core 中一次性预计算,双端直接消费预计算数据,消除平台层 250+ 行重复计算逻辑,保证双端排版绝对一致。
  • Android geometry 解码消除装箱:Java 端 geometry 数组解码改用基本类型数组(float[] / int[]),消除大表格几何反序列化时的对象装箱开销与 GC 压力。
  • 鸿蒙端合并单元格空间分桶优化:合并单元格改用自身行范围注册到分桶索引,降低密集大表格滚动遍历开销。

修复

  • DOCX 正文可用宽度与间距对齐:正文可用宽度按 pgMar 边距精算,对齐双端页眉页脚与正文的内容边距。
  • XLSX 几何边界校验:严格校验 core 下发的 sheet.geometry 数组边界与长度,拦截异常损坏文件。
  • Android 视口滚动与无障碍体验:无障碍滚动步进驱动优化,修复极端缩放时视口滚动边界裁剪溢出。

完整变更见 CHANGELOG.md。

v0.8.0

Choose a tag to compare

@donglua donglua released this 26 Oct 05:22

主要变化

性能与渲染

  • 双端表格空间分桶索引:Android 与 HarmonyOS NEXT 双端为 SheetRenderer 引入行高分桶空间索引(Row Buckets),合并单元格按行范围分桶注册,帧绘制时仅遍历视口覆盖区间所命中的桶,并借助代数生成标记实现 $O(1)$ 无额外内存分配的跨桶去重,显著降低含数百上千合并单元格大表格的滚动开销。
  • 鸿蒙端硬件 VSync 滚动:Spreadsheet 滚动调度接入硬件 DisplaySync,解耦每帧重绘与高频手势事件,手势惯性滑行动画更加丝滑流畅。
  • 鸿蒙端零代理 AST 与组件复用:去代理化(Zero-Proxy)AST 数据结构,消除 ArkUI @State 深层代理遍历开销;拆分并重构 @Reusable DOCX 文本块与 PPTX 画布组件池,列表长滑动时内存与帧率大幅提升。
  • 鸿蒙端 Canvas 排版 WeakMap 缓存:引入针对段落排版计算结果的 WeakMap 缓存,避免相同文本与样式在滚动中重复测算折行。
  • 鸿蒙端图片并发调度与下采样:重构 ImageStore,实施并发信号量队列调度与带元数据的按需下采样解码,保证多图并发展开时的内存峰值平稳。

特性与接口

  • 精准文档缓存淘汰:跨平台 Rust 核心新增 evict_package_cache(path),鸿蒙端导出 NativeCore.evictCache(path) 与 OfficePreviewController.clearDocumentCache(path),支持在多文档切换时精准释放特定文档的 ZIP 句柄与内存索引。

修复

  • 突破鸿蒙 Node-API 2MB 传输硬限制:修复大于 2MB 的高清图片在 OpenHarmony Node-API 传递因 napi_create_buffer 限制导致报错返回 null 的问题,改用 napi_create_arraybuffer 直接分配。
  • 鸿蒙端图片异步竞态与复用修复:修复组件复用脏标记与异步图片回填竞态,避免快速滑动时图片偶现闪烁或错位。
  • ArkTS 严格模式与 Rust 规范:消除 RenderUtils.ets 中的严格模式类型警告,规范 Rust 单测与全局格式化。

完整变更见 CHANGELOG.md。