Separate Dart work from platform behavior
Flutter can spend time in Dart computation, platform-channel calls, native networking or rendering. The Flutter Firebase Performance guide describes supported instrumentation; it does not make every Dart or native operation automatically visible.
Choose one task such as loading and displaying an album page, then define its measured boundary.
Stop the trace reliably
Use a try/finally style lifecycle so a thrown exception does not leave a custom trace unfinished. The exact API calls should follow the installed FlutterFire package documentation.
Do not record the document contents, account email or a unique file name as a metric label. A small controlled outcome category is more useful for aggregation and safer for privacy.
Make the metric answer a question
| Trace design | What it can answer |
|---|---|
| Network fetch only | How long the request took |
| Fetch plus decoding | How long data preparation took |
| User action to usable result | How long the complete experience took |
| Repeated per-widget trace | Often too fragmented to explain the experience |
These measurements are not interchangeable. Document the chosen boundary so a later refactor does not silently change the metric's meaning.
Validate outside a debug-only workflow
Use representative profile or release testing for performance interpretation. Development tooling and debug behavior can distort timing. Confirm production patterns with Flutter's own profiling tools when you need frame or allocation detail.
Check the destination and collection controls
Verify the trace in the correct Firebase app and make sure consent or collection settings behave as intended. A trace visible on one test device is not a guarantee of complete production coverage.
APKLint's Flutter APK Analyzer can help inspect package characteristics and the Performance Checker can organize a review. Neither measures Dart execution or reads Firebase traces, so attach actual trace and profiler evidence to the optimization decision.
Sources and further reading
Reference review: 22 September 2026. Examples illustrate the workflow; check your installed versions, release artifact and account-specific Console requirements before applying them. This guide is not a claim that APKLint executed your project or verified your private account.
Android inspection tools and practical release guides. About APKLint · Report a correction
