How rajatdas-dev/device_diagnostics works
device_diagnostics is an opt-in Flutter package for collecting device and app diagnostics, monitoring runtime activity, and exporting session reports. The documented workflow is to initialize with visibility and sampling configuration, wrap the app with its diagnostic UI, optionally track routes and instrument HTTP requests, then start and stop a session to produce a PDF. The README supports these user-facing relationships; Dart implementation excerpts were not provided, so internal wiring—especially how Flutter requests native metrics—is not verified here.
Main entry points: diagnostic_controller.dart Session Controller · diagnostic_observability.dart App Observability · diagnostic_sample.dart Diagnostic Samples · diagnostic_route_observer.dart Route Observer
Components 12
Configuration and Sampling
- Diagnostic Config
lib/src/config/diagnostic_config.dart - Diagnostic Samples
lib/src/models/diagnostic_sample.dart
Runtime Monitoring
- App Observability
lib/src/overlay/diagnostic_observability.dart - Diagnostic Overlay
lib/src/overlay/diagnostic_overlay.dart - Route Observer
lib/src/navigation/diagnostic_route_observer.dart - Diagnostic HTTP Client
lib/src/network/diagnostic_http_client.dart
Sessions and Reporting
- Session Controller
lib/src/core/diagnostic_controller.dart - PDF Report Generator
lib/src/reporting/diagnostic_pdf_report.dart
Native Platforms
- Android Metrics Plugin
android/src/main/kotlin/dev/diagnostics/device_diagnostics/DeviceDiagnosticsPlugin.kt - iOS Metrics Plugin
ios/Classes/DeviceDiagnosticsPlugin.swift
Other components
- Flutter Developer
- Flutter App
Connections 13
- Flutter Developer → Diagnostic Config: configures
README.md - Flutter Developer → Session Controller: starts session
README.md - Flutter App → App Observability: wraps with
README.md - Flutter App → Route Observer: registers observer
README.md - Flutter Developer → Diagnostic HTTP Client: uses client
README.md - Session Controller → PDF Report Generator: exports report
README.md - Session Controller → Diagnostic Samples: collects samples
- App Observability → Diagnostic Config: uses visibility
README.md - App Observability → Diagnostic Overlay: shows diagnostics
- Route Observer → Session Controller: associates activity
README.md - Diagnostic HTTP Client → Session Controller: records metrics
README.md - Android Metrics Plugin → Diagnostic Samples: provides metrics
- iOS Metrics Plugin → Diagnostic Samples: provides metrics