DEV/flutter_flutter
1
0
Fork 0
mirror of https://github.com/flutter/flutter.git synced 2026-02-20 02:29:02 +08:00
Code Issues Packages Projects Releases Wiki Activity

Document native functions for compilation trace (#7256)

Browse Source
This commit is contained in:
Stanislav Baranov 2018-12-20 11:48:59 -08:00 committed by GitHub
parent b81d1b4736
commit e859296b71
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 21 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

31
lib/ui/natives.dart
View File

@ -36,22 +36,33 @@ void _setupHooks() {
}());
}
void saveCompilationTrace(String filePath) {
final dynamic result = _saveCompilationTrace();
if (result is Error)
throw result;
final File file = new File(filePath);
file.writeAsBytesSync(result);
}
List<int> dumpCompilationTrace() {
/// Returns runtime Dart compilation trace as a UTF-8 encoded memory buffer.
///
/// The buffer contains a list of symbols compiled by the Dart JIT at runtime up to the point
/// when this function was called. This list can be saved to a text file and passed to tools
/// such as `flutter build` or Dart `gen_snapshot` in order to precompile this code offline.
///
/// The list has one symbol per line of the following format: `<namespace>,<class>,<symbol>\n`.
/// Here are some examples:
///
/// ```
/// dart:core,Duration,get:inMilliseconds
/// package:flutter/src/widgets/binding.dart,::,runApp
/// file:///.../my_app.dart,::,main
/// ```
///
/// This function is only effective in debug and dynamic modes, and will throw in AOT mode.
List<int> saveCompilationTrace() {
final dynamic result = _saveCompilationTrace();
if (result is Error)
throw result;
return result;
}
// TODO(sbaranov): This function will go away in subsequent PR, once the framework has caught up.
@Deprecated('Use saveCompilationTrace() instead.')
List<int> dumpCompilationTrace() => saveCompilationTrace();
dynamic _saveCompilationTrace() native 'SaveCompilationTrace';
void _scheduleMicrotask(void callback()) native 'ScheduleMicrotask';