Skip to content

v0.10.0

Choose a tag to compare

@donglua donglua released this 08 Nov 08:01
· 144 commits to main since this release

发布页面: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,支持与外部扩展组件解耦联动。