# 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 集成
- 基本事件处理