Files
sdk/runtime/docs/aot_binary_size_analysis.md
T
Martin Kustermann 354921f955 Update runtime/docs/aot_binary_size_analysis.md with paragraph about size comparison tool
Closes #38950
https://github.com/dart-lang/sdk/pull/38950

GitOrigin-RevId: 31625fab4668271f17f4d8d980eac8973eaa69ed
Change-Id: I00cf15f5ddb019441acc8ddf84556d881832500e
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/122020
Commit-Queue: Vyacheslav Egorov <vegorov@google.com>
Reviewed-by: Vyacheslav Egorov <vegorov@google.com>
2019-10-21 21:06:39 +00:00

1.4 KiB

AOT code size analysis

The Dart VM's AOT compiler has support for emitting binary size information for all the code that gets generated. This information can then be visualized.

Telling the AOT compiler to generate binary size information

Our AOT compiler accepts an extra --print-instructions-sizes-to=sizes.json flag. If supplied the AOT compiler will emit binary size information for all generated functions to sizes.json.

This flag can be passed to gen_snapshot directly, or to the various wrapper scripts (e.g. pkg/vm/tool/precompiler2):

% tools/build.py -mrelease -ax64 runtime_kernel dart_precompiled_runtime
% pkg/vm/tool/precompiler2 --print-instructions-sizes-to=hello_sizes.json hello.dart hello.dart.aot

Visualizing the information from the binary size json file

To visualize the information emitted by the AOT compiler one can use our binary size analysis tool:

% dart pkg/vm/bin/run_binary_size_analysis.dart hello_sizes.json hello_sizes
Generated file:///.../sdk/hello_sizes/index.html
% chrome hello_sizes/index.html

Comparing the sizes of two AOT builds

To visualize the differences between two AOT builds one can use our binary size comparison tool:

% dart pkg/vm/bin/compare_sizes.dart app-sizes--before.json app-sizes--after.json

+---------+--------+--------------+
| Library | Method | Diff (Bytes) |
+---------+--------+--------------+
...