更新记录

1.0.0（2026-08-25）

首次发布 Hans Office 核心运行时。
支持 Android 和 iOS：HBuilderX 5.15+、Android API 24+、iOS 13+。
提供 DOCX、PPTX、XLSX 插件共用的 Android AAR 和 iOS XCFramework。
支持通过自定义基座或正式构建包运行。

平台兼容性

uni-app(5.24)

Vue2	Vue3	Chrome	Safari	app-vue	app-nvue	Android	iOS	鸿蒙
√	√	-	-	-	-	√	√	-

微信小程序	支付宝小程序	抖音小程序	百度小程序	快手小程序	京东小程序	鸿蒙元服务	QQ小程序	飞书小程序	小红书小程序	快应用-华为	快应用-联盟
-	-	-	-	-	-	-	-	-	-	-	-

uni-app x(5.24)

Chrome	Safari	Android	iOS	鸿蒙	微信小程序
-	-	√	√	-	-

Office 核心运行时

hans-office-core 是 hans-office-doc、hans-office-ppt 和 hans-office-sheet 的共享依赖，负责提供 Android 和 iOS 的公共原生运行时。它不提供独立的文档解析 API、预览页面或 UI 组件。

使用方式

通常只需要安装对应的格式插件，插件会声明并安装 hans-office-core：

hans-office-doc
hans-office-ppt
hans-office-sheet

本地开发时，请确保依赖插件都位于项目的 uni_modules 目录，并保持相同版本。业务代码应从格式插件导入 parseDocx、parsePpt 或 parseXlsx，不要直接导入 hans-office-core 的内部文件或原生桥接接口。

运行要求

HBuilderX 5.15 或更高版本。
Android App：API 24 或更高版本。
iOS App：iOS 13.0 或更高版本。
支持 uni-app 和 uni-app x 的 Android、iOS App。
Harmony、Web 和小程序暂不支持。

标准基座可以编译插件，但运行时无法加载原生依赖。请使用 Android 自定义基座和 iOS 自定义基座，或使用包含原生产物的正式构建包。 Android 和 iOS 格式插件直接使用该共享原生运行时。内置的 XCFramework 已启用 iOS 插件包支持（u）。

hans-office-core 统一维护 Android AAR 和 iOS XCFramework。请勿将这些原生文件复制到格式插件，也不要从发布包中删除。

输出与隐私

格式插件返回包含内嵌资源的 HTML 内容，由业务侧负责使用 WebView 或 web-view 展示。hans-office-core 不提供展示 UI，也不会上传文档内容；插件不声明广告、数据采集或敏感运行时权限。文件选择和访问权限由宿主应用负责。

常见问题

标准基座找不到原生类或框架：请改用自定义基座或正式构建包。
hans-office-core 与格式插件版本不一致：请同步更新所有 Office 插件。
文件无法解析：确认传入路径对应用进程可读，优先使用应用沙盒内的绝对路径。