From 817e2a08dfd6927254f304fc2ba2003bba8a3e40 Mon Sep 17 00:00:00 2001 From: Eric Seidel Date: Tue, 28 Apr 2015 12:05:46 -0700 Subject: [PATCH] Update SDK README to discuss about:tracing and observatory. TBR=ianh@google.com Review URL: https://codereview.chromium.org/1114553004 --- sdk/README.md | 22 +++++++++++++++++++++- sdk/packages/sky/CHANGELOG.md | 8 ++++++++ sdk/packages/sky/lib/sky_tool | 1 + 3 files changed, 30 insertions(+), 1 deletion(-) diff --git a/sdk/README.md b/sdk/README.md index 15319124f87..e27175d1412 100644 --- a/sdk/README.md +++ b/sdk/README.md @@ -133,12 +133,32 @@ Running a Sky application The `sky` pub package includes a `sky_tool` script to assist in running Sky applications inside the `SkyDemo.apk` harness. -1. ``packages/sky/lib/sky_tool start --install examples/stocks/main.sky`` +1. ``packages/sky/sky_tool start --install examples/stocks/main.sky`` The --install flag is only necessary to install SkyDemo.apk if not already installed from the Google Play store. 2. Use ``adb logcat`` to view any errors or Dart print() output from the app. +Measuring Performance +--------------------- + +Sky has support for generating trace files compatible with +[Chrome's about:tracing](https://www.chromium.org/developers/how-tos/trace-event-profiling-tool). + +`packages/sky/sky_tool start_tracing` and `packages/sky/sky_tool stop_tracing` +are the commands to use. + +Due to https://github.com/domokit/mojo/issues/127 tracing currently +requires root access on the device. + +Debugging +--------- + +Dart's [Observatory](https://www.dartlang.org/tools/observatory/) +(VM Debugger & Profiler) support in Sky is +[in progress](https://codereview.chromium.org/1107803002) and should +be released shortly after Dart Summit 2015. + Building a standalone MyApp --------------------------- diff --git a/sdk/packages/sky/CHANGELOG.md b/sdk/packages/sky/CHANGELOG.md index d0f799c70e1..a92fef1ed74 100644 --- a/sdk/packages/sky/CHANGELOG.md +++ b/sdk/packages/sky/CHANGELOG.md @@ -1,3 +1,11 @@ +## 0.0.5+dart-summit-7 + + - Fix crash in sky_tool stop_tracing. + +## 0.0.5+dart-summit-6 + + - Fix missing include in sky_tool causing failure. + ## 0.0.5+dart-summit-5 - Added sky_tool start_tracing and stop_tracing. diff --git a/sdk/packages/sky/lib/sky_tool b/sdk/packages/sky/lib/sky_tool index 59264abae22..1dfe31719ab 100755 --- a/sdk/packages/sky/lib/sky_tool +++ b/sdk/packages/sky/lib/sky_tool @@ -13,6 +13,7 @@ import socket import subprocess import sys import urlparse +import time # TODO(eseidel): This should be BIN_DIR. LIB_DIR = os.path.realpath(os.path.dirname(os.path.abspath(__file__)))