languages/dart-sdk
languages/dart-sdk
1
0
Fork 0
mirror of https://github.com/dart-lang/sdk synced 2024-09-05 00:13:50 +00:00
Code Issues Packages Projects Releases Wiki Activity

[pkg/vm_snapshot_analysis] update the readme for tool name changes

Browse source 
Change-Id: I0ea1f228d7d3405b0da24858fd5f03aa7e2c8ce9
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/289442
Reviewed-by: Slava Egorov <vegorov@google.com>
Commit-Queue: Devon Carew <devoncarew@google.com>
This commit is contained in:
Devon Carew 2023-03-20 17:57:51 +00:00 committed by Commit Queue
parent c61241f926
commit 00972339e6
3 changed files with 16 additions and 11 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

5
pkg/vm_snapshot_analysis/CHANGELOG.md
View file

@ -1,5 +1,10 @@
# Changelog
## 0.7.3-dev
- Update the readme to document the current way to generate Dart AOT snapshots.
- Spelling corrections in dartdoc comments.
## 0.7.2
- Upgrade to `package:lints` 2.0.

20
pkg/vm_snapshot_analysis/README.md
View file

@ -20,25 +20,25 @@ impossible to attribute of every single byte from the snapshot to a particular
place in the program with a 100% accuracy.
* `--print-instructions-sizes-to` attributes _executable code_ from the snapshot
to a particular Dart function (or internal stub) from which this code
originated (ignoring deduplication). Executable code usually constitutes around
half of the snapshot, those this varies depending on the application.
to a particular Dart function (or internal stub) from which this code
originated (ignoring deduplication). Executable code usually constitutes
around half of the snapshot, those this varies depending on the application.
* `--write-v8-snapshot-profile-to` is a graph representation of the snapshot,
it attributes bytes written into a snapshot to a node in the heap graph. This
format covers both data and code sections of the snapshot.
it attributes bytes written into a snapshot to a node in the heap graph. This
format covers both data and code sections of the snapshot.
* `--trace-precompiler-to` gives information about dependencies between
compiled functions, allowing to determine why certain function was pulled into
the snapshot.
compiled functions, allowing to determine why certain function was pulled into
the snapshot.
### Passing flags to the AOT compiler
Both in `dart2native` and Flutter you can use `--extra-gen-snapshot-options` to
pass flags to the AOT compiler:
In both Flutter and `dart compile exe` / `dart compile aot-snapshot` you can use
`--extra-gen-snapshot-options` to pass flags to the AOT compiler:
```console
$ flutter build aot --release --extra-gen-snapshot-options=--write-v8-snapshot-profile-to=profile.json
$ dart2native --extra-gen-snapshot-options=--write-v8-snapshot-profile-to=profile.json -o binary input.dart
$ dart compile exe --extra-gen-snapshot-options=--write-v8-snapshot-profile-to=profile.json -o binary input.dart
```
Similarly with `--print-instructions-sizes-to`.

2
pkg/vm_snapshot_analysis/pubspec.yaml
View file

@ -1,5 +1,5 @@
name: vm_snapshot_analysis
version: 0.7.2
version: 0.7.3-dev
description: Utilities for analysing AOT snapshot size.
repository: https://github.com/dart-lang/sdk/tree/main/pkg/vm_snapshot_analysis