blob: 9a63467274cb0df8bce1eddb8310f5fccf1527e9 [file] [log] [blame]
Dirk Dougherty7b229ef2010-03-26 17:32:26 -07001page.title=SDK Tools
Dirk Doughertyee58d1b2009-10-16 15:25:15 -07002@jd:body
3
Dirk Dougherty7b229ef2010-03-26 17:32:26 -07004<p>SDK Tools is a downloadable component for the Android SDK. It includes the
Robert Ly6c81c302011-10-05 12:59:29 -07005complete set of development and debugging tools for the Android SDK.</p>
Dirk Doughertyee58d1b2009-10-16 15:25:15 -07006
Robert Lydec97362011-09-22 10:33:28 -07007<p>If you are new to the Android SDK, the <a
Dirk Dougherty7b229ef2010-03-26 17:32:26 -07008href="{@docRoot}sdk/index.html">SDK starter package</a> installs the
9latest revision of the SDK Tools in the <code>&lt;sdk&gt;/tools</code> directory.</p>
Dirk Doughertybf15ce62009-10-23 19:17:12 -070010
Dirk Dougherty5c2a5022009-12-17 16:59:46 -080011<p>If you are already using the SDK and you want to update to the latest version
Joe Fernandez890f7ea2011-11-28 17:00:27 -080012of the SDK Tools, use the <em>Android SDK Manager</em> to get the
Dirk Dougherty5c2a5022009-12-17 16:59:46 -080013update, rather than downloading a new SDK starter package. For more information
14about how to update, see <a
15href="{@docRoot}sdk/adding-components.html#UpdatingComponents">Updating SDK
Robert Ly6c81c302011-10-05 12:59:29 -070016Components</a>.</p>
Dirk Doughertyee58d1b2009-10-16 15:25:15 -070017
Robert Lyedc2aac2011-01-14 16:25:09 -080018
Dirk Dougherty7b229ef2010-03-26 17:32:26 -070019<h2 id="notes">Revisions</h2>
Dirk Doughertybca9f1b2009-11-18 23:06:16 -080020
Dirk Dougherty7b229ef2010-03-26 17:32:26 -070021<p>The sections below provide notes about successive releases of
22the SDK Tools, as denoted by revision number. To determine what revision of the SDK
Joe Fernandez890f7ea2011-11-28 17:00:27 -080023Tools you are using, refer to the "Installed Packages" listing in the Android SDK Manager. </p>
Dirk Doughertybca9f1b2009-11-18 23:06:16 -080024
Scott Maine09743272011-10-14 11:25:46 -070025<p>For a summary of all known issues in SDK Tools, see <a
Scott Mainb321cd92011-10-20 12:57:43 -070026href="http://tools.android.com/knownissues">http://tools.android.com/knownissues</a>.</p>
Scott Maine09743272011-10-14 11:25:46 -070027
Dirk Dougherty7b229ef2010-03-26 17:32:26 -070028<script type="text/javascript">
29function toggleDiv(link) {
30 var toggleable = $(link).parent();
31 if (toggleable.hasClass("closed")) {
32 //$(".toggleme", toggleable).slideDown("fast");
33 toggleable.removeClass("closed");
34 toggleable.addClass("open");
35 $(".toggle-img", toggleable).attr("title", "hide").attr("src", (toRoot + "assets/images/triangle-opened.png"));
36 } else {
37 //$(".toggleme", toggleable).slideUp("fast");
38 toggleable.removeClass("open");
39 toggleable.addClass("closed");
40 $(".toggle-img", toggleable).attr("title", "show").attr("src", (toRoot + "assets/images/triangle-closed.png"));
41 }
42 return false;
43}
44</script>
45<style>
46.toggleable {
47padding: .25em 1em;
48}
49.toggleme {
50 padding: 1em 1em 0 2em;
51 line-height:1em;
52}
53.toggleable a {
54 text-decoration:none;
55}
Dirk Dougherty0d1b0812010-04-07 17:05:16 -070056.toggleme a {
57 text-decoration:underline;
58}
Dirk Dougherty7b229ef2010-03-26 17:32:26 -070059.toggleable.closed .toggleme {
60 display:none;
61}
62#jd-content .toggle-img {
63 margin:0;
64}
65</style>
Dirk Dougherty0d1b0812010-04-07 17:05:16 -070066
Robert Ly490463f2011-10-24 11:06:36 -070067
Dirk Dougherty7b229ef2010-03-26 17:32:26 -070068<div class="toggleable opened">
69 <a href="#" onclick="return toggleDiv(this)">
Robert Ly6c81c302011-10-05 12:59:29 -070070 <img src="{@docRoot}assets/images/triangle-opened.png" class="toggle-img" height="9px"
Joe Fernandez890f7ea2011-11-28 17:00:27 -080071 width="9px" />
72 SDK Tools, Revision 16</a> <em>(December 2011)</em>
73
74 <div class="toggleme">
75 <p class="caution"><strong>Important:</strong> To download the new Android
76 4.0 system components from the Android SDK Manager, you must first update the
77 SDK tools to revision 14 or later and restart the Android SDK Manager. If you do not,
78 the Android 4.0 system components will not be available for download.</p>
79
80<dl>
81<dt>Dependencies:</dt>
82<dd>
83 <ul>
84 <li>Android SDK Platform-tools revision 9 or later.</li>
85 <li>If you are developing in Eclipse with ADT, note that the SDK Tools r16 is designed for use
86 with ADT 16.0.0 and later. If you haven't already, we highly recommend updating your
87 <a href="{@docRoot}sdk/eclipse-adt.html">ADT Plugin</a> to 16.0.0.</li>
88 <li>If you are developing outside Eclipse, you must have <a href="http://ant.apache.org/">Apache
89 Ant</a> 1.8 or later.</li>
90</ul>
91</dd>
92<dt>General notes:</dt>
93<dd>
94 <ul>
95 <li>Added Lint tools to detect common errors in Android projects. (<a
96href="http://tools.android.com/recent/lint">more info</a>)</li>
97 <li>Added sensor emulation support, which allows the emulator to read sensor data from a
98physical Android device.</li>
99 <li>Added support for using a webcam to emulate a camera on Mac OS X.</li>
100 </ul>
101</dd>
102<dt>Bug fixes:</dt>
103<dd>
104 <ul>
105 <li>Snapshots now work for Android 4.0 system images.</li>
106 <li>Fixed several small issues for the build file.
107 (<a href="http://code.google.com/p/android/issues/detail?id=21023">Issue 21023</a>,
108 <a href="http://code.google.com/p/android/issues/detail?id=21267">Issue 21267</a>,
109 <a href="http://code.google.com/p/android/issues/detail?id=21465">Issue 21465</a>,
110 <a href="http://code.google.com/p/android/issues/detail?id=21525">Issue 21525</a>).</li>
111 </ul>
112</dd>
113</dl>
114</div>
115</div>
116
117<div class="toggleable closed">
118 <a href="#" onclick="return toggleDiv(this)">
119 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px"
120 width="9px" />
121 SDK Tools, Revision 15</a> <em>(October 2011)</em>
Robert Ly490463f2011-10-24 11:06:36 -0700122
123 <div class="toggleme">
124 <p class="caution"><strong>Important:</strong> To download the new Android
125 4.0 system components from the Android SDK Manager, you must first update the
126 SDK tools to revision 14 or later and restart the Android SDK Manager. If you do not,
127 the Android 4.0 system components will not be available for download.</p>
128 <dl>
129<dt>Dependencies:</dt>
130<dd>
131 <ul><li>Android SDK Platform-tools revision 9 or later.</li>
132 <li>If you are developing in Eclipse with ADT, note that the SDK Tools r15 is designed for use
133 with ADT 15.0.0 and later. If you haven't already, we highly recommend updating your <a
134 href="{@docRoot}sdk/eclipse-adt.html">ADT Plugin</a> to 15.0.0.</li>
135 <li>If you are developing outside Eclipse, you must have <a href="http://ant.apache.org/">Apache
136 Ant</a> 1.8 or later.</li>
137</ul>
138
139<dt>Bug fixes:</dt>
140<dd>
141 <ul>
142 <li>Fixed emulator crash on Linux due to improper webcam detection
143 (<a href="http://code.google.com/p/android/issues/detail?id=20952">Issue 20952</a>).</li>
144 <li>Fixed emulator issue when using the <code>-wipe-data</code> argument.</li>
145 <li>Fixed build issue when using Renderscript in projects that target API levels 11-13
146 (<a href="http://code.google.com/p/android/issues/detail?id=21006">Issue 21006</a>).</li>
147 <li>Fixed issue when creating an AVD using the GoogleTV addon
148 (<a href="http://code.google.com/p/android/issues/detail?id=20963">Issue 20963</a>).</li>
149 <li>Fixed <code>ant test</code>
150 (<a href="http://code.google.com/p/android/issues/detail?id=20979">Issue 20979</a>).</li>
151 <li>Fixed <code>android update project</code>
152 (<a href="http://code.google.com/p/android/issues/detail?id=20535">Issue 20535</a>).</li>
153 <li>Fixed scrolling issue in the new Logcat panel of DDMS.</li>
154 <li>Fixed issue with MonkeyRunner
155 (<a href="http://code.google.com/p/android/issues/detail?id=20964">Issue 20964</a>).</li>
156 <li>Fixed issues in the SDK Manager
157 (<a href="http://code.google.com/p/android/issues/detail?id=20939">Issue 20939</a>,
158 <a href="http://code.google.com/p/android/issues/detail?id=20607">Issue 20607</a>).</li>
159 </ul>
160</dd>
161</dl>
162</div>
163</div>
164
165<div class="toggleable closed">
166 <a href="#" onclick="return toggleDiv(this)">
167 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px"
Joe Fernandez890f7ea2011-11-28 17:00:27 -0800168 width="9px" />
169 SDK Tools, Revision 14</a> <em>(October 2011)</em>
Robert Ly6cf7d9a2011-10-12 15:30:35 -0700170
Robert Ly6c81c302011-10-05 12:59:29 -0700171 <div class="toggleme">
Robert Ly6cf7d9a2011-10-12 15:30:35 -0700172 <p class="note"><strong>Important:</strong> To download the new Android
173 4.0 system components from the Android SDK Manager, you must first update the
174 SDK tools to revision 14 and restart the Android SDK Manager. If you do not,
175 the Android 4.0 system components will not be available for download.</p>
Robert Ly6c81c302011-10-05 12:59:29 -0700176 <dl>
177<dt>Dependencies:</dt>
178<dd>
179 <ul><li>Android SDK Platform-tools revision 8 or later.</li>
180 <li>If you are developing in Eclipse with ADT, note that the SDK Tools r14 is designed for use
181 with ADT 14.0.0 and later. If you haven't already, we highly recommend updating your <a
182 href="{@docRoot}sdk/eclipse-adt.html">ADT Plugin</a> to 14.0.0.</li>
183 <li>If you are developing outside Eclipse, you must have <a href="http://ant.apache.org/">Apache
184 Ant</a> 1.8 or later.</li>
185</ul>
186
187<dt>General notes:</dt>
188<dd>
189 <ul>
Joe Fernandez890f7ea2011-11-28 17:00:27 -0800190 <li>Added webcam support to Android 4.0 or later platforms to emulate rear-facing cameras when
191 one webcam is present, and to emulate both rear-facing and front-facing cameras when two
192 webcams are present. Webcam support is for Windows and Linux only.
Robert Ly6cf7d9a2011-10-12 15:30:35 -0700193 Mac support will come in a later release.</li>
Joe Fernandez890f7ea2011-11-28 17:00:27 -0800194 <li>Changed <code>default.properties</code> to <code>project.properties</code> and
Robert Ly6c81c302011-10-05 12:59:29 -0700195 <code>build.properties</code> to <code>ant.properties</code>. Any existing
196 projects that you build with Ant must be updated with the <code>android update project</code>
197 command.</li>
198 <li>Changed Ant <code>build.xml</code> file to support improvements to the
199 build system and added and modified Ant commands to support these changes. For a list of Ant
200commands, see the
201<a href="{@docRoot}guide/developing/building/building-cmdline.html#AntReference">Ant Command
202Reference</a>.</li>
Robert Ly6c81c302011-10-05 12:59:29 -0700203 <li>Changed how library projects are built.</a></li>
204 <li>Improved incremental builds, so that resource compilation runs less frequently. Builds no
205 longer run when you edit strings or layouts (unless you add a new <code>id</code>) and no longer
206 run once for each library project.</li>
207 <li>Introduced a "PNG crunch cache" that only runs on modified PNG files, instead of
208 crunching all existing PNG files, all the time.</li>
209 <li>Revamped the SDK Manager UI (<a href="http://tools.android.com/recent/newsdkmanager">more
210info</a>).</li>
211 </ul>
212 <p>For a complete overview of the build system changes and what you need to do to support them,
213see the <a href="http://tools.android.com/recent/buildchangesinrevision14">Android Tools Project
214site</a>.</p>
215</dd>
216</dl>
217</div>
218</div>
219
220<div class="toggleable closed">
221 <a href="#" onclick="return toggleDiv(this)">
222 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px"
223 width="9px" />
Robert Lydec97362011-09-22 10:33:28 -0700224SDK Tools, Revision 13</a> <em>(September 2011)</em>
225 <div class="toggleme">
226 <dl>
227<dt>Dependencies:</dt>
228<dd>
229<p>If you are developing in Eclipse with ADT, note that the SDK Tools r13 is designed for use with
230ADT 12.0.0 and later. If you haven't already, we highly recommend updating your <a
231href="{@docRoot}sdk/eclipse-adt.html">ADT Plugin</a> to 12.0.0.</p>
232
233<p>If you are developing outside Eclipse, you must have <a href="http://ant.apache.org/">Apache
234Ant</a> 1.8 or later.</p>
235
236<dt>General notes:</dt>
237<dd>
238 <ul>
239 <li>Fix compilation issue in Ant (<code>dex</code> step) when paths have spaces.</li>
240 <li>Fix issue in emulator installation when paths have spaces.</li>
241 <li>Fix issue when AVD paths have spaces.</li>
242 <li>Fix rendering issue when using emulator scaling (<a href="http://code.google.com/p/android/issues/detail?id=18299">see more</a>).</li>
243 </ul>
244</dd>
245</dl>
246</div>
247</div>
248
249
250<div class="toggleable closed">
251 <a href="#" onclick="return toggleDiv(this)">
252 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px" width="9px" />
Robert Ly31ee77e2011-07-06 11:16:19 -0700253SDK Tools, Revision 12</a> <em>(July 2011)</em>
Robert Ly205d1c32011-06-28 13:13:14 -0700254 <div class="toggleme">
255 <dl>
256<dt>Dependencies:</dt>
257<dd>
258<p>If you are developing in Eclipse with ADT, note that the SDK Tools r12 is designed for use with
259ADT 12.0.0 and later. If you haven't already, we highly recommend updating your <a
260href="{@docRoot}sdk/eclipse-adt.html">ADT Plugin</a> to 12.0.0.</p>
261
262<p>If you are developing outside Eclipse, you must have <a href="http://ant.apache.org/">Apache
263Ant</a> 1.8 or later.</p>
264
265<dt>General notes:</dt>
266<dd>
267 <ul>
268 <li>The AVD manager and emulator can now use system images
269 compiled for ARM v7 and x86 CPUs.</li>
270 </ul>
271</dd>
272</dl>
273</div>
274</div>
275
276<div class="toggleable closed">
277 <a href="#" onclick="return toggleDiv(this)">
278 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px" width="9px" />
Dirk Doughertyb7c7f152011-03-25 11:54:46 -0700279SDK Tools, Revision 11</a> <em>(May 2011)</em>
Robert Lyccea5d22011-02-11 14:59:36 -0800280 <div class="toggleme">
281 <dl>
282<dt>Dependencies:</dt>
283<dd>
Scott Main19f72012011-05-05 18:27:49 -0700284<p>If you are developing in Eclipse with ADT, note that the SDK Tools r11 is designed for use with
285ADT 10.0.1 and later. If you haven't already, we highly recommend updating your <a
286href="{@docRoot}sdk/eclipse-adt.html">ADT Plugin</a> to 10.0.1.</p>
287
288<p>If you are developing outside Eclipse, you must have <a href="http://ant.apache.org/">Apache
289Ant</a> 1.8 or later.</p>
290
291<dt>General notes:</dt>
292<dd>
293 <ul>
294 <li>Miscellaneous emulator changes to support Android 3.1.</li>
295 </ul>
296</dd>
297</dl>
298</div>
299</div>
300
301
302<div class="toggleable closed">
303 <a href="#" onclick="return toggleDiv(this)">
304 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px"
305width="9px" />
306SDK Tools, Revision 10</a> <em>(February 2011)</em>
307 <div class="toggleme">
308 <dl>
309<dt>Dependencies:</dt>
310<dd>
Robert Lyccea5d22011-02-11 14:59:36 -0800311<p>If you are developing in Eclipse with ADT, note that the SDK Tools r10 is
312designed for use with ADT 10.0.0 and later. After installing SDK Tools r10, we
313highly recommend updating your ADT Plugin to 10.0.0.</p>
314
315<p>If you are developing outside Eclipse, you must have <a href="http://ant.apache.org/">Apache
316Ant</a> 1.8 or later.</p>
317
318<dt>General notes:</dt>
319<dd>
320 <ul>
Scott Main19f72012011-05-05 18:27:49 -0700321 <li>The tools now automatically generate Java Programming Language source files (in the
322<code>gen</code> directory) and
Robert Lyccea5d22011-02-11 14:59:36 -0800323 bytecode (in the <code>res/raw</code> directory) from your native <code>.rs</code> files</li>
324 </ul>
325</dd>
326</dl>
327</div>
328</div>
329
330
331
332<div class="toggleable closed">
333 <a href="#" onclick="return toggleDiv(this)">
334 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px" width="9px" />
Robert Lyedc2aac2011-01-14 16:25:09 -0800335SDK Tools, Revision 9</a> <em>(January 2011)</em>
336 <div class="toggleme">
337 <dl>
338<dt>Dependencies:</dt>
339<dd>
340<p>If you are developing in Eclipse with ADT, note that the SDK Tools r9 is
341designed for use with ADT 9.0.0 and later. After installing SDK Tools r9, we
342highly recommend updating your ADT Plugin to 9.0.0.</p>
343
344<p>If you are developing outside Eclipse, you must have <a href="http://ant.apache.org/">Apache
345Ant</a> 1.8 or later.</p>
346
347<dt>Upgrading to SDK Tools r9:</dt>
348<dd>
349<p>If you are upgrading to SDK Tools r9 from SDK Tools r7 or earlier, the default installed location
350for the <code>adb</code> tool has changed from <code>&lt;<em>SDK</em>&gt;/tools/adb</code> to
351<code>&lt;<em>SDK</em>&gt;/platform-tools/adb</code>. This means that you should
352add the new location to your PATH and modify any custom build scripts to
353reference the new location. Copying the <code>adb</code> executable from the new
354location to the old is not recommended, since subsequent updates to the SDK
355Tools will delete the file.</p>
356</dd>
357
358<dt>General notes:</dt>
359<dd>
360 <ul>
361 <li>The default ProGuard configuration, <code>proguard.cfg</code>, now ignores the following classes:
362 <ul>
363 <li>classes that extend {@link android.preference.Preference}</li>
364 <li>classes that extend {@link android.app.backup.BackupAgentHelper}</li>
365 </ul>
366 </li>
367 <li>Ant lib rules now allow you to override <code>java.encoding</code>, <code>java.source</code>,
368 and <code>java.target</code> properties.</li>
369 <li>The default encoding for the <code>javac</code> Ant task is now UTF-8.</li>
370 <li>The LogCat view in DDMS now properly displays UTF-8 characters.</li>
371 <li>The SDK Manager is more reliable on Windows. For details on the improvements, see the
372 <a href="http://tools.android.com/recent/sdkmanagerfixes">Android Tools Project Site</a>. </li>
Scott Mainf9af3012011-01-27 11:26:29 -0800373 <li>Early look at the new snapshot feature: To improve startup time for the emulator, you can
374enable snapshots for the system state. The emulator will then restore to the state when it last
375closed almost instantly. <strong>Note:</strong> The snapshot feature is still under active
376development and might not always perform as expected.</li>
Robert Lyedc2aac2011-01-14 16:25:09 -0800377 <li>Fixed the missing JAR file error that prevented <code>draw9patch</code> from running.</li>
378 <li>Fixed the Windows launch scripts <code>hierarchyviewer</code> and <code>ddms</code> to support
379 the new location of <code>adb</code>.</li>
Scott Main04f04b22011-01-21 19:11:23 -0800380 <li>Known issues with emulator performance: Because the Android emulator must simulate the ARM
381instruction set architecture on your computer, emulator performance is slow. We're working hard to
382resolve the performance issues and it will improve in future releases.</li>
Robert Lyedc2aac2011-01-14 16:25:09 -0800383 </ul>
384</dd>
385</dl>
386</div>
387</div>
388
389<div class="toggleable closed">
390 <a href="#" onclick="return toggleDiv(this)">
391 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px" width="9px" />
Dirk Dougherty9f7580d2010-10-26 09:29:03 -0700392SDK Tools, Revision 8</a> <em>(December 2010)</em>
393 <div class="toggleme">
394
395<dl>
396<dt>Dependencies:</dt>
397<dd>
398<p>If you are developing in Eclipse with ADT, note that SDK Tools r8 is
399designed for use with ADT 8.0.0 and later. After installing SDK Tools r8, we
400highly recommend updating your ADT Plugin to 8.0.0.</p>
401
Scott Main92b03082010-12-14 17:55:27 -0800402<p>If you are developing outside Eclipse, you must have <a href="http://ant.apache.org/">Apache
403Ant</a> 1.8 or later.</p>
404
Dirk Dougherty9f7580d2010-10-26 09:29:03 -0700405<p>Also note that SDK Tools r8 requires a new SDK component called
406<em>Platform-tools</em>. The new Platform-tools component lets all SDK platforms
407(Android 2.1, Android 2.2, and so on) use the same (latest) version of build
408tools such as <code>adb</code>, <code>aapt</code>, <code>aidl</code>, and
409<code>dx</code>. To download the Platform-tools component, use the Android SDK
410Manager, as described in <a href="adding-components.html">Adding SDK
411Components</a></p>
412
413<dt>Upgrading from SDK Tools r7:</dt>
414<dd>
415<p>If you are upgrading to SDK Tools r8 from an earlier version, note that the
416the default installed location for the <code>adb</code> tool has changed from
417<code>&lt;<em>SDK</em>&gt;/tools/adb</code> to
418<code>&lt;<em>SDK</em>&gt;/platform-tools/adb</code>. This means that you should
419add the new location to your PATH and modify any custom build scripts to
420reference the new location. Copying the <code>adb</code> executable from the new
421location to the old is not recommended, since subsequent updates to the SDK
422Tools will delete the file.</p>
423</dd>
424
425<dt>General notes:</dt>
426<dd>
427<ul>
428<li>All SDK platforms now support Library Projects.</li>
429<li>Support for a true debug build. Developers no longer need to add the
430<code>android:debuggable</code> attribute to the
431<code>&lt;application&gt;</code> tag in the manifest &mdash; the build tools add
432the attribute automatically. In Eclipse/ADT, all incremental builds are assumed
433to be debug builds, so the tools insert <code>android:debuggable="true"</code>.
434When exporting a signed release build, the tools do not add the attribute. In
435Ant, a <code>ant debug</code> command automatically inserts the
436<code>android:debuggable="true"</code> attribute, while <code>ant release</code>
437does not. If <code>android:debuggable="true"</code> is manually set, then
438<code>ant release</code> will actually do a debug build, rather than a release
439build.</li>
440<li>Automatic ProGuard support in release builds. Developers generate a ProGuard
441configuration file using the <code>android</code> tool &mdash; the build tools
442then automatically run ProGuard against the project sources during the build.
443For more information, see the <a
444href="{@docRoot}guide/developing/tools/proguard.html">ProGuard</a>
445documentation. </li>
446<li>New overridable Ant javac properties: <code>java.encoding</code>,
447<code>java.source</code>, and <code>java.target</code> (default values are
448"ascii", "1.5", and "1.5", respectively).</li>
449<li>New UI for the HierarchyViewer tool.</li>
450</ul>
451</dd>
452</dl>
453 </div>
454</div>
455
456<div class="toggleable closed">
457 <a href="#" onclick="return toggleDiv(this)">
458 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px" width="9px" />
Dirk Dougherty022171b2010-07-30 19:24:17 -0700459SDK Tools, Revision 7</a> <em>(September 2010)</em>
460 <div class="toggleme">
461
462<dl>
463<dt>Dependencies:</dt>
464<dd>
465<p>If you are developing in Eclipse with ADT, note that SDK Tools r7 is
466designed for use with ADT 0.9.8 and later. After installing SDK Tools r7, we
467highly recommend updating your ADT Plugin to 0.9.8.</p>
468</dd>
469
470<dt>General notes:</dt>
471<dd>
472<ul>
473<li>Added support for library projects that depend on other library projects.</li>
474<li>Adds support for aidl files in library projects.</li>
475<li>Adds support for extension targets in Ant build to perform tasks between the
476normal tasks: <code>-pre-build</code>, <code>-pre-compile</code>, and
477<code>-post-compile</code>.</li>
478<li>Adds support for "headless" SDK update. See <code>android -h update sdk</code>
479for more information.</li>
480<li>Fixes location control in DDMS to work in any locale not using '.' as a
481decimal point.</li>
Joe Fernandez890f7ea2011-11-28 17:00:27 -0800482</ul>
Dirk Dougherty022171b2010-07-30 19:24:17 -0700483</ul>
484</dd>
485</dl>
486 </div>
487</div>
488
489<div class="toggleable closed">
490 <a href="#" onclick="return toggleDiv(this)">
491 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px" width="9px" />
Dirk Dougherty0d1b0812010-04-07 17:05:16 -0700492SDK Tools, Revision 6</a> <em>(May 2010)</em>
493 <div class="toggleme">
494
495<dl>
496<dt>Dependencies:</dt>
497<dd>
498<p>If you are developing in Eclipse with ADT, note that SDK Tools r6 is
499designed for use with ADT 0.9.7 and later. After installing SDK Tools r6, we
500highly recommend updating your ADT Plugin to 0.9.7.</p>
501</dd>
502
503<dt>Library projects:</dt>
504<dd>
505<p>The SDK Tools now support the use of <em>library projects</em> during
506development, a capability that lets you store shared Android application
507code and resources in a separate development project. You can then reference the
508library project from other Android projects and, at build time, the tools
509compile the shared code and resources as part of the dependent applications.
510More information about this feature is available in the <a
Robert Lyc74a69a82011-01-04 22:48:02 -0800511href="{@docRoot}guide/developing/projects/index.html#LibraryProjects">Creating and Managing Projects</a> document.</p>
512<p>If you are developing in Eclipse, <a href="eclipse-adt.html">ADT</a>
Dirk Dougherty0d1b0812010-04-07 17:05:16 -0700513provides the equivalent library project support.</p>
514</dd>
515</dl>
516 </div>
517</div>
518
519<div class="toggleable closed">
520 <a href="#" onclick="return toggleDiv(this)">
Dirk Dougherty74a74d32010-09-09 18:40:13 -0700521 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px" width="9px" />
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700522SDK Tools, Revision 5</a> <em>(March 2010)</em>
523 <div class="toggleme">
Dirk Doughertybca9f1b2009-11-18 23:06:16 -0800524
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700525<dl>
526<dt>Dependencies:</dt>
527<dd><ul>
528<li>If you are developing in Eclipse with ADT, note that SDK Tools r5 is
529designed for use with ADT 0.9.6 and later. After installing SDK Tools r5, we
530highly recommend updating your ADT Plugin to 0.9.6.</li>
531<li>For Mac OS platforms, OS X 10.4.x (Tiger) is no longer
532officially supported. </li>
533</ul>
534</dd>
535
536<dt>SDK and AVD Manager:</dt>
537<dd>
538<ul>
539<li>Fixes SSL download for the standalone version of the SDK Updater.</li>
540<li>Fixes issue with 64-bit JVM on Windows.</li>
541<li>Adds support for platform samples components.</li>
542<li>Improves support for dependency between components.</li>
543<li>AVDs now sorted by API level.</li>
544<li>The AVD creation dialog now enforces a minimum SD card size of 9MB.</li>
545<li>Prevents deletion of running AVDs.</li>
546<li>Settings are now automatically saved, no need to click "Apply".</li>
547</ul>
548</dd>
549
550<dt>Emulator:</dt>
551<dd>
552<ul>
553<li>Emulator now requires SD card to be 9MB or more.</li>
554</ul>
555</dd>
556
557<dt>Layoutopt:</dt>
558<dd>
559<ul>
560<li>Fixes <code>layoutopt.bat</code> to execute correctly on Windows.</li>
561</ul>
562</dd>
563</dl>
564 </div>
565</div>
566
567<div class="toggleable closed">
568 <a href="#" onclick="return toggleDiv(this)">
569 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px" width="9px" />
570SDK Tools, Revision 4</a> <em>(December 2009)</em>
571 <div class="toggleme">
572
573<dl>
574<dt>Dependencies:</dt>
575<dd><p>SDK Tools r4 is compatible with ADT 0.9.5 and later, but not
Dirk Doughertybca9f1b2009-11-18 23:06:16 -0800576compatible with earlier versions. If you are developing in Eclipse with ADT, you
577<strong>must</strong> update your ADT plugin to version 0.9.5 or higher if you
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700578install SDK Tools r4 in your SDK. </p></dd>
Dirk Doughertybca9f1b2009-11-18 23:06:16 -0800579
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700580<dt>General notes:</dt>
581<dd>
Dirk Doughertybca9f1b2009-11-18 23:06:16 -0800582<ul>
Robert Lydec97362011-09-22 10:33:28 -0700583<li>Launcher script now forces GDK_NATIVE_WINDOW=true (linux only), to fix a
Dirk Doughertybca9f1b2009-11-18 23:06:16 -0800584compatibility issue between GTK and SWT.</li>
585</ul>
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700586</dd>
Dirk Doughertybca9f1b2009-11-18 23:06:16 -0800587
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700588<dt>Android SDK and AVD Manager:</dt>
589<dd>
Dirk Doughertybca9f1b2009-11-18 23:06:16 -0800590<ul>
591<li>AVD Launch dialog now shows scale value.</li>
Robert Lydec97362011-09-22 10:33:28 -0700592<li>Fixes potential NPE in SDK Manager on AVD launch, for older AVD with no
Dirk Doughertybca9f1b2009-11-18 23:06:16 -0800593skin name specified.</li>
594<li>Fixes XML validation issue in on older Java versions.</li>
595<li>No longer forces the use of Java 1.5 on Mac OS X.</li>
596</ul>
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700597</dd>
Dirk Doughertybca9f1b2009-11-18 23:06:16 -0800598
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700599<dt>Emulator:</dt>
600<dd>
Dirk Doughertybca9f1b2009-11-18 23:06:16 -0800601<ul>
602<li>No longer limits the size of the system partition.</li>
603</ul>
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700604</dd>
Dirk Doughertybca9f1b2009-11-18 23:06:16 -0800605
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700606<dt>Ant build tools:</dt>
607<dd>
Dirk Doughertybca9f1b2009-11-18 23:06:16 -0800608<ul>
609<li>.apk packaging now properly ignores vi swap files as well as hidden files.</li>
610</ul>
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700611</dd>
612</dl>
613 </div>
614</div>
Dirk Doughertybca9f1b2009-11-18 23:06:16 -0800615
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700616<div class="toggleable closed">
617 <a href="#" onclick="return toggleDiv(this)">
618 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px" width="9px" />
619SDK Tools, Revision 3</a> <em>(October 2009)</em>
620 <div class="toggleme">
Dirk Doughertyee58d1b2009-10-16 15:25:15 -0700621
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700622<dl>
623<dt>Dependencies:</dt>
624<dd><p>SDK Tools r3 is compatible with ADT 0.9.4 and later, but not
Dirk Doughertyee58d1b2009-10-16 15:25:15 -0700625compatible with earlier versions. If you are developing in Eclipse with ADT, you
626<strong>must</strong> update your ADT plugin to version 0.9.4 or higher if you
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700627install SDK Tools r3 in your SDK.</p>
628</dd>
Dirk Doughertyee58d1b2009-10-16 15:25:15 -0700629
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700630<dt>Android tool:</dt>
631<dd>
Dirk Doughertyee58d1b2009-10-16 15:25:15 -0700632<ul>
633<li>Adds new <code>android create test-project</code> and <code>android update
634test-project</code> commands to allow for greater flexibility in the location of the
635main and test projects.</li>
636</ul>
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700637</dd>
Dirk Doughertyee58d1b2009-10-16 15:25:15 -0700638
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700639<dt>DDMS:</dt>
640<dd>
Dirk Doughertyee58d1b2009-10-16 15:25:15 -0700641<ul>
Scott Main19f72012011-05-05 18:27:49 -0700642<li>Adds a button to dump HPROF file for running applications (app must be able
Dirk Doughertyee58d1b2009-10-16 15:25:15 -0700643to write to the sdcard).</li>
644<li>Button to start/stop profiling of a running application (app must be able to
645write to the sdcard). Upon stop, Traceview will automatically be launched to
646display the trace.</li>
647<li>Fixed DDMS, Traceview, and the AVD Mananger/SDK Updater to run on Mac OS X
64810.6.</li>
649<li>Fixed screenshot support for devices running 32-bit framebuffer.</li>
650</ul>
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700651</dd>
Dirk Doughertyee58d1b2009-10-16 15:25:15 -0700652
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700653<dt>Android SDK and AVD Manager:</dt>
654<dd>
Dirk Doughertyee58d1b2009-10-16 15:25:15 -0700655<ul>
656<li>Provides a new UI that lets you set options for controlling
Robert Lydec97362011-09-22 10:33:28 -0700657the emulator skin, screen size/density, and scale factor used when launching
Dirk Doughertyee58d1b2009-10-16 15:25:15 -0700658an AVD.</li>
659<li>Provides improved AVD creation UI, which lets you customize the hardware
660properties of your AVDs.</li>
661<li>Now enforces dependencies between platforms and tools components, and
662between SDK add-ons and platforms.</li>
663</ul>
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700664</dd>
Dirk Doughertyee58d1b2009-10-16 15:25:15 -0700665
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700666<dt>Layoutopt, a new tool for optimizing layouts:</dt>
Dirk Doughertyee58d1b2009-10-16 15:25:15 -0700667
Robert Lydec97362011-09-22 10:33:28 -0700668<dd><p>The SDK Tools r3 package includes <code>layoutopt</code>, a new command-line
669tool that helps you optimize your layout hierarchies. When run against your
670layout files, the tool analyzes their hierarchies and notifies you of
671inefficiencies and other potential issues. The tool also provides simple
672solutions for the issues it finds. For usage, see <a
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700673href="/guide/developing/tools/layoutopt.html">layoutopt</a>.</p>
674</dd>
675</dl>
676 </div>
677</div>