network_diagnostic_kit 1.0.4

A Flutter plugin for network diagnostics including speed test, DNS test, ping, and quality evaluation.

Changelog | 更新日志

Table of Contents | 目录

• English
• 中文

---

English

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

1.0.4 - 2026-03-16

Fixed

• 🔧 Fixed .pubignore configuration to correctly include lib/src/benchmark files
• 📦 Changed benchmark/ pattern to /benchmark/ to only exclude root-level benchmark folder
• ✅ Verified lib/src/benchmark source files are included in published package
• 📊 Package size: 93 KB (includes all benchmark source files)

Documentation

• 📖 Updated .pubignore with correct path patterns
• 🔍 Verified all source files are properly included in pub.dev package

1.0.3 - 2026-03-16

Fixed

• 🔧 Fixed pub.dev publishing configuration
• 📦 Updated .pubignore to include lib/src/benchmark source files
• 📚 Included example application in published package
• 🐛 Fixed connectivity_plus v7.0.0+ compatibility issue
• ✅ Verified with pub.dev dry-run (0 warnings)

Documentation

• 📖 Updated README with latest features
• 📝 Updated CHANGELOG with v1.0.3 release notes
• 🔍 Verified all Dartdoc comments are complete
• ✨ Ensured example application is properly documented

1.0.2 - 2026-03-16

Added

• 📚 Complete Dartdoc annotation documentation
• 📖 Library-level documentation notes
• 📝 Detailed class-level documentation
• 🔍 Full method-level documentation
• 💡 Property-level documentation notes
• 📋 Usage examples and code snippets

Documentation

• Added Dartdoc annotations for all public APIs
• Added detailed documentation for all data models
• Added descriptions for all enumeration types
• Added documentation for exception classes
• Added documentation for benchmarking classes
• Included usage examples and best practices

1.0.1 - 2026-03-08

Added

• ⚡ Performance benchmark testing system
• 📊 BenchmarkRunner - Universal benchmark test runner
• 🧪 NetworkBenchmark - Network diagnostic specific benchmark tests
• 📈 BenchmarkResult - Benchmark test result model
• 📋 BenchmarkSuiteResult - Benchmark test suite result model

Features

• Support for custom iteration counts and warm-up phases
• Detailed statistical information (mean, min, max, standard deviation)
• Operations per second (ops/sec) calculation
• Batch test suite execution support
• Independent benchmark test scripts
• In-app benchmark testing examples for Flutter

Documentation

• Benchmark testing usage guide
• Performance testing best practices
• Benchmark output examples

1.0.0 - 2026-03-08

Added

• 🌐 Network connectivity detection
• 🚀 Speed testing (download/upload/latency/jitter/packet loss)
• 📡 Ping testing
• 🔍 DNS testing
• 📊 Network quality scoring
• 🔌 Port scanning
• 🔄 Real-time network status monitoring
• 📱 Support for Android, iOS, Windows, Linux, macOS platforms
• 📖 Complete API documentation and example application

Features

• NetworkConnectionInfo - Network connection information model
• SpeedTestResult - Speed test result model
• PingResult - Ping test result model
• DnsTestResult - DNS test result model
• NetworkQualityScore - Network quality score model
• NetworkType - Network type enumeration
• QualityLevel - Quality level enumeration

Documentation

• Complete API reference
• Usage examples
• Troubleshooting guide

[Unreleased]

Planned

• Route tracing functionality
• More detailed speed testing (multiple servers)
• Network history recording
• Test report export
• Additional platform optimizations

---

中文

本项目的所有重要更改都将记录在此文件中。

格式基于 Keep a Changelog， 本项目遵循 语义化版本。

[1.0.4] - 2026-03-16

修复

• 🔧 修复 .pubignore 配置以正确包含 lib/src/benchmark 文件
• 📦 将 benchmark/ 模式改为 /benchmark/ 仅排除根目录 benchmark 文件夹
• ✅ 验证 lib/src/benchmark 源文件已包含在发布包中
• 📊 包大小：93 KB（包含所有 benchmark 源文件）

文档

• 📖 更新 .pubignore 使用正确的路径模式
• 🔍 验证所有源文件已正确包含在 pub.dev 包中

[1.0.3] - 2026-03-16

修复

• 🔧 修复 pub.dev 发布配置
• 📦 更新 .pubignore 以包含 lib/src/benchmark 源文件
• 📚 在发布包中包含示例应用
• 🐛 修复 connectivity_plus v7.0.0+ 兼容性问题
• ✅ 通过 pub.dev 干运行验证（0 个警告）

文档

• 📖 更新 README 包含最新功能
• 📝 更新 CHANGELOG 记录 v1.0.3 发布说明
• 🔍 验证所有 Dartdoc 注释完整
• ✨ 确保示例应用文档完整

[1.0.2] - 2026-03-16

新增

• 📚 完整的 Dartdoc 文档注释
• 📖 库级别文档说明
• 📝 类级别详细文档
• 🔍 方法级别完整文档
• 💡 属性级别文档说明
• 📋 使用示例和代码片段

文档

• 为所有公共 API 添加 Dartdoc 注释
• 为所有数据模型添加详细文档
• 为所有枚举类型添加说明
• 为异常类添加文档
• 为基准测试类添加文档
• 添加使用示例和最佳实践

[1.0.1] - 2026-03-08

新增

• ⚡ 性能基准测试系统
• 📊 BenchmarkRunner - 通用基准测试运行器
• 🧪 NetworkBenchmark - 网络诊断专用基准测试
• 📈 BenchmarkResult - 基准测试结果模型
• 📋 BenchmarkSuiteResult - 基准测试套件结果模型

功能

• 支持自定义迭代次数和预热阶段
• 提供详细的统计信息（平均值、最小值、最大值、标准差）
• 计算每秒操作数（ops/sec）
• 支持测试套件批量运行
• 独立的基准测试脚本
• Flutter应用内基准测试示例

文档

• 基准测试使用指南
• 性能测试最佳实践
• 基准测试输出示例

[1.0.0] - 2026-03-08

新增

• 🌐 网络连接检测功能
• 🚀 网速测试功能（下载/上传/延迟/抖动/丢包）
• 📡 Ping测试功能
• 🔍 DNS测试功能
• 📊 网络质量评分功能
• 🔌 端口扫描功能
• 🔄 实时网络状态监听
• 📱 支持 Android、iOS、Windows、Linux、macOS平台
• 📖 完整的API文档和示例应用

功能

• NetworkConnectionInfo - 网络连接信息模型
• SpeedTestResult - 网速测试结果模型
• PingResult - Ping测试结果模型
• DnsTestResult - DNS测试结果模型
• NetworkQualityScore - 网络质量评分模型
• NetworkType - 网络类型枚举
• QualityLevel - 质量等级枚举

文档

• 完整的API参考
• 使用示例
• 故障排查指南

[未发布]

计划中

• 路由追踪功能
• 更详细的网速测试（多服务器）
• 网络历史记录
• 导出测试报告
• 更多平台优化