This page collects some frequently asked questions about evaluating and debugging Flutter's performance.

• Which performance dashboards have metrics that are related to Flutter?
  • Flutter dashboard on appspot
  • Flutter Skia dashboard
  • Flutter Engine Skia dashboard

• How do I add a benchmark to Flutter?
  • How to write a render speed test for Flutter
  • How to write a memory test for Flutter

• What are some tools for capturing and analyzing performance metrics?
  • Dart/Flutter DevTools
  • Apple instruments
  • Linux perf
  • Chrome tracing (enterabout:tracing in your Chrome URL field)
  • Android systrace (adb systrace)
  • Fuchsiafx traceutil
  • Perfetto
  • speedscope

• My Flutter app looks janky or stutters. How do I fix it?
  • Improving rendering performance

• What are some costly performance operations that I need to be careful with?
  • Opacity,Clip.antiAliasWithSaveLayer, or anything that triggerssaveLayer
  • ImageFilter
  • Also seePerformance best practices

• How do I tell which widgets in my Flutter app are rebuilt in each frame?
  • SetdebugProfileBuildsEnabled true inwidgets/debug.dart.
  • Alternatively, change theperformRebuild function inwidgets/framework.dart to ignoredebugProfileBuildsEnabled and always callTimeline.startSync(...)/finish.
  • If you use IntelliJ, a GUI view of this data is available. SelectTrack widget rebuilds, and your IDE displays which the widgets rebuild.

• How do I query the target frames per second (of the display)?
  • Get the display refresh rate

• How to solve my app's poor animations caused by an expensive Dart async function call that is blocking the UI thread?
  • Spawn another isolate using thecompute() method, as demonstrated inParse JSON in the background cookbook.

• How do I determine my Flutter app's package size that a user will download?
  • SeeMeasuring your app's size

• How do I see the breakdown of the Flutter engine size?
  • Visit thebinary size dashboard, and replace the git hash in the URL with a recent commit hash fromFlutter's GitHub commits.

• How can I take a screenshot of an app that is running and export it as a SKP file?
  • Runflutter screenshot --type=skia --observatory-uri=...
  • Note a known issue viewing screenshots:
    • Issue 21237: Doesn't record images in real devices.
  • To analyze and visualize the SKP file, check out theSkia WASM debugger.

• How do I retrieve the shader persistent cache from a device?

  • On Android, you can do the following:

    adb shellrun-as <com.your_app_package_name>cp <your_folder> <some_public_folder, e.g., /sdcard> -radb pull <some_public_folder/your_folder>

    content_copy

• How do I perform a trace in Fuchsia?

  • SeeFuchsia tracing guidelines