Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(51)

Side by Side Diff: sky/sdk/README.md

Issue 1114553004: Update SDK README to discuss about:tracing and observatory. (Closed) Base URL: git@github.com:domokit/mojo.git@master
Patch Set: Created 5 years, 7 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch
« no previous file with comments | « no previous file | sky/sdk/packages/sky/CHANGELOG.md » ('j') | no next file with comments »
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
OLDNEW
1 Sky 1 Sky
2 === 2 ===
3 3
4 Sky is an experimental, high-performance UI framework for mobile apps. Sky helps 4 Sky is an experimental, high-performance UI framework for mobile apps. Sky helps
5 you create apps with beautiful user interfaces and high-quality interactive 5 you create apps with beautiful user interfaces and high-quality interactive
6 design that run smoothly at 120 Hz. 6 design that run smoothly at 120 Hz.
7 7
8 Sky consists of two components: 8 Sky consists of two components:
9 9
10 1. *The Sky engine.* The engine is the core of the system. Written in C++, the 10 1. *The Sky engine.* The engine is the core of the system. Written in C++, the
(...skipping 115 matching lines...) Expand 10 before | Expand all | Expand 10 after
126 126
127 3. Using a USB cable, plug your phone into your computer. If prompted on your 127 3. Using a USB cable, plug your phone into your computer. If prompted on your
128 device, authorize your computer to access your device. 128 device, authorize your computer to access your device.
129 129
130 Running a Sky application 130 Running a Sky application
131 ------------------------- 131 -------------------------
132 132
133 The `sky` pub package includes a `sky_tool` script to assist in running 133 The `sky` pub package includes a `sky_tool` script to assist in running
134 Sky applications inside the `SkyDemo.apk` harness. 134 Sky applications inside the `SkyDemo.apk` harness.
135 135
136 1. ``packages/sky/lib/sky_tool start --install examples/stocks/main.sky`` 136 1. ``packages/sky/sky_tool start --install examples/stocks/main.sky``
137 The --install flag is only necessary to install SkyDemo.apk if not already 137 The --install flag is only necessary to install SkyDemo.apk if not already
138 installed from the Google Play store. 138 installed from the Google Play store.
139 139
140 2. Use ``adb logcat`` to view any errors or Dart print() output from the app. 140 2. Use ``adb logcat`` to view any errors or Dart print() output from the app.
141 141
142 Measuring Performance
143 ---------------------
144
145 Sky has support for generating trace files compatible with
146 [Chrome's about:tracing](https://www.chromium.org/developers/how-tos/trace-event -profiling-tool).
147
148 `packages/sky/sky_tool start_tracing` and `packages/sky/sky_tool stop_tracing`
149 are the commands to use.
150
151 Due to [a bug](https://github.com/domokit/mojo/issues/127) this currently
152 requires root access on the device.
153
154 Debugging
155 ---------
156
157 Dart's [Observatory](https://www.dartlang.org/tools/observatory/)
158 (VM Debugger & Profiler) support in Sky is
159 [in progress](https://codereview.chromium.org/1107803002) and should
160 be released shortly after Dart Summit 2015.
161
142 Building a standalone MyApp 162 Building a standalone MyApp
143 --------------------------- 163 ---------------------------
144 164
145 Although it is possible to bundle the Sky Engine in your own app (instead of 165 Although it is possible to bundle the Sky Engine in your own app (instead of
146 running your code inside SkyDemo.apk), right now doing so is difficult. 166 running your code inside SkyDemo.apk), right now doing so is difficult.
147 167
148 There is one example of doing so if you're feeling brave: 168 There is one example of doing so if you're feeling brave:
149 https://github.com/domokit/mojo/tree/master/sky/apk/stocks 169 https://github.com/domokit/mojo/tree/master/sky/apk/stocks
150 170
151 Eventually we plan to make this much easier and support platforms other than 171 Eventually we plan to make this much easier and support platforms other than
(...skipping 15 matching lines...) Expand all
167 [Keyboard](https://github.com/domokit/mojo/blob/master/mojo/services/keyboard/pu blic/interfaces/keyboard.mojom) 187 [Keyboard](https://github.com/domokit/mojo/blob/master/mojo/services/keyboard/pu blic/interfaces/keyboard.mojom)
168 service to allow Sky Framework Dart code to interface with the underlying 188 service to allow Sky Framework Dart code to interface with the underlying
169 platform's Keyboard, but also to expose any additional non-Dart business logic 189 platform's Keyboard, but also to expose any additional non-Dart business logic
170 to Sky/Dart UI code. 190 to Sky/Dart UI code.
171 191
172 As and example, [SkyApplication](https://github.com/domokit/mojo/blob/master/sky /shell/org/domokit/sky/shell/SkyApplication.java) 192 As and example, [SkyApplication](https://github.com/domokit/mojo/blob/master/sky /shell/org/domokit/sky/shell/SkyApplication.java)
173 exposes a mojo `network_service` (required by Sky Engine C++ code) 193 exposes a mojo `network_service` (required by Sky Engine C++ code)
174 [SkyDemoApplication](https://github.com/domokit/mojo/blob/master/sky/apk/demo/or g/domokit/sky/demo/SkyDemoApplication.java) 194 [SkyDemoApplication](https://github.com/domokit/mojo/blob/master/sky/apk/demo/or g/domokit/sky/demo/SkyDemoApplication.java)
175 additionally exposes `keyboard_service` and `sensor_service` for use by the Sky 195 additionally exposes `keyboard_service` and `sensor_service` for use by the Sky
176 Framework from Dart. 196 Framework from Dart.
OLDNEW
« no previous file with comments | « no previous file | sky/sdk/packages/sky/CHANGELOG.md » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698