Flutter Engine
The Flutter Engine
Loading...
Searching...
No Matches
switches.h
Go to the documentation of this file.
1// Copyright 2013 The Flutter Authors. All rights reserved.
2// Use of this source code is governed by a BSD-style license that can be
3// found in the LICENSE file.
4
5#include <string_view>
6
7#include "flutter/common/settings.h"
8#include "flutter/fml/command_line.h"
9
10#ifndef FLUTTER_SHELL_COMMON_SWITCHES_H_
11#define FLUTTER_SHELL_COMMON_SWITCHES_H_
12
13namespace flutter {
14
15// clang-format off
16#ifndef DEF_SWITCHES_START
17#define DEF_SWITCHES_START enum class Switch {
18#endif
19#ifndef DEF_SWITCH
20#define DEF_SWITCH(swtch, flag, help) swtch,
21#endif
22#ifndef DEF_SWITCHES_END
23#define DEF_SWITCHES_END Sentinel, } ;
24#endif
25// clang-format on
26
28DEF_SWITCH(AotSharedLibraryName,
29 "aot-shared-library-name",
30 "Name of the *.so containing AOT compiled Dart assets.")
31DEF_SWITCH(AotVMServiceSharedLibraryName,
32 "aot-vmservice-shared-library-name",
33 "Name of the *.so containing AOT compiled Dart assets for "
34 "launching the service isolate.")
35DEF_SWITCH(SnapshotAssetPath,
36 "snapshot-asset-path",
37 "Path to the directory containing the four files specified by "
38 "VmSnapshotData, VmSnapshotInstructions, "
39 "VmSnapshotInstructions and IsolateSnapshotInstructions.")
40DEF_SWITCH(VmSnapshotData,
41 "vm-snapshot-data",
42 "The VM snapshot data that will be memory mapped as read-only. "
43 "SnapshotAssetPath must be present.")
44DEF_SWITCH(VmSnapshotInstructions,
45 "vm-snapshot-instr",
46 "The VM instructions snapshot that will be memory mapped as read "
47 "and executable. SnapshotAssetPath must be present.")
48DEF_SWITCH(IsolateSnapshotData,
49 "isolate-snapshot-data",
50 "The isolate snapshot data that will be memory mapped as read-only. "
51 "SnapshotAssetPath must be present.")
52DEF_SWITCH(IsolateSnapshotInstructions,
53 "isolate-snapshot-instr",
54 "The isolate instructions snapshot that will be memory mapped as "
55 "read and executable. SnapshotAssetPath must be present.")
56DEF_SWITCH(CacheDirPath,
58 "Path to the cache directory. "
59 "This is different from the persistent_cache_path in embedder.h, "
60 "which is used for Skia shader cache.")
61DEF_SWITCH(ICUDataFilePath, "icu-data-file-path", "Path to the ICU data file.")
62DEF_SWITCH(ICUSymbolPrefix,
63 "icu-symbol-prefix",
64 "Prefix for the symbols representing ICU data linked into the "
65 "Flutter library.")
66DEF_SWITCH(ICUNativeLibPath,
67 "icu-native-lib-path",
68 "Path to the library file that exports the ICU data.")
69DEF_SWITCH(DartFlags,
70 "dart-flags",
71 "Flags passed directly to the Dart VM without being interpreted "
72 "by the Flutter shell.")
73DEF_SWITCH(DeviceVMServiceHost,
75 "The hostname/IP address on which the Dart VM Service should "
76 "be served. If not set, defaults to 127.0.0.1 or ::1 depending on "
77 "whether --ipv6 is specified.")
78// TODO(bkonyi): remove once flutter_tools no longer uses this option.
79// See https://github.com/dart-lang/sdk/issues/50233
80DEF_SWITCH(
81 DeviceObservatoryHost,
82 "observatory-host",
83 "(deprecated) The hostname/IP address on which the Dart VM Service should "
84 "be served. If not set, defaults to 127.0.0.1 or ::1 depending on "
85 "whether --ipv6 is specified.")
86DEF_SWITCH(DeviceVMServicePort,
88 "A custom Dart VM Service port. The default is to pick a randomly "
89 "available open port.")
90// TODO(bkonyi): remove once flutter_tools no longer uses this option.
91// See https://github.com/dart-lang/sdk/issues/50233
92DEF_SWITCH(DeviceObservatoryPort,
93 "observatory-port",
94 "(deprecated) A custom Dart VM Service port. The default is to pick "
95 "a randomly "
96 "available open port.")
97DEF_SWITCH(
98 DisableVMService,
99 "disable-vm-service",
100 "Disable the Dart VM Service. The Dart VM Service is never available "
101 "in release mode.")
102// TODO(bkonyi): remove once flutter_tools no longer uses this option.
103// See https://github.com/dart-lang/sdk/issues/50233
104DEF_SWITCH(DisableObservatory,
105 "disable-observatory",
106 "(deprecated) Disable the Dart VM Service. The Dart VM Service is "
107 "never available "
108 "in release mode.")
109DEF_SWITCH(DisableVMServicePublication,
110 "disable-vm-service-publication",
111 "Disable mDNS Dart VM Service publication.")
112// TODO(bkonyi): remove once flutter_tools no longer uses this option.
113// See https://github.com/dart-lang/sdk/issues/50233
114DEF_SWITCH(DisableObservatoryPublication,
115 "disable-observatory-publication",
116 "(deprecated) Disable mDNS Dart VM Service publication.")
117DEF_SWITCH(IPv6,
119 "Bind to the IPv6 localhost address for the Dart VM Service. "
120 "Ignored if --vm-service-host is set.")
121DEF_SWITCH(EnableDartProfiling,
122 "enable-dart-profiling",
123 "Enable Dart profiling. Profiling information can be viewed from "
124 "Dart / Flutter DevTools.")
125DEF_SWITCH(EndlessTraceBuffer,
126 "endless-trace-buffer",
127 "Enable an endless trace buffer. The default is a ring buffer. "
128 "This is useful when very old events need to viewed. For example, "
129 "during application launch. Memory usage will continue to grow "
130 "indefinitely however.")
131DEF_SWITCH(EnableSoftwareRendering,
132 "enable-software-rendering",
133 "Enable rendering using the Skia software backend. This is useful "
134 "when testing Flutter on emulators. By default, Flutter will "
135 "attempt to either use OpenGL, Metal, or Vulkan.")
136DEF_SWITCH(Route,
138 "Start app with an specific route defined on the framework")
139DEF_SWITCH(SkiaDeterministicRendering,
140 "skia-deterministic-rendering",
141 "Skips the call to SkGraphics::Init(), thus avoiding swapping out "
142 "some Skia function pointers based on available CPU features. This "
143 "is used to obtain 100% deterministic behavior in Skia rendering.")
144DEF_SWITCH(FlutterAssetsDir,
145 "flutter-assets-dir",
146 "Path to the Flutter assets directory.")
147DEF_SWITCH(Help, "help", "Display this help text.")
148DEF_SWITCH(LogTag, "log-tag", "Tag associated with log messages.")
149DEF_SWITCH(DisableServiceAuthCodes,
150 "disable-service-auth-codes",
151 "Disable the requirement for authentication codes for communicating"
152 " with the VM service.")
153DEF_SWITCH(EnableServicePortFallback,
155 "Allow the VM service to fallback to automatic port selection if"
156 " binding to a specified port fails.")
157DEF_SWITCH(StartPaused,
158 "start-paused",
159 "Start the application paused in the Dart debugger.")
160DEF_SWITCH(EnableCheckedMode, "enable-checked-mode", "Enable checked mode.")
161DEF_SWITCH(TraceStartup,
162 "trace-startup",
163 "Trace early application lifecycle. Automatically switches to an "
164 "endless trace buffer.")
165DEF_SWITCH(TraceSkia,
166 "trace-skia",
167 "Trace Skia calls. This is useful when debugging the GPU threed."
168 "By default, Skia tracing is not enabled to reduce the number of "
169 "traced events")
170DEF_SWITCH(TraceSkiaAllowlist,
172 "Filters out all Skia trace event categories except those that are "
173 "specified in this comma separated list.")
174DEF_SWITCH(
175 TraceAllowlist,
176 "trace-allowlist",
177 "Filters out all trace events except those that are specified in this "
178 "comma separated list of allowed prefixes.")
179DEF_SWITCH(DumpSkpOnShaderCompilation,
180 "dump-skp-on-shader-compilation",
181 "Automatically dump the skp that triggers new shader compilations. "
182 "This is useful for writing custom ShaderWarmUp to reduce jank. "
183 "By default, this is not enabled to reduce the overhead. ")
184DEF_SWITCH(CacheSkSL,
185 "cache-sksl",
186 "Only cache the shader in SkSL instead of binary or GLSL. This "
187 "should only be used during development phases. The generated SkSLs "
188 "can later be used in the release build for shader precompilation "
189 "at launch in order to eliminate the shader-compile jank.")
190DEF_SWITCH(PurgePersistentCache,
191 "purge-persistent-cache",
192 "Remove all existing persistent cache. This is mainly for debugging "
193 "purposes such as reproducing the shader compilation jank.")
194DEF_SWITCH(
195 TraceSystrace,
196 "trace-systrace",
197 "Trace to the system tracer (instead of the timeline) on platforms where "
198 "such a tracer is available. Currently only supported on Android and "
199 "Fuchsia.")
200DEF_SWITCH(TraceToFile,
201 "trace-to-file",
202 "Write the timeline trace to a file at the specified path. The file "
203 "will be in Perfetto's proto format; it will be possible to load "
204 "the file into Perfetto's trace viewer.")
205DEF_SWITCH(UseTestFonts,
206 "use-test-fonts",
207 "Running tests that layout and measure text will not yield "
208 "consistent results across various platforms. Enabling this option "
209 "will make font resolution default to the Ahem test font on all "
210 "platforms (See https://www.w3.org/Style/CSS/Test/Fonts/Ahem/). "
211 "This option is only available on the desktop test shells.")
212DEF_SWITCH(DisableAssetFonts,
213 "disable-asset-fonts",
214 "Prevents usage of any non-test fonts unless they were explicitly "
215 "Loaded via dart:ui font APIs. This option is only available on the "
216 "desktop test shells.")
217DEF_SWITCH(PrefetchedDefaultFontManager,
218 "prefetched-default-font-manager",
219 "Indicates whether the embedding started a prefetch of the "
220 "default font manager before creating the engine.")
221DEF_SWITCH(VerboseLogging,
222 "verbose-logging",
223 "By default, only errors are logged. This flag enabled logging at "
224 "all severity levels. This is NOT a per shell flag and affect log "
225 "levels for all shells in the process.")
226DEF_SWITCH(RunForever,
228 "In non-interactive mode, keep the shell running after the Dart "
229 "script has completed.")
230DEF_SWITCH(DisableDartAsserts,
231 "disable-dart-asserts",
232 "Dart code runs with assertions enabled when the runtime mode is "
233 "debug. In profile and release product modes, assertions are "
234 "disabled. This flag may be specified if the user wishes to run "
235 "with assertions disabled in the debug product mode (i.e. with JIT "
236 "or DBC).")
237DEF_SWITCH(EnableSerialGC,
238 "enable-serial-gc",
239 "On low power devices with low core counts, running concurrent "
240 "GC tasks on threads can cause them to contend with the UI thread "
241 "which could potentially lead to jank. This option turns off all "
242 "concurrent GC activities")
243DEF_SWITCH(DisallowInsecureConnections,
244 "disallow-insecure-connections",
245 "By default, dart:io allows all socket connections. If this switch "
246 "is set, all insecure connections are rejected.")
247DEF_SWITCH(DomainNetworkPolicy,
248 "domain-network-policy",
249 "JSON encoded network policy per domain. This overrides the "
250 "DisallowInsecureConnections switch. Embedder can specify whether "
251 "to allow or disallow insecure connections at a domain level.")
252DEF_SWITCH(
253 ForceMultithreading,
254 "force-multithreading",
255 "Uses separate threads for the platform, UI, GPU and IO task runners. "
256 "By default, a single thread is used for all task runners. Only available "
257 "in the flutter_tester.")
258DEF_SWITCH(OldGenHeapSize,
259 "old-gen-heap-size",
260 "The size limit in megabytes for the Dart VM old gen heap space.")
261
262DEF_SWITCH(ResourceCacheMaxBytesThreshold,
263 "resource-cache-max-bytes-threshold",
264 "The max bytes threshold of resource cache, or 0 for unlimited.")
265DEF_SWITCH(EnableImpeller,
266 "enable-impeller",
267 "Enable the Impeller renderer on supported platforms. Ignored if "
268 "Impeller is not supported on the platform.")
269DEF_SWITCH(ImpellerBackend,
270 "impeller-backend",
271 "Requests a particular Impeller backend on platforms that support "
272 "multiple backends. (ex `opengles` or `vulkan`)")
273DEF_SWITCH(EnableVulkanValidation,
275 "Enable loading Vulkan validation layers. The layers must be "
276 "available to the application and loadable. On non-Vulkan backends, "
277 "this flag does nothing.")
278DEF_SWITCH(EnableOpenGLGPUTracing,
279 "enable-opengl-gpu-tracing",
280 "Enable tracing of GPU execution time when using the Impeller "
281 "OpenGLES backend.")
282DEF_SWITCH(EnableVulkanGPUTracing,
283 "enable-vulkan-gpu-tracing",
284 "Enable tracing of GPU execution time when using the Impeller "
285 "Vulkan backend.")
286DEF_SWITCH(LeakVM,
287 "leak-vm",
288 "When the last shell shuts down, the shared VM is leaked by default "
289 "(the leak_vm in VM settings is true). To clean up the leak VM, set "
290 "this value to false.")
291DEF_SWITCH(
292 MsaaSamples,
293 "msaa-samples",
294 "The minimum number of samples to require for multisampled anti-aliasing. "
295 "Setting this value to 0 or 1 disables MSAA. If it is not 0 or 1, it must "
296 "be one of 2, 4, 8, or 16. However, if the GPU does not support the "
297 "requested sampling value, MSAA will be disabled.")
298DEF_SWITCH(EnableEmbedderAPI,
299 "enable-embedder-api",
300 "Enable the embedder api. Defaults to false. iOS only.")
301DEF_SWITCHES_END
302
303void PrintUsage(const std::string& executable_name);
304
305const std::string_view FlagForSwitch(Switch swtch);
306
307Settings SettingsFromCommandLine(const fml::CommandLine& command_line);
308
309} // namespace flutter
310
311#endif // FLUTTER_SHELL_COMMON_SWITCHES_H_
static BlurTest tests[]
Definition BlurTest.cpp:84
static bool read(SkStream *stream, void *buffer, size_t amount)
constexpr SkSLTestFlags CPU
Definition SkSLTest.cpp:950
static void dump(const float m[20], SkYUVColorSpace cs, bool rgb2yuv)
SI T load(const P *ptr)
FlutterEngine engine
Definition main.cc:67
struct MyStruct s
struct MyStruct a[10]
FlutterSemanticsFlag flag
FlutterSemanticsFlag flags
FlKeyEvent * event
Dart_NativeFunction function
Definition fuchsia.cc:51
void Init()
static float max(float r, float g, float b)
Definition hsl.cpp:49
std::u16string text
static sk_sp< SkImage > make(sk_sp< SkColorSpace > cs)
Definition mipmap.cpp:65
Definition build.py:1
it will be possible to load the file into Perfetto s trace viewer disable asset Prevents usage of any non test fonts unless they were explicitly Loaded via prefetched default font Indicates whether the embedding started a prefetch of the default font manager before creating the engine run In non interactive keep the shell running after the Dart script has completed enable serial On low power devices with low core running concurrent GC tasks on threads can cause them to contend with the UI thread which could potentially lead to jank This option turns off all concurrent GC activities domain network JSON encoded network policy per domain This overrides the DisallowInsecureConnections switch Embedder can specify whether to allow or disallow insecure connections at a domain level old gen heap The size limit in megabytes for the Dart VM old gen heap space enable Enable the Impeller renderer on supported platforms Ignored if Impeller is not supported on the platform enable vulkan Enable loading Vulkan validation layers The layers must be available to the application and loadable On non Vulkan this flag does nothing enable vulkan gpu tracing
Definition switches.h:283
DEF_SWITCHES_START aot vmservice shared library Name of the *so containing AOT compiled Dart assets for launching the service isolate vm snapshot The VM snapshot data that will be memory mapped as read only SnapshotAssetPath must be present isolate snapshot The isolate snapshot data that will be memory mapped as read only SnapshotAssetPath must be present cache dir Path to the cache directory This is different from the persistent_cache_path in embedder which is used for Skia shader cache icu native lib Path to the library file that exports the ICU data vm service The hostname IP address on which the Dart VM Service should be served If not defaults to or::depending on whether ipv6 is specified vm service port
Definition switches.h:87
DEF_SWITCHES_START aot vmservice shared library Name of the *so containing AOT compiled Dart assets for launching the service isolate vm snapshot The VM snapshot data that will be memory mapped as read only SnapshotAssetPath must be present isolate snapshot The isolate snapshot data that will be memory mapped as read only SnapshotAssetPath must be present cache dir Path to the cache directory This is different from the persistent_cache_path in embedder which is used for Skia shader cache icu native lib Path to the library file that exports the ICU data vm service The hostname IP address on which the Dart VM Service should be served If not defaults to or::depending on whether ipv6 is specified vm service A custom Dart VM Service port The default is to pick a randomly available open port disable vm Disable the Dart VM Service The Dart VM Service is never available in release mode disable vm service Disable mDNS Dart VM Service publication Bind to the IPv6 localhost address for the Dart VM Service Ignored if vm service host is set endless trace Enable an endless trace buffer The default is a ring buffer This is useful when very old events need to viewed For example
Definition switches.h:128
DEF_SWITCHES_START aot vmservice shared library Name of the *so containing AOT compiled Dart assets for launching the service isolate vm snapshot The VM snapshot data that will be memory mapped as read only SnapshotAssetPath must be present isolate snapshot The isolate snapshot data that will be memory mapped as read only SnapshotAssetPath must be present cache dir Path to the cache directory This is different from the persistent_cache_path in embedder which is used for Skia shader cache icu native lib Path to the library file that exports the ICU data vm service The hostname IP address on which the Dart VM Service should be served If not defaults to or::depending on whether ipv6 is specified vm service A custom Dart VM Service port The default is to pick a randomly available open port disable vm Disable the Dart VM Service The Dart VM Service is never available in release mode disable vm service Disable mDNS Dart VM Service publication Bind to the IPv6 localhost address for the Dart VM Service Ignored if vm service host is set endless trace Enable an endless trace buffer The default is a ring buffer This is useful when very old events need to viewed For during application launch Memory usage will continue to grow indefinitely however Start app with an specific route defined on the framework flutter assets Path to the Flutter assets directory enable service port Allow the VM service to fallback to automatic port selection if binding to a specified port fails trace Trace early application lifecycle Automatically switches to an endless trace buffer trace skia Filters out all Skia trace event categories except those that are specified in this comma separated list dump skp on shader Automatically dump the skp that triggers new shader compilations This is useful for writing custom ShaderWarmUp to reduce jank By this is not enabled to reduce the overhead purge persistent cache
Definition switches.h:191
DEF_SWITCHES_START aot vmservice shared library Name of the *so containing AOT compiled Dart assets for launching the service isolate vm snapshot The VM snapshot data that will be memory mapped as read only SnapshotAssetPath must be present isolate snapshot The isolate snapshot data that will be memory mapped as read only SnapshotAssetPath must be present cache dir Path to the cache directory This is different from the persistent_cache_path in embedder which is used for Skia shader cache icu native lib Path to the library file that exports the ICU data vm service The hostname IP address on which the Dart VM Service should be served If not defaults to or::depending on whether ipv6 is specified vm service A custom Dart VM Service port The default is to pick a randomly available open port disable vm Disable the Dart VM Service The Dart VM Service is never available in release mode disable vm service Disable mDNS Dart VM Service publication Bind to the IPv6 localhost address for the Dart VM Service Ignored if vm service host is set endless trace Enable an endless trace buffer The default is a ring buffer This is useful when very old events need to viewed For during application launch Memory usage will continue to grow indefinitely however Start app with an specific route defined on the framework flutter assets Path to the Flutter assets directory enable service port Allow the VM service to fallback to automatic port selection if binding to a specified port fails trace startup
Definition switches.h:162
it will be possible to load the file into Perfetto s trace viewer disable asset Prevents usage of any non test fonts unless they were explicitly Loaded via prefetched default font manager
Definition switches.h:218
it will be possible to load the file into Perfetto s trace viewer disable asset Prevents usage of any non test fonts unless they were explicitly Loaded via prefetched default font Indicates whether the embedding started a prefetch of the default font manager before creating the engine run forever
Definition switches.h:227
Settings SettingsFromCommandLine(const fml::CommandLine &command_line)
Definition switches.cc:229
DEF_SWITCHES_START aot vmservice shared library Name of the *so containing AOT compiled Dart assets for launching the service isolate vm snapshot The VM snapshot data that will be memory mapped as read only SnapshotAssetPath must be present isolate snapshot The isolate snapshot data that will be memory mapped as read only SnapshotAssetPath must be present cache dir path
Definition switches.h:57
DEF_SWITCHES_START aot vmservice shared library Name of the *so containing AOT compiled Dart assets for launching the service isolate vm snapshot The VM snapshot data that will be memory mapped as read only SnapshotAssetPath must be present isolate snapshot The isolate snapshot data that will be memory mapped as read only SnapshotAssetPath must be present cache dir Path to the cache directory This is different from the persistent_cache_path in embedder which is used for Skia shader cache icu native lib Path to the library file that exports the ICU data vm service host
Definition switches.h:74
DEF_SWITCHES_START aot vmservice shared library name
Definition switches.h:32
DEF_SWITCHES_START aot vmservice shared library Name of the *so containing AOT compiled Dart assets for launching the service isolate vm snapshot The VM snapshot data that will be memory mapped as read only SnapshotAssetPath must be present isolate snapshot The isolate snapshot data that will be memory mapped as read only SnapshotAssetPath must be present cache dir Path to the cache directory This is different from the persistent_cache_path in embedder which is used for Skia shader cache icu native lib Path to the library file that exports the ICU data vm service The hostname IP address on which the Dart VM Service should be served If not defaults to or::depending on whether ipv6 is specified vm service A custom Dart VM Service port The default is to pick a randomly available open port disable vm Disable the Dart VM Service The Dart VM Service is never available in release mode disable vm service Disable mDNS Dart VM Service publication Bind to the IPv6 localhost address for the Dart VM Service Ignored if vm service host is set endless trace Enable an endless trace buffer The default is a ring buffer This is useful when very old events need to viewed For during application launch Memory usage will continue to grow indefinitely however Start app with an specific route defined on the framework flutter assets Path to the Flutter assets directory enable service port Allow the VM service to fallback to automatic port selection if binding to a specified port fails trace Trace early application lifecycle Automatically switches to an endless trace buffer trace skia Filters out all Skia trace event categories except those that are specified in this comma separated list dump skp on shader Automatically dump the skp that triggers new shader compilations This is useful for writing custom ShaderWarmUp to reduce jank By this is not enabled to reduce the overhead purge persistent Remove all existing persistent cache This is mainly for debugging purposes such as reproducing the shader compilation jank trace to file
Definition switches.h:201
DEF_SWITCHES_START aot vmservice shared library Name of the *so containing AOT compiled Dart assets for launching the service isolate vm snapshot The VM snapshot data that will be memory mapped as read only SnapshotAssetPath must be present isolate snapshot The isolate snapshot data that will be memory mapped as read only SnapshotAssetPath must be present cache dir Path to the cache directory This is different from the persistent_cache_path in embedder which is used for Skia shader cache icu native lib Path to the library file that exports the ICU data vm service The hostname IP address on which the Dart VM Service should be served If not defaults to or::depending on whether ipv6 is specified vm service A custom Dart VM Service port The default is to pick a randomly available open port disable vm Disable the Dart VM Service The Dart VM Service is never available in release mode disable vm service Disable mDNS Dart VM Service publication Bind to the IPv6 localhost address for the Dart VM Service Ignored if vm service host is set endless trace Enable an endless trace buffer The default is a ring buffer This is useful when very old events need to viewed For during application launch Memory usage will continue to grow indefinitely however Start app with an specific route defined on the framework flutter assets Path to the Flutter assets directory enable service port fallback
Definition switches.h:154
it will be possible to load the file into Perfetto s trace viewer disable asset Prevents usage of any non test fonts unless they were explicitly Loaded via prefetched default font Indicates whether the embedding started a prefetch of the default font manager before creating the engine run In non interactive keep the shell running after the Dart script has completed enable serial gc
Definition switches.h:238
DEF_SWITCHES_START aot vmservice shared library Name of the *so containing AOT compiled Dart assets for launching the service isolate vm snapshot data
Definition switches.h:41
DEF_SWITCHES_START aot vmservice shared library Name of the *so containing AOT compiled Dart assets for launching the service isolate vm snapshot The VM snapshot data that will be memory mapped as read only SnapshotAssetPath must be present isolate snapshot The isolate snapshot data that will be memory mapped as read only SnapshotAssetPath must be present cache dir Path to the cache directory This is different from the persistent_cache_path in embedder which is used for Skia shader cache icu native lib Path to the library file that exports the ICU data vm service The hostname IP address on which the Dart VM Service should be served If not defaults to or::depending on whether ipv6 is specified vm service A custom Dart VM Service port The default is to pick a randomly available open port disable vm Disable the Dart VM Service The Dart VM Service is never available in release mode disable vm service Disable mDNS Dart VM Service publication Bind to the IPv6 localhost address for the Dart VM Service Ignored if vm service host is set endless trace Enable an endless trace buffer The default is a ring buffer This is useful when very old events need to viewed For during application launch Memory usage will continue to grow indefinitely however Start app with an specific route defined on the framework flutter assets Path to the Flutter assets directory enable service port Allow the VM service to fallback to automatic port selection if binding to a specified port fails trace Trace early application lifecycle Automatically switches to an endless trace buffer trace skia allowlist
Definition switches.h:171
it will be possible to load the file into Perfetto s trace viewer disable asset Prevents usage of any non test fonts unless they were explicitly Loaded via prefetched default font Indicates whether the embedding started a prefetch of the default font manager before creating the engine run In non interactive keep the shell running after the Dart script has completed enable serial On low power devices with low core counts
Definition switches.h:239
DEF_SWITCHES_START aot vmservice shared library Name of the *so containing AOT compiled Dart assets for launching the service isolate vm snapshot The VM snapshot data that will be memory mapped as read only SnapshotAssetPath must be present isolate snapshot The isolate snapshot data that will be memory mapped as read only SnapshotAssetPath must be present cache dir Path to the cache directory This is different from the persistent_cache_path in embedder which is used for Skia shader cache icu native lib Path to the library file that exports the ICU data vm service The hostname IP address on which the Dart VM Service should be served If not defaults to or::depending on whether ipv6 is specified vm service A custom Dart VM Service port The default is to pick a randomly available open port disable vm Disable the Dart VM Service The Dart VM Service is never available in release mode disable vm service Disable mDNS Dart VM Service publication Bind to the IPv6 localhost address for the Dart VM Service Ignored if vm service host is set endless trace Enable an endless trace buffer The default is a ring buffer This is useful when very old events need to viewed For during application launch Memory usage will continue to grow indefinitely however Start app with an specific route defined on the framework flutter assets Path to the Flutter assets directory enable service port Allow the VM service to fallback to automatic port selection if binding to a specified port fails trace Trace early application lifecycle Automatically switches to an endless trace buffer trace skia Filters out all Skia trace event categories except those that are specified in this comma separated list dump skp on shader compilation
Definition switches.h:180
it will be possible to load the file into Perfetto s trace viewer disable asset Prevents usage of any non test fonts unless they were explicitly Loaded via prefetched default font Indicates whether the embedding started a prefetch of the default font manager before creating the engine run In non interactive keep the shell running after the Dart script has completed enable serial On low power devices with low core running concurrent GC tasks on threads can cause them to contend with the UI thread which could potentially lead to jank This option turns off all concurrent GC activities domain network policy
Definition switches.h:248
DEF_SWITCHES_START aot vmservice shared library Name of the *so containing AOT compiled Dart assets for launching the service isolate vm snapshot The VM snapshot data that will be memory mapped as read only SnapshotAssetPath must be present isolate snapshot The isolate snapshot data that will be memory mapped as read only SnapshotAssetPath must be present cache dir Path to the cache directory This is different from the persistent_cache_path in embedder which is used for Skia shader cache icu native lib Path to the library file that exports the ICU data vm service The hostname IP address on which the Dart VM Service should be served If not defaults to or::depending on whether ipv6 is specified vm service A custom Dart VM Service port The default is to pick a randomly available open port disable vm Disable the Dart VM Service The Dart VM Service is never available in release mode disable vm service Disable mDNS Dart VM Service publication Bind to the IPv6 localhost address for the Dart VM Service Ignored if vm service host is set endless trace Enable an endless trace buffer The default is a ring buffer This is useful when very old events need to viewed For during application launch Memory usage will continue to grow indefinitely however Start app with an specific route defined on the framework flutter assets dir
Definition switches.h:145
DEF_SWITCHES_START aot vmservice shared library Name of the *so containing AOT compiled Dart assets for launching the service isolate vm snapshot The VM snapshot data that will be memory mapped as read only SnapshotAssetPath must be present isolate snapshot The isolate snapshot data that will be memory mapped as read only SnapshotAssetPath must be present cache dir Path to the cache directory This is different from the persistent_cache_path in embedder which is used for Skia shader cache icu native lib Path to the library file that exports the ICU data vm service The hostname IP address on which the Dart VM Service should be served If not defaults to or::depending on whether ipv6 is specified vm service A custom Dart VM Service port The default is to pick a randomly available open port disable vm Disable the Dart VM Service The Dart VM Service is never available in release mode disable vm service Disable mDNS Dart VM Service publication Bind to the IPv6 localhost address for the Dart VM Service Ignored if vm service host is set endless trace buffer
Definition switches.h:126
it will be possible to load the file into Perfetto s trace viewer disable asset Prevents usage of any non test fonts unless they were explicitly Loaded via prefetched default font Indicates whether the embedding started a prefetch of the default font manager before creating the engine run In non interactive mode
Definition switches.h:228
DEF_SWITCHES_START aot vmservice shared library Name of the *so containing AOT compiled Dart assets for launching the service isolate vm snapshot The VM snapshot data that will be memory mapped as read only SnapshotAssetPath must be present isolate snapshot The isolate snapshot data that will be memory mapped as read only SnapshotAssetPath must be present cache dir Path to the cache directory This is different from the persistent_cache_path in embedder which is used for Skia shader cache icu native lib Path to the library file that exports the ICU data vm service The hostname IP address on which the Dart VM Service should be served If not defaults to or::depending on whether ipv6 is specified vm service A custom Dart VM Service port The default is to pick a randomly available open port disable vm service
Definition switches.h:99
it will be possible to load the file into Perfetto s trace viewer disable asset Prevents usage of any non test fonts unless they were explicitly Loaded via prefetched default font Indicates whether the embedding started a prefetch of the default font manager before creating the engine run In non interactive keep the shell running after the Dart script has completed enable serial On low power devices with low core running concurrent GC tasks on threads can cause them to contend with the UI thread which could potentially lead to jank This option turns off all concurrent GC activities domain network JSON encoded network policy per domain This overrides the DisallowInsecureConnections switch Embedder can specify whether to allow or disallow insecure connections at a domain level old gen heap size
Definition switches.h:259
DEF_SWITCHES_START aot vmservice shared library Name of the *so containing AOT compiled Dart assets for launching the service isolate vm snapshot The VM snapshot data that will be memory mapped as read only SnapshotAssetPath must be present isolate snapshot The isolate snapshot data that will be memory mapped as read only SnapshotAssetPath must be present cache dir Path to the cache directory This is different from the persistent_cache_path in embedder which is used for Skia shader cache icu native lib Path to the library file that exports the ICU data vm service The hostname IP address on which the Dart VM Service should be served If not defaults to or::depending on whether ipv6 is specified vm service A custom Dart VM Service port The default is to pick a randomly available open port disable vm Disable the Dart VM Service The Dart VM Service is never available in release mode disable vm service publication
Definition switches.h:110
it will be possible to load the file into Perfetto s trace viewer disable asset fonts
Definition switches.h:213
it will be possible to load the file into Perfetto s trace viewer disable asset Prevents usage of any non test fonts unless they were explicitly Loaded via prefetched default font Indicates whether the embedding started a prefetch of the default font manager before creating the engine run In non interactive keep the shell running after the Dart script has completed enable serial On low power devices with low core running concurrent GC tasks on threads can cause them to contend with the UI thread which could potentially lead to jank This option turns off all concurrent GC activities domain network JSON encoded network policy per domain This overrides the DisallowInsecureConnections switch Embedder can specify whether to allow or disallow insecure connections at a domain level old gen heap The size limit in megabytes for the Dart VM old gen heap space enable Enable the Impeller renderer on supported platforms Ignored if Impeller is not supported on the platform enable vulkan Enable loading Vulkan validation layers The layers must be available to the application and loadable On non Vulkan backends
Definition switches.h:276
DEF_SWITCHES_START aot vmservice shared library Name of the *so containing AOT compiled Dart assets for launching the service isolate vm snapshot The VM snapshot data that will be memory mapped as read only SnapshotAssetPath must be present isolate snapshot The isolate snapshot data that will be memory mapped as read only SnapshotAssetPath must be present cache dir Path to the cache directory This is different from the persistent_cache_path in embedder h
Definition switches.h:59
DEF_SWITCHES_START aot vmservice shared library Name of the *so containing AOT compiled Dart assets for launching the service isolate vm snapshot The VM snapshot data that will be memory mapped as read only SnapshotAssetPath must be present isolate snapshot The isolate snapshot data that will be memory mapped as read only SnapshotAssetPath must be present cache dir Path to the cache directory This is different from the persistent_cache_path in embedder which is used for Skia shader cache icu native lib Path to the library file that exports the ICU data vm service The hostname IP address on which the Dart VM Service should be served If not defaults to or::depending on whether ipv6 is specified vm service A custom Dart VM Service port The default is to pick a randomly available open port disable vm Disable the Dart VM Service The Dart VM Service is never available in release mode disable vm service Disable mDNS Dart VM Service publication ipv6
Definition switches.h:118
DEF_SWITCHES_START aot vmservice shared library Name of the *so containing AOT compiled Dart assets for launching the service isolate vm snapshot The VM snapshot data that will be memory mapped as read only SnapshotAssetPath must be present isolate snapshot The isolate snapshot data that will be memory mapped as read only SnapshotAssetPath must be present cache dir Path to the cache directory This is different from the persistent_cache_path in embedder which is used for Skia shader cache icu native lib Path to the library file that exports the ICU data vm service The hostname IP address on which the Dart VM Service should be served If not defaults to or::depending on whether ipv6 is specified vm service A custom Dart VM Service port The default is to pick a randomly available open port disable vm Disable the Dart VM Service The Dart VM Service is never available in release mode disable vm service Disable mDNS Dart VM Service publication Bind to the IPv6 localhost address for the Dart VM Service Ignored if vm service host is set endless trace Enable an endless trace buffer The default is a ring buffer This is useful when very old events need to viewed For during application launch Memory usage will continue to grow indefinitely however Start app with an specific route defined on the framework flutter assets Path to the Flutter assets directory enable service port Allow the VM service to fallback to automatic port selection if binding to a specified port fails trace Trace early application lifecycle Automatically switches to an endless trace buffer trace skia Filters out all Skia trace event categories except those that are specified in this comma separated list dump skp on shader Automatically dump the skp that triggers new shader compilations This is useful for writing custom ShaderWarmUp to reduce jank By this is not enabled to reduce the overhead purge persistent Remove all existing persistent cache This is mainly for debugging purposes such as reproducing the shader compilation jank trace to Write the timeline trace to a file at the specified path The file will be in Perfetto s proto format
Definition switches.h:203
DEF_SWITCHES_START aot vmservice shared library Name of the *so containing AOT compiled Dart assets for launching the service isolate vm snapshot The VM snapshot data that will be memory mapped as read only SnapshotAssetPath must be present isolate snapshot The isolate snapshot data that will be memory mapped as read only SnapshotAssetPath must be present cache dir Path to the cache directory This is different from the persistent_cache_path in embedder which is used for Skia shader cache icu native lib Path to the library file that exports the ICU data vm service The hostname IP address on which the Dart VM Service should be served If not defaults to or::depending on whether ipv6 is specified vm service A custom Dart VM Service port The default is to pick a randomly available open port disable vm Disable the Dart VM Service The Dart VM Service is never available in release mode disable vm service Disable mDNS Dart VM Service publication Bind to the IPv6 localhost address for the Dart VM Service Ignored if vm service host is set endless trace Enable an endless trace buffer The default is a ring buffer This is useful when very old events need to viewed For during application launch Memory usage will continue to grow indefinitely however route
Definition switches.h:137
it will be possible to load the file into Perfetto s trace viewer disable asset Prevents usage of any non test fonts unless they were explicitly Loaded via prefetched default font Indicates whether the embedding started a prefetch of the default font manager before creating the engine run In non interactive keep the shell running after the Dart script has completed enable serial On low power devices with low core running concurrent GC tasks on threads can cause them to contend with the UI thread which could potentially lead to jank This option turns off all concurrent GC activities domain network JSON encoded network policy per domain This overrides the DisallowInsecureConnections switch Embedder can specify whether to allow or disallow insecure connections at a domain level old gen heap The size limit in megabytes for the Dart VM old gen heap space enable Enable the Impeller renderer on supported platforms Ignored if Impeller is not supported on the platform enable vulkan validation
Definition switches.h:274
const std::string_view FlagForSwitch(Switch swtch)
Definition switches.cc:145
Definition run.py:1
Definition __init__.py:1
Definition ref_ptr.h:256
#define DEF_SWITCH(p_swtch, p_flag, p_help)
Definition switches.cc:34
#define DEF_SWITCHES_START
Definition switches.cc:33
void usage()
static void process(const char *inPath, const char *lexer, const char *token, const char *hPath, const char *cppPath)
Definition Main.cpp:114
flags to indicate/promise which of the optional texture coordinates or colors will be supplied during...
Definition dl_vertices.h:80