ProfileRunRequest class
A request to launch and profile a Dart or Flutter command.
Use this with ProfileRunner.run when the profiler should own the target
process lifecycle. The command must start with dart or flutter, or with
a Dart file path that will be expanded to dart run <file>.
Session artifacts are written under artifactDirectory when provided, or
under a generated .dart_tool/devtools_profiler/sessions/... directory
inside workingDirectory otherwise.
Constructors
-
ProfileRunRequest({required List<
String> command, String? workingDirectory, String? artifactDirectory, bool forwardOutput = false, Map<String, String> environment = const {}, ProfileProcessIoMode processIoMode = ProfileProcessIoMode.pipe, bool handleInterruptSignals = false, Duration? runDuration, Duration? warmUpDuration, Duration? vmServiceTimeout}) -
Creates a profiling request.
const
Properties
- artifactDirectory → String?
-
The directory where profiling artifacts should be written.
final
-
command
→ List<
String> -
The command to launch.
final
-
environment
→ Map<
String, String> -
Extra environment variables to inject into the launched process.
final
- forwardOutput → bool
-
Whether stdout and stderr from the profiled process should be echoed.
final
- handleInterruptSignals → bool
-
Whether ProfileRunner.run should trap interrupt signals while running.
final
- hashCode → int
-
The hash code for this object.
no setterinherited
- processIoMode → ProfileProcessIoMode
-
How the launched process should receive standard IO.
final
- runDuration → Duration?
-
Optional duration to profile before terminating the launched process.
final
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
- vmServiceTimeout → Duration?
-
Optional timeout for waiting for the launched process to expose a VM
service URI.
final
- warmUpDuration → Duration?
-
Optional warm-up period before the profiling timer starts.
final
- workingDirectory → String?
-
The working directory to use for the launched process.
final
Methods
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
toString(
) → String -
A string representation of this object.
inherited
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited