This is the initial stable release of the Crashlog package with full cross-platform support and comprehensive feature set.

Added #

• Initial release of Crashlog package
• Error Capture: Automatic capture of uncaught Flutter and Dart errors
• Console Logging: Capture and store all console output including print(), debugPrint()
• Screenshot Capture: Optional screenshot capture when errors occur (cross-platform)
• Dev Report Screen: Comprehensive UI for viewing, managing, and sharing logs
• Cross-Platform Support: Works on Android, iOS, Windows, macOS, Linux, and Web
• Automatic Cleanup: Configurable retention policies for logs and screenshots
• Non-Blocking Operations: All operations are asynchronous and won't block the app
• Storage Service: Local file storage with JSON format for logs
• Multiple Button Types: Various UI components for accessing dev reports
  • ErrorRecorderButton: Floating action button
  • ErrorRecorderIconButton: App bar icon button
  • ErrorRecorderInlineButton: Inline button
  • ErrorRecorderOverlayButton: Draggable overlay button
• ErrorRecorderWrapper: Widget wrapper for screenshot capture functionality
• Device Information: Automatic collection of device and app information
• Sharing Capabilities: Share logs individually or combined via platform sharing
• Customizable Configuration: Extensive configuration options
• Example App: Comprehensive example demonstrating all features

Features #

• Error log capture with stack traces, timestamps, and device info
• Console log capture with different log levels (info, warning, error, debug, custom)
• Screenshot capture on error (when enabled)
• Local storage with configurable file names and directories
• Automatic cleanup based on maximum log count and retention days
• Dev Report screen with tabbed interface for error logs and console logs
• Expandable error details with stack trace viewing
• Screenshot viewing in full-screen dialog
• Log sharing functionality (text format)
• Clear logs functionality with confirmation dialogs
• Cross-platform compatibility with graceful degradation
• Non-blocking asynchronous operations
• Memory and storage efficient with automatic cleanup

Configuration Options #

• enabled: Enable/disable package functionality
• enableScreenshots: Capture screenshots on errors
• autoOpenOnError: Automatically open dev report when errors occur
• maxLogs: Maximum number of error logs to retain (default: 50)
• maxConsoleLogs: Maximum number of console logs to retain (default: 1000)
• logRetentionDays: Delete logs older than specified days
• showDeviceInfo: Include device information in error logs
• logFileName: Custom error log file name
• consoleLogFileName: Custom console log file name
• screenshotFolder: Custom screenshot folder name

Platform Support #

• ✅ Android: Full feature support
• ✅ iOS: Full feature support
• ✅ Windows: Full feature support
• ✅ macOS: Full feature support
• ✅ Linux: Full feature support
• ✅ Web: Partial support (no screenshots due to browser limitations)

Technical Details #

• Built with Flutter SDK >=3.0.0
• Dart SDK >=3.0.0 <4.0.0
• Dependencies:
  • path_provider: Local file storage
  • device_info_plus: Device information collection
  • package_info_plus: App information collection
  • screenshot: Screenshot capture functionality
  • share_plus: Platform sharing capabilities
  • json_annotation: JSON serialization

Documentation #

• Comprehensive README with usage examples
• Inline code documentation
• Example app with various use cases
• Platform-specific implementation notes

Known Limitations #

• Web platform doesn't support screenshot capture due to browser security limitations
• Global print() function override has limitations in Dart
• Screenshot capture requires widget wrapping for optimal functionality

Future Roadmap #

• Remote log uploading capabilities
• Advanced filtering and search in dev report
• Log export in multiple formats (JSON, CSV, etc.)
• Integration with popular logging frameworks
• Performance metrics collection
• Crash analytics and reporting
• Custom log formatting options
• Plugin architecture for extensibility