wangyang

4.4 KiB

Raw Permalink Blame History

快速测试指南

🚀 快速开始（5分钟）

步骤 1: 运行测试

flutter test

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

步骤 2: 运行示例应用

cd example
flutter run -t lib/simple_example.dart

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

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

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)

✅ 验证清单

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

📚 更多文档

详细测试报告 - 完整测试结果和分析
测试总结 - 任务完成情况总结
示例指南 - 示例应用使用说明

🔍 测试覆盖

功能模块	测试用例数	通过率
文档类型识别	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 支持

💻 测试命令参考

# 运行所有测试
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

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

Windows

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

🐛 常见问题快速解决

问题1: 测试失败

# 清理并重新获取依赖
flutter clean
flutter pub get
flutter test

问题2: 示例应用无法运行

# 检查设备连接
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!

🎉 成功标志

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

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

📞 需要帮助？

参考以下文档获取更多信息：

TEST_REPORT.md - 详细测试报告
TESTING_SUMMARY.md - 完成情况总结
example/EXAMPLE_GUIDE.md - 示例详细说明

最后更新: 2025年12月4日

4.4 KiB Raw Permalink Blame History Unescape Escape