Added #

• Comprehensive deployment testing suite with multiple test scenarios for package distribution and library loading.
• Final deployment verification tool (test_final_deployment.dart) that validates package readiness for pub.flutter-io.cn.
• Package installation simulation testing to ensure library loading works correctly in installed packages.
• Library search path testing with priority-based path resolution verification.
• Package configuration validation including package_config.json parsing and path resolution.
• Flutter asset configuration testing to ensure compatibility with Flutter projects.

Improved #

• Enhanced package configuration in pubspec.yaml with explicit files: section for native library inclusion.
• Robust library loading with multiple fallback paths for different deployment scenarios.
• Package deployment readiness verification with automated testing for pub.flutter-io.cn distribution.
• Cross-platform deployment testing ensuring proper library bundling and discovery.

Fixed #

• Native library path resolution improved for various deployment contexts (development, pub install, Flutter projects).
• Package structure validation to ensure all required files are properly included in published packages.

Documentation #

• Deployment testing documentation with comprehensive test suite descriptions.
• Package configuration guide for proper native library inclusion and distribution.

Added #

• CLI --json mode now outputs a single valid JSON object, with a streaming processing array and a final result summary, suitable for direct pipeline and machine parsing.
• All device and error events are streamed as array elements, enabling real-time consumption by downstream tools.

Changed #

• Native and Dart layers are now fully silent in --json mode, including library path detection messages and native logs.
• CLI, API, and all examples updated to reflect the new JSON streaming output format.
• Improved error handling in JSON mode: errors are included as objects in the processing array.

Fixed #

• Removed unnecessary imports and resolved analyzer warnings.
• Fixed typo and stability issues in native code and Dart FFI integration.

Documentation #

• Updated README and example documentation to describe the new JSON output format and silent mode behavior.

Changed #

• Removed all deprecated periodic scan APIs: startPeriodicScanJson and startPeriodicScan are no longer available. All code must use the new startPeriodicScanJsonWithDone and startPeriodicScanWithDone APIs.
• Updated all examples, CLI tools, and tests to use only the new periodic scan APIs with async/await and onDone callback support.
• Modernized all documentation and code samples in README and example files to reflect the new API usage exclusively.
• Improved API consistency and usability by eliminating legacy methods and ensuring all public interfaces are up-to-date.
• Synchronized all documentation, code comments, and usage instructions to match the latest API and best practices.

Added #

• Added NativeMdnsScanner type alias for MdnsFfi, making the main class name consistent with the package name for easier and more intuitive usage.
• All examples, CLI tools, and tests now use NativeMdnsScanner instead of MdnsFfi in documentation and code samples.
• Added test coverage to ensure NativeMdnsScanner can be constructed and used identically to MdnsFfi.

Changed #

• Updated all example and CLI code to use NativeMdnsScanner for improved clarity and consistency.
• Documentation and usage instructions now recommend NativeMdnsScanner as the primary class name.

Changed #

• Native callback now uses JSON string: All device and error information is returned as a single JSON string from native code, enabling richer and more extensible data exchange.
• Debug mode with multiple levels: Both native and Dart layers now support debug levels (0=quiet, 1=error/result, 2=normal, 3=verbose). CLI and examples allow fine-grained debug control via --debug[=<level>].
• Dart FFI bindings updated: All FFI bindings and callback signatures updated to support JSON callback, with correct type safety and error handling.
• CLI tool (mdns_cli.dart): All scan commands now use the new JSON callback interface. Debug option is fully documented and supports levels. Usage/help is now fully in English.
• Examples and tests updated: All example and test files now use the JSON callback interface and support debug level control. All comments and output are in English.
• Error reporting improved: Native and Dart errors are now reported in a unified JSON format, and CLI displays them clearly.
• Resource management: Improved cleanup and disposal logic in FFI and CLI.

Fixed #

• Fixed type errors in FFI and CLI caused by debug parameter type changes (now always int).
• Fixed class/method structure issues in FFI binding layer.
• Fixed example/test code to match new API and debug conventions.

Added #

• Support for debug level 0 (quiet mode): only final device results are shown by default.
• CLI and API now allow setting debug level from 0 to 3 for granular control.
• All output, comments, and documentation are now in English for international use.

Fixed #

• Fixed example file name to native_mdns_scanner_example.dart

Fixed #

• Fixed example file name to *_example.dart

Added #

• Initial release of native_mdns_scanner for macOS
• Native mDNS/Bonjour service discovery using macOS system APIs via FFI
• Simultaneous multi-service scanning - scan multiple service types at once
• Periodic scanning support with configurable query intervals and duration
• Rich device information including IP, port, service type, TXT records, and discovery metadata
• Timing analysis tools for analyzing discovery patterns and performance
• Command-line interface (mdns_cli) for testing and debugging
• Comprehensive API with the following classes:
  • MdnsFfi - Main scanning functionality
  • DeviceInfo - Device/service information model
  • TimingAnalyzer - Discovery timing analysis utilities
• Multiple scanning modes:
  • Simple single-service scanning
  • Multi-service simultaneous scanning
  • Periodic scanning with custom intervals
• Flexible library loading with automatic path detection
• Full test coverage with unit and integration tests
• Example applications demonstrating various use cases

Features #

• 🔍 High-performance native implementation using Objective-C and macOS Bonjour APIs
• 🎯 Simultaneous scanning - unlike sequential-only libraries
• ⏱️ Smart timing analysis to verify simultaneous discovery
• 🖥️ CLI tool with multiple commands and options
• 📊 Detailed discovery metrics and statistics
• 🧹 Proper resource management with automatic cleanup

Platform Support #

• ✅ macOS (arm64 + x86_64 universal binary)
• ❌ iOS (not supported in this release)
• ❌ Windows/Linux (not supported)

Dependencies #

• Dart SDK: >=3.0.0 <4.0.0
• ffi: ^2.1.4

Documentation #

• Complete README with usage examples
• API documentation for all public classes
• CLI usage guide with examples
• Build instructions for the native library