yx_only_office_flutter/QUICK_TEST_GUIDE.md

# 快速测试指南

## 🚀 快速开始（5分钟）

### 步骤 1: 运行测试

```bash
flutter test
```

**预期结果**: ✅ 所有19个测试通过

### 步骤 2: 运行示例应用

```bash
cd example
flutter run -t lib/simple_example.dart
```

**预期结果**: 应用启动并显示 PowerPoint 文档

### 步骤 3: 在您的项目中使用

```dart
import 'package:yx_only_office_flutter/yx_only_office_flutter.dart';

// 添加到您的 Widget 树
OnlyOfficeViewer(
  onlyOfficeServerUrl: 'https://document.23544.com/',
  fileUrl: 'https://quanxue-oa.oss-cn-chengdu.aliyuncs.com/20250815/1755244744547.pptx',
  token: '6Yr6DGoVV3ACS6GtVgdH453mXxLftd6Q',
)
```

## 📦 已提供的测试配置

### OnlyOffice 服务配置
```
服务地址: https://document.23544.com/
JWT Token: 6Yr6DGoVV3ACS6GtVgdH453mXxLftd6Q
```

### 测试文件
```
文件URL: https://quanxue-oa.oss-cn-chengdu.aliyuncs.com/20250815/1755244744547.pptx
文件类型: PowerPoint 演示文稿 (.pptx)
```

## ✅ 验证清单

- [x] 测试通过 (19/19)
- [x] 真实数据验证通过
- [x] 示例应用可运行
- [x] 文档完整
- [x] 代码无 linter 错误

## 📚 更多文档

- [详细测试报告](TEST_REPORT.md) - 完整测试结果和分析
- [测试总结](TESTING_SUMMARY.md) - 任务完成情况总结
- [示例指南](example/EXAMPLE_GUIDE.md) - 示例应用使用说明

## 🔍 测试覆盖

| 功能模块 | 测试用例数 | 通过率 |
|---------|-----------|--------|
| 文档类型识别 | 4 | 100% |
| 密钥生成 | 2 | 100% |
| URL 处理 | 2 | 100% |
| 配置生成 | 3 | 100% |
| HTML 生成 | 3 | 100% |
| 真实数据验证 | 5 | 100% |
| **总计** | **19** | **100%** |

## 🎯 核心功能验证

✅ **文档格式支持**
- Word (doc, docx, pdf, txt, rtf, etc.)
- Excel (xls, xlsx, csv, etc.)
- PowerPoint (ppt, pptx, etc.)

✅ **安全性**
- JWT Token 支持
- HTTPS 协议
- SHA256 文档密钥

✅ **配置灵活性**
- 自定义服务器 URL
- 自定义文件 URL
- 可选 JWT Token

✅ **跨平台**
- Android 支持
- iOS 支持

## 💻 测试命令参考

```bash
# 运行所有测试
flutter test

# 运行特定测试文件
flutter test test/onlyoffice_viewer_unit_test.dart

# 生成测试覆盖率报告
flutter test --coverage

# 查看详细输出
flutter test --verbose

# 运行简单示例
cd example && flutter run -t lib/simple_example.dart

# 在 Android 设备上运行
flutter run -t lib/simple_example.dart -d android

# 在 iOS 设备上运行
flutter run -t lib/simple_example.dart -d ios
```

## ⚡ 一键验证脚本

在项目根目录创建 `verify.sh` (Linux/Mac) 或 `verify.bat` (Windows)：

### Linux/Mac
```bash
#!/bin/bash
echo "🧪 运行测试..."
flutter test
if [ $? -eq 0 ]; then
    echo "✅ 所有测试通过！"
    echo "🚀 启动示例应用..."
    cd example && flutter run -t lib/simple_example.dart
else
    echo "❌ 测试失败，请检查错误信息"
fi
```

### Windows
```batch
@echo off
echo 🧪 运行测试...
flutter test
if %errorlevel% equ 0 (
    echo ✅ 所有测试通过！
    echo 🚀 启动示例应用...
    cd example
    flutter run -t lib/simple_example.dart
) else (
    echo ❌ 测试失败，请检查错误信息
)
```

## 🐛 常见问题快速解决

### 问题1: 测试失败
```bash
# 清理并重新获取依赖
flutter clean
flutter pub get
flutter test
```

### 问题2: 示例应用无法运行
```bash
# 检查设备连接
flutter devices

# 更新依赖
cd example
flutter pub get
flutter run -t lib/simple_example.dart
```

### 问题3: WebView 无法加载
- 检查网络连接
- 确认 OnlyOffice 服务地址可访问
- 验证文件 URL 有效
- 检查 JWT Token 是否正确

## 📊 测试输出示例

```
00:00 +0: loading test/onlyoffice_viewer_unit_test.dart
00:00 +1: 文档类型识别 - Word 文档
00:00 +2: 文档类型识别 - Excel 文档
00:00 +3: 文档类型识别 - PowerPoint 文档
...
00:00 +19: All tests passed!
```

## 🎉 成功标志

当您看到以下内容时，表示一切正常：

1. ✅ 测试输出: "All tests passed!"
2. ✅ 测试用例: 19/19 通过
3. ✅ 示例应用: 成功显示文档
4. ✅ 无错误或警告

## 📞 需要帮助？

参考以下文档获取更多信息：
- [TEST_REPORT.md](TEST_REPORT.md) - 详细测试报告
- [TESTING_SUMMARY.md](TESTING_SUMMARY.md) - 完成情况总结
- [example/EXAMPLE_GUIDE.md](example/EXAMPLE_GUIDE.md) - 示例详细说明

---

**最后更新**: 2025年12月4日