Skip to content

Commit 0654f5e

Browse files
derekxu16parlough
andauthored
[3.38] Document the --profile-startup Dart / Flutter CLI flags (#12272)
Co-authored-by: Parker Lougheed <[email protected]>
1 parent d16ba4b commit 0654f5e

File tree

1 file changed

+9
-2
lines changed

1 file changed

+9
-2
lines changed

src/content/tools/devtools/cpu-profiler.md

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -38,8 +38,15 @@ and Flame chart).
3838
To load all available CPU samples without manually
3939
recording and stopping, you can click **Load all CPU samples**,
4040
which pulls all CPU samples that the VM has recorded and
41-
stored in its ring buffer, and then displays those
42-
CPU samples in the profiler views.
41+
stored in its sample buffer and then
42+
displays those CPU samples in the profiler view.
43+
44+
By default, the VM's sample buffer is used as a ring buffer,
45+
meaning that once it has become full, new samples start
46+
overwriting the oldest ones in the buffer.
47+
To make the VM instead discard all samples collected after
48+
the sample buffer has become full,
49+
pass the `--profile-startup` flag to `dart run` or `flutter run`.
4350

4451
### Bottom up
4552

0 commit comments

Comments
 (0)