yx_only_office_flutter/CHANGELOG.md

CHANGELOG

[0.2.0] - 2024-12-03 (高级功能版本)

🚀 重大新增

• ✨ YxOnlyOfficeAdvancedViewer - 全新的高级查看器
  • WebViewController 直接访问
  • 编辑器方法直接调用（insertImage, downloadAs, setReviewerMode 等）
  • 图片插入功能（相机/相册）
  • 文件下载自动处理
  • 完整的生命周期事件（onAppReady, onDocumentReady）
  • 自定义 JavaScript 执行

新增功能

• ✨ EditorMethodResult 类 - 统一的方法调用结果
• ✨ 高级示例应用 (example/lib/main_advanced.dart)
• ✨ 完整的高级功能文档 (docs/ADVANCED_FEATURES.md)

依赖更新

• 示例应用新增: image_picker, path_provider, http

文档

• 📝 新增高级功能指南
• 📝 更新 README，添加高级功能说明
• 📝 完善 API 参考文档

[0.1.0] - 2024-12-03

新增功能

• ✨ 完整的文档查看与编辑支持（view 和 edit 模式）
• ✨ 新增 OnlyOfficeConfigFactory 工厂类，支持快速创建配置
• ✨ 新增 YxOnlyOfficeViewer.create 工厂构造函数
• ✨ 新增丰富的事件回调：
  • onRequestSaveAs: 用户请求另存为
  • onRequestInsertImage: 用户请求插入图片
  • onDocumentStateChange: 文档修改状态变化
  • onMetaChange: 文档元数据变化
  • onMakeActionLink: 创建操作链接
  • onEvent: 通用事件处理器
• ✨ 内置 JWT 签名工具 OnlyOfficeJwtSigner
• ✨ 支持自定义文档 key

改进

• 🔧 重构配置结构，完全遵循 ONLYOFFICE Docs API 官方规范
• 🔧 优化 HTML 桥接代码，支持更多事件
• 🔧 改进示例应用，展示编辑模式和事件处理
• 📝 完善 README 文档，添加详细的使用说明和 API 文档

废弃

• ⚠️ OnlyOfficeViewConfigFactory.fromUrl 已废弃，建议使用 OnlyOfficeConfigFactory.create
• ⚠️ YxOnlyOfficeViewer.view 已废弃，建议使用 YxOnlyOfficeViewer.create

兼容性

• ✅ 保持向后兼容，旧代码仍可正常工作
• ✅ Android 5.0+
• ✅ iOS 11.0+
• ✅ ONLYOFFICE Document Server 6.1+

[0.0.1] - 初始版本

• 基础文档查看功能
• WebView 集成
• 基本事件处理