How getditto/dittoandroidtools works
DittoAndroidTools is an Android diagnostic-tools library for applications embedding the Ditto Kotlin SDK. Its principal workflow is to provide an initialized Ditto instance to the Tools Viewer, whose menu/navigation opens peer and presence diagnostics, data browsing, logs, disk usage, health, and heartbeat features. Individual screens then inspect local Ditto state or device status and present results; optional export paths package or upload diagnostic data. The graph emphasizes documented capabilities and sampled caller relationships; several feature internals are unsampled, so those links are documented or omitted rather than inferred.
Main entry points: DittoToolsViewer.kt Tools Viewer · LogViewerScreen.kt Log viewer · PresenceDegradationReporterViewModel.kt Presence state logic · PeersRepository.kt Peer state repository
Components 28
Viewer and navigation
- Tools Viewer
DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/DittoToolsViewer.kt - Tools menu
DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/ToolsMenu.kt - Screen routes
DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/navigation/Screens.kt - Menu model
DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/viewmodel/ToolsViewerViewModel.kt
Peer diagnostics
- Connected peers
DittoToolsAndroid/src/main/java/com/ditto/tools/peerslist/PeersListViewer.kt - Presence mesh viewer
DittoToolsAndroid/src/main/java/com/ditto/tools/presenceviewer/DittoPresenceViewer.kt - Presence degradation
DittoToolsAndroid/src/main/java/com/ditto/tools/presencedegradationreporter/PresenceDegradationReporterScreen.kt - Presence state logic
DittoToolsAndroid/src/main/java/com/ditto/tools/presencedegradationreporter/PresenceDegradationReporterViewModel.kt - Peer state repository
DittoToolsAndroid/src/main/java/com/ditto/tools/presencedegradationreporter/repositories/PeersRepository.kt - Peer models
DittoToolsAndroid/src/main/java/com/ditto/tools/presencedegradationreporter/model/Peer.kt - Peer dashboard
DittoToolsAndroid/src/main/java/com/ditto/tools/presencedegradationreporter/components/Dashboard.kt
Data and storage
- Data browser
DittoToolsAndroid/src/main/java/com/ditto/tools/databrowser/DataBrowser.kt - Disk usage and export
DittoToolsAndroid/src/main/java/com/ditto/tools/diskusage/DittoDiskUsage.kt - Disk metrics
DittoToolsAndroid/src/main/java/com/ditto/tools/diskusage/usecase/GetDiskUsageMetrics.kt - Data archive exporter
DittoToolsAndroid/src/main/java/com/ditto/tools/exporter/ZipFolderUseCase.kt
Health and heartbeat
- Health screen
DittoToolsAndroid/src/main/java/com/ditto/tools/health/ui/composables/HealthScreen.kt - Health metrics
DittoToolsAndroid/src/main/java/com/ditto/tools/healthmetrics/HealthMetric.kt - Metric providers
DittoToolsAndroid/src/main/java/com/ditto/tools/healthmetrics/HealthMetricProvider.kt - Heartbeat monitor
DittoToolsAndroid/src/main/java/com/ditto/tools/heartbeat/Heartbeat.kt - Heartbeat screen
DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/HeartbeatScreen.kt
Log export
- Log controls
DittoToolsAndroid/src/main/java/com/ditto/tools/logviewer/LogDetailsScreen.kt - Log viewer
DittoToolsAndroid/src/main/java/com/ditto/tools/logviewer/LogViewerScreen.kt - Log utilities
DittoToolsAndroid/src/main/java/com/ditto/tools/utils/LogUtils.kt - Log file export
DittoToolsAndroid/src/main/java/com/ditto/tools/exportlogs/ExportLogs.kt - Portal log upload
DittoToolsAndroid/src/main/java/com/ditto/tools/exportlogs/ExportLogsToPortal.kt
Other components
- Embedding app
- Ditto SDK instance
- Ditto Portal
Connections 31
- Embedding app → Tools Viewer: embeds
README.md - Embedding app → Ditto SDK instance: provides
README.md - Tools Viewer → Ditto SDK instance: accepts
DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/DittoToolsViewer.kt - Tools Viewer → Tools menu: shows
DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/DittoToolsViewer.kt - Tools Viewer → Screen routes: navigates
DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/DittoToolsViewer.kt - Tools Viewer → Menu model: uses menu model
DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/DittoToolsViewer.kt - Tools Viewer → Connected peers: routes to
DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/DittoToolsViewer.kt - Tools Viewer → Presence mesh viewer: routes to
DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/DittoToolsViewer.kt - Tools Viewer → Presence degradation: routes to
DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/DittoToolsViewer.kt - Tools Viewer → Data browser: routes to
DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/DittoToolsViewer.kt - Tools Viewer → Disk usage and export: routes to
DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/DittoToolsViewer.kt - Tools Viewer → Health screen: routes to
DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/DittoToolsViewer.kt - Tools Viewer → Heartbeat screen: routes to
DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/DittoToolsViewer.kt - Tools Viewer → Log controls: routes to
DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/DittoToolsViewer.kt - Tools Viewer → Log viewer: routes to
DittoToolsAndroid/src/main/java/com/ditto/tools/toolsviewer/DittoToolsViewer.kt - Presence degradation → Presence state logic: collects state
DittoToolsAndroid/src/main/java/com/ditto/tools/presencedegradationreporter/PresenceDegradationReporterScreen.kt - Presence state logic → Peer state repository: observes and updates
DittoToolsAndroid/src/main/java/com/ditto/tools/presencedegradationreporter/PresenceDegradationReporterViewModel.kt - Peer state repository → Ditto SDK instance: queries and writes
DittoToolsAndroid/src/main/java/com/ditto/tools/presencedegradationreporter/repositories/PeersRepository.kt - Peer state repository → Peer models: converts records
DittoToolsAndroid/src/main/java/com/ditto/tools/presencedegradationreporter/repositories/PeersRepository.kt - Presence state logic → Peer dashboard: renders state
DittoToolsAndroid/src/main/java/com/ditto/tools/presencedegradationreporter/PresenceDegradationReporterScreen.kt - Disk usage and export → Disk metrics: measures usage
- Disk usage and export → Data archive exporter: exports directory
- Disk metrics → Health metrics: produces metrics
DittoToolsAndroid/src/main/java/com/ditto/tools/diskusage/usecase/GetDiskUsageMetrics.kt - Health screen → Health metrics: reports status
- Heartbeat screen → Heartbeat monitor: presents monitor
- Heartbeat monitor → Metric providers: collects metrics
DittoToolsAndroid/src/main/java/com/ditto/tools/heartbeat/Heartbeat.kt - Metric providers → Health metrics: provides values
DittoToolsAndroid/src/main/java/com/ditto/tools/healthmetrics/HealthMetricProvider.kt - Log controls → Log viewer: opens
DittoToolsAndroid/src/main/java/com/ditto/tools/logviewer/LogDetailsScreen.kt - Log viewer → Log utilities: uses
DittoToolsAndroid/src/main/java/com/ditto/tools/logviewer/LogViewerScreen.kt - Log viewer → Ditto SDK instance: reads logs
- Portal log upload → Ditto Portal: uploads logs