• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1page.title=SDK Tools
2excludeFromSuggestions=true
3@jd:body
4
5<p>SDK Tools is a downloadable component for the Android SDK. It includes the
6complete set of development and debugging tools for the Android SDK.</p>
7
8<p>If you are new to the Android SDK, the <a
9href="{@docRoot}sdk/index.html">SDK starter package</a> installs the
10latest revision of the SDK Tools in the <code>&lt;sdk&gt;/tools</code> directory.</p>
11
12<p>If you are already using the SDK and you want to update to the latest version
13of the SDK Tools, use the <em>Android SDK Manager</em> to get the
14update, rather than downloading a new SDK starter package. For more information
15about how to update, see <a
16href="{@docRoot}sdk/exploring.html#UpdatingComponents">Exploring the SDK</a>.</p>
17
18
19<h2 id="notes">Revisions</h2>
20
21<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
23Tools you are using, refer to the "Installed Packages" listing in the Android SDK Manager. </p>
24
25<p>For a summary of all known issues in SDK Tools, see <a
26href="http://tools.android.com/knownissues">http://tools.android.com/knownissues</a>.</p>
27
28
29
30<div class="toggle-content opened">
31  <p><a href="#" onclick="return toggleContent(this)">
32    <img src="{@docRoot}assets/images/triangle-opened.png" class="toggle-content-img"
33      alt=""/>SDK Tools, Revision 22.3</a> <em>(October 2013)</em>
34  </p>
35
36  <div class="toggle-content-toggleme">
37
38    <dl>
39    <dt>Dependencies:</dt>
40    <dd>
41      <ul>
42        <li>Android SDK Platform-tools revision 18 or later.</li>
43        <li>If you are developing in Eclipse with ADT, note that this version of SDK Tools is
44          designed for use with ADT 22.3.0 and later. If you haven't already, update your
45        <a href="{@docRoot}tools/sdk/eclipse-adt.html">ADT Plugin</a> to 22.3.0.</li>
46        <li>If you are developing outside Eclipse, you must have
47          <a href="http://ant.apache.org/">Apache Ant</a> 1.8 or later.</li>
48      </ul>
49    </dd>
50
51    <dt>General Notes:</dt>
52    <dd>
53      <ul>
54        <li>Added support for Android 4.4 (API level 19).</li>
55        <li>Fixed a number of minor bugs in the SDK and build system.</li>
56      </ul>
57    </dd>
58    </dl>
59  </div>
60</div>
61
62<div class="toggle-content closed">
63  <p><a href="#" onclick="return toggleContent(this)">
64    <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img"
65      alt=""/>SDK Tools, Revision 22.2.1</a> <em>(September 2013)</em>
66  </p>
67
68  <div class="toggle-content-toggleme">
69
70    <dl>
71    <dt>Dependencies:</dt>
72    <dd>
73      <ul>
74        <li>Android SDK Platform-tools revision 16 or later.</li>
75        <li>If you are developing in Eclipse with ADT, note that this version of SDK Tools is
76          designed for use with ADT 22.2.1 and later. If you haven't already, update your
77        <a href="{@docRoot}tools/sdk/eclipse-adt.html">ADT Plugin</a> to 22.2.1.</li>
78        <li>If you are developing outside Eclipse, you must have
79          <a href="http://ant.apache.org/">Apache Ant</a> 1.8 or later.</li>
80      </ul>
81    </dd>
82
83    <dt>General Notes:</dt>
84    <dd>
85      <ul>
86        <li>Fixed problem with templates that causes the new project wizard to hang.
87         (<a href="http://b.android.com/60149">Issue 60149</a>)</li>
88        <li>Fixed crash when using the lint command line tool because of mis-matched library
89          dependency. (<a href="http://b.android.com/60190">Issue 60190</a>)</li>
90      </ul>
91    </dd>
92    </dl>
93  </div>
94</div>
95
96<div class="toggle-content closed">
97  <p><a href="#" onclick="return toggleContent(this)">
98    <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img"
99      alt=""/>SDK Tools, Revision 22.2</a> <em>(September 2013)</em>
100  </p>
101
102  <div class="toggle-content-toggleme">
103
104    <dl>
105    <dt>Dependencies:</dt>
106    <dd>
107      <ul>
108        <li>Android SDK Platform-tools revision 16 or later.</li>
109        <li>If you are developing in Eclipse with ADT, note that this version of SDK Tools is
110          designed for use with ADT 22.2 and later. If you haven't already, update your
111        <a href="{@docRoot}tools/sdk/eclipse-adt.html">ADT Plugin</a> to 22.2.</li>
112        <li>If you are developing outside Eclipse, you must have
113          <a href="http://ant.apache.org/">Apache Ant</a> 1.8 or later.</li>
114      </ul>
115    </dd>
116
117    <dt>General Notes:</dt>
118    <dd>
119      <ul>
120        <li>Updated build tools to allow use of RenderScript on older versions of Android
121         using new features in the
122         <a href="{@docRoot}tools/support-library/features.html#v8">Support Library</a>.</li>
123        <li>Moved the Systrace tool to the {@code &gt;sdk&lt;/platform-tools/} directory. </li>
124        <li>Modified <a href="{@docRoot}tools/help/gltracer.html">Tracer for OpenGL ES</a> to
125          support OpenGL ES 3.0.</li>
126        <li>Lint
127          <ul>
128            <li>Fixed problem with lint not detecting custom namespaces.
129              (<a href="http://b.android.com/55673">Issue 55673</a>)</li>
130            <li>Fixed problem with the XML report including invalid characters.
131              (<a href="http://b.android.com/56205">Issue 56205</a>)</li>
132            <li>Fixed command-line execution of lint to work in headless mode to support execution
133              by build servers. (<a href="http://b.android.com/55820">Issue 55820</a>)</li>
134          </ul>
135        </li>
136        <li>Improved support for path names with spaces in the Windows command-line tools.</li>
137      </ul>
138    </dd>
139    </dl>
140  </div>
141</div>
142
143
144<div class="toggle-content closed">
145  <p><a href="#" onclick="return toggleContent(this)">
146    <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img"
147      alt=""/>SDK Tools, Revision 22.0.5</a> <em>(July 2013)</em>
148  </p>
149
150  <div class="toggle-content-toggleme">
151
152    <dl>
153    <dt>Dependencies:</dt>
154    <dd>
155      <ul>
156        <li>Android SDK Platform-tools revision 16 or later.</li>
157        <li>If you are developing in Eclipse with the
158          <a href="{@docRoot}tools/sdk/eclipse-adt.html">ADT Plugin</a>, note that this version of
159          SDK Tools is designed for use with ADT 22.0.5 and later. If you haven't already, update
160          ADT to 22.0.5.</li>
161        <li>If you are using <a href="{@docRoot}sdk/installing/studio.html">Android Studio</a>,
162          note that this version of the SDK Tools is designed to work with Android Studio
163          0.2.x and later.</li>
164        <li>If you are developing without an integrated development environment (IDE), you must have
165          <a href="http://ant.apache.org/">Apache Ant</a> 1.8 or later.</li>
166      </ul>
167    </dd>
168
169    <dt>General Notes:</dt>
170    <dd>
171      <ul>
172        <li>Fixed RenderScript compilation issue for Windows platforms with ant.</li>
173        <li>Updated <a href="{@docRoot}tools/help/systrace.html">Systrace</a> to work with the
174          Android 4.3 platform image.</li>
175        <li>Fixed packaging of RenderScript compiler.</li>
176        <li>Build tools 18.0.0 is obsolete and 18.0.1 should be used instead.</li>
177      </ul>
178    </dd>
179    </dl>
180  </div>
181</div>
182
183
184<div class="toggle-content closed">
185  <p><a href="#" onclick="return toggleContent(this)">
186    <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img"
187      alt=""/>SDK Tools, Revision 22.0.4</a> <em>(July 2013)</em>
188  </p>
189
190  <div class="toggle-content-toggleme">
191
192    <dl>
193    <dt>Dependencies:</dt>
194    <dd>
195      <ul>
196        <li>Android SDK Platform-tools revision 16 or later.</li>
197        <li>If you are developing in Eclipse with the
198          <a href="{@docRoot}tools/sdk/eclipse-adt.html">ADT Plugin</a>, note that this version of
199          SDK Tools is designed for use with ADT 22.0.4 and later. If you haven't already, update
200          ADT to 22.0.4.</li>
201        <li>If you are using <a href="{@docRoot}sdk/installing/studio.html">Android Studio</a>,
202          note that this version of the SDK Tools is designed to work with Android Studio
203          0.2.x and later.</li>
204        <li>If you are developing without an integrated development environment (IDE), you must have
205          <a href="http://ant.apache.org/">Apache Ant</a> 1.8 or later.</li>
206      </ul>
207    </dd>
208
209    <dt>General Notes:</dt>
210    <dd>
211      <ul>
212        <li>Fixed problem with compiling RenderScript code.</li>
213      </ul>
214    </dd>
215    </dl>
216  </div>
217</div>
218
219
220<div class="toggle-content closed">
221  <p><a href="#" onclick="return toggleContent(this)">
222    <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img"
223      alt=""/>SDK Tools, Revision 22.0.1</a> <em>(May 2013)</em>
224  </p>
225
226  <div class="toggle-content-toggleme">
227
228    <dl>
229    <dt>Dependencies:</dt>
230    <dd>
231      <ul>
232        <li>Android SDK Platform-tools revision 16 or later.</li>
233        <li>If you are developing in Eclipse with ADT, note that this version of SDK Tools is
234          designed for use with ADT 22.0.1 and later. If you haven't already, update your
235        <a href="{@docRoot}tools/sdk/eclipse-adt.html">ADT Plugin</a> to 22.0.1.</li>
236        <li>If you are developing outside Eclipse, you must have
237          <a href="http://ant.apache.org/">Apache Ant</a> 1.8 or later.</li>
238      </ul>
239    </dd>
240
241    <dt>General Notes:</dt>
242    <dd>
243      <ul>
244        <li>Fixed issue with Lint ServiceCast check and fully qualified class names.
245          (<a href="http://code.google.com/p/android/issues/detail?id=55403">Issue 55403</a>)</li>
246        <li>Fixed crash issue with Lint ArraySizeDetector check.
247          (<a href="http://code.google.com/p/android/issues/detail?id=54887">Issue 54887</a>)</li>
248        <li>Fixed a problem with the monkeyrunner tool failing to import standard python classes.
249          (<a href="http://code.google.com/p/android/issues/detail?id=55632">Issue 55632</a>)</li>
250        <li>Fixed a problem with DDMS monitor not opening heap and network statistics views due to
251          a class not found exception.
252          (<a href="http://code.google.com/p/android/issues/detail?id=55394">Issue 55394</a>)</li>
253      </ul>
254
255    </dd>
256    </dl>
257  </div>
258</div>
259
260
261<div class="toggle-content closed">
262  <p><a href="#" onclick="return toggleContent(this)">
263    <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img"
264      alt=""/>SDK Tools, Revision 22</a> <em>(May 2013)</em>
265  </p>
266
267  <div class="toggle-content-toggleme">
268
269    <dl>
270    <dt>Dependencies:</dt>
271    <dd>
272      <ul>
273        <li>Android SDK Platform-tools revision 16 or later.</li>
274        <li>If you are developing in Eclipse with ADT, note that this version of SDK Tools is
275          designed for use with ADT 22.0.0 and later. If you haven't already, update your
276        <a href="{@docRoot}tools/sdk/eclipse-adt.html">ADT Plugin</a> to 22.0.0.</li>
277        <li>If you are developing outside Eclipse, you must have
278          <a href="http://ant.apache.org/">Apache Ant</a> 1.8 or later.</li>
279    </ul>
280    </dd>
281
282    <dt>General Notes:</dt>
283    <dd>
284      <ul>
285        <li>Changed the structure of the SDK by adding a new build tool SDK Component, which is
286          based on the existing platform-tools component. This change decouples the build tools
287          versions from the IDE versions, allowing updates to the tools without requiring an
288          IDE update.</li>
289        <li>Updated tools to allow libraries to share the same package name as the applications
290          that use them.</li>
291        <li>Updated {@code draw9patch} tool to allow easier changing of markers.</li>
292        <li>Added new Lint checks, including checks for layout consistency,
293          {@link android.widget.RelativeLayout} siblings, {@link android.os.Parcel} creator,
294          JavaScript interfaces, {@link android.app.Service} casting, quantity strings, manifest
295          typos, orientation tags in layouts, overlapping names for 9-patches and images, and class
296          existence checks.</li>
297        <li>Updated build tools to sign applications using the BouncyCastle library instead of
298          relying on Sun JVM specific APIs.</li>
299        <li>Released some of the Android tools into <a href="http://www.maven.org">Maven
300          Central</a> to assist third-party tool developers. The following tools are available
301          in the repository: {@code manifest-merger}, {@code common/sdk_common}, {@code ddmlib},
302          {@code dvlib}, {@code layoutlib_api}, {@code sdklib}, and {@code lint}.</li>
303      </ul>
304    </dd>
305
306    <dt>Bug fixes:</dt>
307    <dd>
308      <ul>
309        <li>Fixed a number of minor bugs in the SDK and build system.</li>
310    </ul>
311    </dd>
312    </dl>
313  </div>
314</div>
315
316<div class="toggle-content closed">
317  <p><a href="#" onclick="return toggleContent(this)">
318    <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img"
319      alt=""/>SDK Tools, Revision 21.1</a> <em>(February 2013)</em>
320  </p>
321
322  <div class="toggle-content-toggleme">
323
324    <dl>
325    <dt>Dependencies:</dt>
326    <dd>
327      <ul>
328        <li>Android SDK Platform-tools revision 16 or later.</li>
329        <li>If you are developing in Eclipse with ADT, note that this version of SDK Tools is
330          designed for use with ADT 21.1.0 and later. If you haven't already, update your
331        <a href="{@docRoot}tools/sdk/eclipse-adt.html">ADT Plugin</a> to 21.1.0.</li>
332        <li>If you are developing outside Eclipse, you must have
333          <a href="http://ant.apache.org/">Apache Ant</a> 1.8 or later.</li>
334    </ul>
335    </dd>
336
337    <dt>General Notes:</dt>
338    <dd>
339      <ul>
340        <li>Improved error reporting in {@code dx} when dex merging fails in the build
341          system.</li>
342        <li>Added more than 15 new Lint checks, including checks for overriding older APIs, XML
343          resource problems, graphic asset issues and manifest tags.</li>
344        <li>Added new aapt feature to compile resources.</li>
345      </ul>
346    </dd>
347    </dl>
348  </div>
349</div>
350
351<div class="toggle-content closed">
352  <p><a href="#" onclick="return toggleContent(this)">
353    <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img"
354      alt=""/>SDK Tools, Revision 21.0.1</a> <em>(December 2012)</em>
355  </p>
356
357  <div class="toggle-content-toggleme">
358
359    <dl>
360    <dt>Dependencies:</dt>
361    <dd>
362      <ul>
363        <li>Android SDK Platform-tools revision 16 or later.</li>
364        <li>If you are developing in Eclipse with ADT, note that this version of SDK Tools is
365          designed for use with ADT 21.0.1 and later. If you haven't already, update your
366        <a href="{@docRoot}tools/sdk/eclipse-adt.html">ADT Plugin</a> to 21.0.1.</li>
367        <li>If you are developing outside Eclipse, you must have
368          <a href="http://ant.apache.org/">Apache Ant</a> 1.8 or later.</li>
369    </ul>
370    </dd>
371
372    <dt>General Notes:</dt>
373    <dd>
374      <ul>
375        <li>Build
376          <ul>
377            <li>Updated build to detect and handle package name conflicts between an application and
378              the libraries it depends on. Libraries cannot share package names unless all of them
379              share the same package name.
380              (<a href="http://code.google.com/p/android/issues/detail?id=40152">Issue 40152</a>,
381               <a href="http://code.google.com/p/android/issues/detail?id=40273">Issue 40273</a>)
382            </li>
383            <li>Added a flag to disable dex merging to deal with cases where merging could generate
384              a broken dex file. If this happens to your project, add the following setting to your
385              {@code project.properties} file: {@code dex.disable.merger=true} This setting
386              causes the build system to revert to the older, slower dex processing that does not
387              pre-dex libraries.</li>
388          </ul>
389        </li>
390
391        <li>RenderScript
392          <ul>
393            <li>Added support for
394              <a href="{@docRoot}guide/topics/renderscript/compute.html#filterscript">Filterscript</a>
395              compilation.</li>
396            <li>Added new project setting to control the RenderScript compilation target separately
397              from an Android project. Adding the following line to a {@code project.properties}
398              file causes RenderScript code to be compiled for Android API Level 17, while the
399              containing application can target a different (lower) API level:
400              <pre>renderscript.target = 17</pre>
401              Previously, the RenderScript compilation target was tied to the
402              {@code android:minSdkVersion} setting in the manifest.
403              (<a href="http://code.google.com/p/android/issues/detail?id=40487">Issue 40487</a>)
404            </li>
405          </ul>
406        </li>
407
408      </ul>
409    </dd>
410
411
412    <dt>Bug fixes:</dt>
413    <dd>
414      <ul>
415        <li>Lint
416          <ul>
417            <li>Corrected check for {@code 0px} values in style XML elements.
418              (<a href="http://code.google.com/p/android/issues/detail?id=39601">Issue 39601</a>)
419              </li>
420            <li>Fixed incorrect flagging of formatting strings.
421              (<a href="http://code.google.com/p/android/issues/detail?id=39758">Issue 39758</a>)
422              </li>
423            <li>Fixed problem where {@code tools:ignore} directive in the manifest file was ignored
424              by the Lint tool.
425              (<a href="http://code.google.com/p/android/issues/detail?id=40136">Issue 40136</a>)
426              </li>
427            <li>Fixed problem with flagging a wakelock release inside a conditional.
428              (<a href="http://code.google.com/p/android/issues/detail?id=40424">Issue 40424</a>)
429              </li>
430            <li>Fixed incorrect reporting of missing {@code layout_width} and {@code layout_height}
431              XML fields.
432              (<a href="http://code.google.com/p/android/issues/detail?id=38958">Issue 38958</a>)
433              </li>
434            <li>Fixed handling of custom namespace attributes.</li>
435            <li>Added fixes for filtering out library project warnings.</li>
436            <li>Removed warnings about missing classes before a build.</li>
437          </ul>
438        </li>
439
440        <li>Fixed problem with UI Automator Viewer execution script where Android tools directory
441          is not set.</li>
442        <li>Fixed problem with the SDK Manager so that it auto-selects the most recently released
443          platform on startup.</li>
444        <li>Fixed Java finding script to look for the currently supported version of Java (1.6 or
445          higher).</li>
446        <li>Fixed the SDK Manager launcher in the ADT bundle so that it can properly launch the
447          SDK Manager program when it is placed at the root of the bundle.</li>
448      </ul>
449    </dd>
450    </dl>
451  </div>
452</div>
453
454<div class="toggle-content closed">
455  <p><a href="#" onclick="return toggleContent(this)">
456    <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img"
457      alt=""/>SDK Tools, Revision 21</a> <em>(November 2012)</em>
458  </p>
459
460  <div class="toggle-content-toggleme">
461
462    <dl>
463    <dt>Dependencies:</dt>
464    <dd>
465      <ul>
466        <li>Android SDK Platform-tools revision 16 or later.</li>
467        <li>If you are developing in Eclipse with ADT, note that this version of SDK Tools is designed
468        for use with ADT 21.0.0 and later. If you haven't already, update your
469        <a href="{@docRoot}tools/sdk/eclipse-adt.html">ADT Plugin</a> to 21.0.0.</li>
470        <li>If you are developing outside Eclipse, you must have
471          <a href="http://ant.apache.org/">Apache Ant</a> 1.8 or later.</li>
472      </ul>
473    </dd>
474
475    <dt>General Notes:</dt>
476    <dd>
477      <ul>
478        <li>Build System
479          <ul>
480            <li>Added a flag that sets <em>jumbo mode</em> for DEX files, which allows a larger
481              number of strings in the DEX files. Enable this mode by adding the following line to
482              the {@code project.properties} file of your project:
483              <pre>set dex.force.jumbo=true</pre></li>
484            <li>Improved the build time by pre-dexing libraries (both JAR files and library
485              projects).</li>
486            <li>Updated the build to generate {@code R} resource classes for library projects
487              with only the IDs needed by the libraries, reducing the risk of hitting DEX file
488              limits for fields and methods.</li>
489            <li>Improved the build so that several editing features (code completion, resource
490              chooser, go to declaration) properly handle library project resources.</li>
491          </ul>
492        </li>
493        <li>Lint
494          <ul>
495            <li>Added over 25 new lint rules for resources, locale settings, layout
496              files, incorrect use of {@link android.util.SparseArray} and
497              {@link android.os.PowerManager.WakeLock} and manifest issues.</li>
498            <li>Updated reporting to include errors in library projects if the library project is
499              in the list of projects to be checked.</li>
500            <li>Added a new {@code lint} target to the Ant build system for easier
501              integration with continuous build systems.</li>
502            <li>Added new {@code --sources} and {@code --classpath} arguments to point to sources
503              with different directory structures.</li>
504            <li>Improved the XML export function to support the <a
505              href="https://wiki.jenkins-ci.org/display/JENKINS/Android+Lint+Plugin">Jenkins Lint
506              plugin</a>.
507            </li>
508            <li>Added support for class file flow analysis.</li>
509          </ul>
510        </li>
511        <li>Android Virtual Devices (AVD)
512          <ul>
513            <li>Added new <strong>Device Definitions</strong> tab in the AVD Manager for configuring
514              standard size and Nexus virtual devices.</li>
515            <li>Improved emulators so that they launch with a skin that is dynamically generated and
516              reflects the actual hardware configured in the AVD Manager.</li>
517            <li>Improved support for developing Android apps on MIPS-based devices with new MIPS
518              System Images for Android Virtual Devices.</li>
519          </ul>
520        </li>
521        <li>Added {@code jobb} tool for creating and encrypting
522          <a href="{@docRoot}google/play/expansion-files.html">APK Expansion Files</a>.
523          (<a href="{@docRoot}tools/help/jobb.html">more info</a>)
524        <li>Improved the Android JUnit test runner to allow a test to be run on all connected
525          devices simultaneously.</li>
526      </ul>
527    </dd>
528
529    <dt>Bug fixes:</dt>
530    <dd>
531      <ul>
532        <li>Fixed manifest merger to properly adapt library classes in the merged manifest.</li>
533      </ul>
534    </dd>
535
536    </dl>
537  </div>
538</div>
539
540<div class="toggle-content closed">
541  <p><a href="#" onclick="return toggleContent(this)">
542    <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img"
543      alt=""/>SDK Tools, Revision 20.0.3</a> <em>(August 2012)</em>
544  </p>
545
546  <div class="toggle-content-toggleme">
547
548    <dl>
549    <dt>Dependencies:</dt>
550    <dd>
551      <ul>
552        <li>Android SDK Platform-tools revision 12 or later.</li>
553        <li>If you are developing in Eclipse with ADT, note that this version of SDK Tools is designed
554        for use with ADT 20.0.3 and later. If you haven't already, update your
555        <a href="{@docRoot}tools/sdk/eclipse-adt.html">ADT Plugin</a> to 20.0.3.</li>
556        <li>If you are developing outside Eclipse, you must have
557          <a href="http://ant.apache.org/">Apache Ant</a> 1.8 or later.</li>
558    </ul>
559    </dd>
560    <dt>Bug fixes:</dt>
561    <dd>
562      <ul>
563        <li>Fixed problem with cached download lists in SDK Manager.</li>
564      </ul>
565    </dd>
566    </dl>
567  </div>
568</div>
569
570
571<div class="toggle-content closed">
572  <p><a href="#" onclick="return toggleContent(this)">
573    <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img"
574      alt=""/>SDK Tools, Revision 20.0.1</a> <em>(July 2012)</em>
575  </p>
576
577  <div class="toggle-content-toggleme">
578
579    <dl>
580    <dt>Dependencies:</dt>
581    <dd>
582      <ul>
583        <li>Android SDK Platform-tools revision 12 or later.</li>
584        <li>If you are developing in Eclipse with ADT, note that this version of SDK Tools is designed
585        for use with ADT 20.0.1 and later. If you haven't already, update your
586        <a href="{@docRoot}tools/sdk/eclipse-adt.html">ADT Plugin</a> to 20.0.1.</li>
587        <li>If you are developing outside Eclipse, you must have
588          <a href="http://ant.apache.org/">Apache Ant</a> 1.8 or later.</li>
589    </ul>
590    </dd>
591    <dt>Bug fixes:</dt>
592    <dd>
593      <ul>
594        <li>Fixed wrong check on build state that forced repetitive Java code recompilation.</li>
595        <li>Fixed problems with running more than one emulator and running multiple emulators
596with GPU acceleration.</li>
597        <li>Improved resize algorithm for better rendering on scaled emulator windows.</li>
598        <li>Fixed a bug in the {@code lint} check for unprotected broadcast receivers to ignore
599unprotected receivers for default Android actions.</li>
600        <li>Fixed build issue for projects using RenderScript.</li>
601        <li>Fixed memory leak in the emulator.</li>
602      </ul>
603    </dd>
604    </dl>
605  </div>
606</div>
607
608<div class="toggle-content closed">
609  <p><a href="#" onclick="return toggleContent(this)">
610    <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img"
611      alt=""/>SDK Tools, Revision 20</a> <em>(June 2012)</em>
612  </p>
613
614  <div class="toggle-content-toggleme">
615  <dl>
616    <dt>Dependencies:</dt>
617    <dd>
618      <ul>
619        <li>Android SDK Platform-tools revision 12 or later.</li>
620        <li>If you are developing in Eclipse with ADT, note that this version of SDK Tools is designed for
621        use with ADT 20.0.0 and later. If you haven't already, we highly recommend updating your
622        <a href="{@docRoot}tools/sdk/eclipse-adt.html">ADT Plugin</a> to 20.0.0.</li>
623        <li>If you are developing outside Eclipse, you must have
624          <a href="http://ant.apache.org/">Apache Ant</a> 1.8 or later.</li>
625    </ul>
626    </dd>
627    <dt>General notes:</dt>
628    <dd>
629      <ul>
630        <li>Added new Device Monitor application, grouping Android debugging tools into a
631single application, including ddms, traceview, hierarchyviewer and Tracer for GLES. (<a
632href="{@docRoot}tools/help/gltracer.html">more info</a>)</li>
633        <li>Added new System Trace new tool for tracing Android system activity. This tool allow you
634to capture a slice of system activity, plus additional information tagged from the <strong>Settings
635&gt; Developer Options &gt; Monitoring: Enable traces</strong> or with specific calls added to your
636application code.</li>
637        </li>
638        <li>Build System
639          <ul>
640            <li>Added automatic merging of library project manifest files into the including
641project's manifest. Enable this feature with the {@code manifestmerger.enabled} property.</li>
642            <li>Added automatic ProGuard support for the {@code aapt -G} flag. This change causes
643the build system to generate a temporary ProGuard {@code keep-rules} file containing classes that
644are referenced from XML files (such as custom views) and pass this to ProGuard at shrink time. This
645can make the resulting APK much smaller when using just a small portion of a large library project
646(such as the Android Support library), since the catch-all rules to keep all custom views from the
647default ProGuard configuration file have also been removed.</li>
648            <li>Added two ProGuard configuration files for use in projects: {@code
649proguard-android-optimize.txt} which enables optimizations and {@code proguard-android.txt} which
650disables them.</li>
651          </ul>
652        </li>
653        <li>SDK Manager
654          <ul>
655            <li>Improved caching to reduce downloading of repository definitions.</li>
656            <li>Added <strong>Tools > Manage Add-on Sites</strong> option to improve performance by
657            allowing temporary deactivation of third-party sites if they are loading slowly.</li>
658            <li>Added settings for the SDK Manager download cache (<strong>SDK Manager > Tools >
659Options</strong>).</li>
660          </ul>
661        </li>
662      </ul>
663    </dd>
664    <dt>Bug fixes:</dt>
665    <dd>
666      <ul>
667        <li>Build
668          <ul>
669            <li>Fixed problem where test projects did not have access to the full classpath of tested
670projects, including Library Projects and third-party jars.</li>
671            <li>Fixed deployment logic so that applications with embedded tests can now be deployed
672and tested like test applications, including code coverage information.</li>
673            <li>Fixed Ant support for testing projects with libraries.</li>
674          </ul>
675        </li>
676      </ul>
677    </dd>
678    </dl>
679  </div>
680</div>
681
682<div class="toggle-content closed">
683  <p><a href="#" onclick="return toggleContent(this)">
684    <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img"
685      alt=""/>SDK Tools, Revision 19</a> <em>(April 2012)</em>
686  </p>
687
688  <div class="toggle-content-toggleme">
689    <p class="note"><strong>Note:</strong> This update of SDK Tools is only available through
690the <a href="{@docRoot}sdk/exploring.html">Android SDK Manager</a>. Use this tool to
691download and install this update.</p>
692
693    <dl>
694    <dt>Dependencies:</dt>
695    <dd>
696      <ul>
697        <li>Android SDK Platform-tools revision 9 or later.</li>
698        <li>If you are developing in Eclipse with ADT, note that this version of SDK Tools is designed for
699        use with ADT 18.0.0 and later. If you haven't already, we highly recommend updating your
700        <a href="{@docRoot}tools/sdk/eclipse-adt.html">ADT Plugin</a> to 18.0.0.</li>
701        <li>If you are developing outside Eclipse, you must have
702          <a href="http://ant.apache.org/">Apache Ant</a> 1.8 or later.</li>
703    </ul>
704    </dd>
705    <dt>Bug fixes:</dt>
706    <dd>
707      <ul>
708        <li>Fixed an issue that prevented some developers from running the emulator with GPU
709acceleration.</li>
710      </ul>
711    </dd>
712    </dl>
713  </div>
714</div>
715
716<div class="toggle-content closed">
717  <p><a href="#" onclick="return toggleContent(this)">
718    <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img"
719      alt=""/>SDK Tools, Revision 18</a> <em>(April 2012)</em>
720  </p>
721
722  <div class="toggle-content-toggleme">
723    <p class="caution"><strong>Important:</strong> To download the new Android
724    4.0 system components from the Android SDK Manager, you must first update the
725    SDK tools to revision 14 or later and restart the Android SDK Manager. If you do not,
726    the Android 4.0 system components will not be available for download.</p>
727
728    <dl>
729    <dt>Dependencies:</dt>
730    <dd>
731      <ul>
732        <li>Android SDK Platform-tools revision 9 or later.</li>
733        <li>If you are developing in Eclipse with ADT, note that this version of SDK Tools is designed for
734        use with ADT 18.0.0 and later. If you haven't already, we highly recommend updating your
735        <a href="{@docRoot}tools/sdk/eclipse-adt.html">ADT Plugin</a> to 18.0.0.</li>
736        <li>If you are developing outside Eclipse, you must have
737          <a href="http://ant.apache.org/">Apache Ant</a> 1.8 or later.</li>
738    </ul>
739    </dd>
740    <dt>General notes:</dt>
741    <dd>
742      <ul>
743        <li>Updated the SdkController app to encapsulate both sensor and multitouch emulation
744          functionality.</li>
745      </ul>
746    </dd>
747    <dt>Bug fixes:</dt>
748    <dd>
749      <ul>
750        <li>Fixed Ant issues where some jar libraries in the {@code libs/} folder are not picked up
751in some cases.</li>
752      </ul>
753    </dd>
754    </dl>
755  </div>
756</div>
757
758<div class="toggle-content closed">
759  <p><a href="#" onclick="return toggleContent(this)">
760    <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img"
761      alt=""/>SDK Tools, Revision 17</a> <em>(March 2012)</em>
762  </p>
763
764  <div class="toggle-content-toggleme">
765    <p class="caution"><strong>Important:</strong> To download the new Android
766    4.0 system components from the Android SDK Manager, you must first update the
767    SDK tools to revision 14 or later and restart the Android SDK Manager. If you do not,
768    the Android 4.0 system components will not be available for download.</p>
769
770    <dl>
771    <dt>Dependencies:</dt>
772    <dd>
773      <ul>
774        <li>Android SDK Platform-tools revision 9 or later.</li>
775        <li>If you are developing in Eclipse with ADT, note that this version of SDK Tools is designed for
776        use with ADT 17.0.0 and later. If you haven't already, we highly recommend updating your
777        <a href="{@docRoot}tools/sdk/eclipse-adt.html">ADT Plugin</a> to 17.0.0.</li>
778        <li>If you are developing outside Eclipse, you must have
779          <a href="http://ant.apache.org/">Apache Ant</a> 1.8 or later.</li>
780    </ul>
781    </dd>
782    <dt>General notes:</dt>
783    <dd>
784      <ul>
785        <li>Emulator
786          <ul>
787            <li>Added support for hardware accelerated graphics rendering. This feature requires an
788API Level 15, Revision 3 or later system image.
789(<a href="{@docRoot}tools/devices/emulator.html#accel-graphics">more info</a>)
790            </li>
791            <li>Added support for running Android x86 system images in virtualization mode on
792Windows and Mac OS X.
793(<a href="{@docRoot}tools/devices/emulator.html#accel-vm">more info</a>)
794              <p class="note"><strong>Note:</strong> Use the Android SDK Manager to download and
795install x86 system images. Android x86 system images are not available for all API levels.</p>
796            </li>
797            <li>Added experimental support for multi-touch input by enabing the emulator to receive
798              touch input from a USB-tethered physical Android device.
799              (<a href="http://tools.android.com/tips/hardware-emulation">more info</a>)</li>
800          </ul>
801        </li>
802        <li>Added viewing of live detailed network usage of an app in DDMS. (<a
803    href="http://tools.android.com/recent/detailednetworkusageinddms">more info</a>)</li>
804        <li>ProGuard
805          <ul>
806            <li>Updated the bundled ProGuard tool to version 4.7. In addition to many new features,
807this update fixes the {@code Conversion to Dalvik format failed with error 1} error some users have
808experienced.</li>
809            <li>Updated the default {@code proguard.cfg} file with better default flags for
810              Android.</li>
811            <li>Split the ProGuard configuration file has been in half, with project specific flags
812kept in project and the generic Android flags distributed (and updated) with the tools
813themselves.</li>
814          </ul>
815        </li>
816        <li>Build
817          <ul>
818            <li>Added a feature that allows you to run some code only in debug mode. Builds now
819generate a class called {@code BuildConfig} containing a {@code DEBUG} constant that is
820automatically set according to your build type. You can check the ({@code BuildConfig.DEBUG})
821constant in your code to run debug-only functions.</li>
822            <li>Fixed issue when a project and its libraries include the same jar file in their libs
823              folder. (<a href="http://tools.android.com/recent/dealingwithdependenciesinandroidprojects">more
824              info</a>)</li>
825            <li>Added support for custom views with custom attributes in libraries. Layouts using
826custom attributes must use the namespace URI {@code http://schemas.android.com/apk/res-auto} instead
827of the URI that includes the app package name. This URI is replaced with the app specific one at
828build time.</li>
829          </ul>
830        </li>
831        <li>Lint
832          <ul>
833            <li>Updated Lint to check Android application code. Lint rules which previously
834performed pattern based searches in the application code (such as the unused resource check) have
835been rewritten to use the more accurate Java-style parse trees.</li>
836            <li>Added support for checking library projects. This change means that rules such as
837the unused resource check properly handle resources declared in a library project and referenced in
838a downstream project.</li>
839            <li>Added ability to suppress Lint warnings in Java code with the new
840{@code @SuppressLint} annotation, and in XML files with the new tools: namespace and
841ignore attribute. (<a
842    href="http://tools.android.com/recent/ignoringlintwarnings">more info</a>)</li>
843            <li>New Lint checks:
844              <ul>
845                <li>Added check for Android API calls that require a version of Android higher than
846                  the minimum supported version. You can use the new {@code @TargetApi} annotation
847                  to suppress warnings when the code is wrapped in a system version condition.
848                  (<a href="http://tools.android.com/recent/lintapicheck">more info</a>)</li>
849                <li>Added over 20 new Lint rules, including checks for
850                  <a href="http://tools.android.com/recent/lintperformancechecks">performance</a>,
851                  XML layouts, manifest and file handling.</li>
852              </ul>
853            </li>
854          </ul>
855        </li>
856      </ul>
857    </dd>
858    </dl>
859  </div>
860</div>
861
862<div class="toggle-content closed">
863  <p><a href="#" onclick="return toggleContent(this)">
864    <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img"
865      alt=""/>SDK Tools, Revision 16</a> <em>(December 2011)</em>
866  </p>
867
868  <div class="toggle-content-toggleme">
869    <p class="caution"><strong>Important:</strong> To download the new Android
870    4.0 system components from the Android SDK Manager, you must first update the
871    SDK tools to revision 14 or later and restart the Android SDK Manager. If you do not,
872    the Android 4.0 system components will not be available for download.</p>
873
874<dl>
875<dt>Dependencies:</dt>
876<dd>
877  <ul>
878    <li>Android SDK Platform-tools revision 9 or later.</li>
879    <li>If you are developing in Eclipse with ADT, note that this version of SDK Tools is designed for use
880    with ADT 16.0.0 and later. If you haven't already, we highly recommend updating your
881    <a href="{@docRoot}tools/sdk/eclipse-adt.html">ADT Plugin</a> to 16.0.0.</li>
882    <li>If you are developing outside Eclipse, you must have <a href="http://ant.apache.org/">Apache
883    Ant</a> 1.8 or later.</li>
884</ul>
885</dd>
886<dt>General notes:</dt>
887<dd>
888  <ul>
889    <li>Added Lint tools to detect common errors in Android projects.
890      (<a href="http://tools.android.com/recent/lint">more info</a>)</li>
891    <li>Added sensor emulation support, which allows the emulator to read sensor data from a
892      physical Android device.
893      (<a href="http://tools.android.com/recent/sensoremulation">more info</a>)</li>
894    <li>Added support for using a webcam to emulate a camera on Mac OS X.</li>
895  </ul>
896</dd>
897<dt>Bug fixes:</dt>
898<dd>
899  <ul>
900    <li>Snapshots now work for Android 4.0 system images.</li>
901    <li>Fixed several small issues for the build file.
902    (<a href="http://code.google.com/p/android/issues/detail?id=21023">Issue 21023</a>,
903    <a href="http://code.google.com/p/android/issues/detail?id=21267">Issue 21267</a>,
904    <a href="http://code.google.com/p/android/issues/detail?id=21465">Issue 21465</a>,
905    <a href="http://code.google.com/p/android/issues/detail?id=21525">Issue 21525</a>).</li>
906  </ul>
907</dd>
908</dl>
909</div>
910</div>
911
912<div class="toggle-content closed">
913  <p><a href="#" onclick="return toggleContent(this)">
914    <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img"
915      alt=""/>SDK Tools, Revision 15</a> <em>(October 2011)</em>
916  </p>
917
918  <div class="toggle-content-toggleme">
919    <p class="caution"><strong>Important:</strong> To download the new Android
920    4.0 system components from the Android SDK Manager, you must first update the
921    SDK tools to revision 14 or later and restart the Android SDK Manager. If you do not,
922    the Android 4.0 system components will not be available for download.</p>
923  <dl>
924<dt>Dependencies:</dt>
925<dd>
926  <ul><li>Android SDK Platform-tools revision 9 or later.</li>
927  <li>If you are developing in Eclipse with ADT, note that this version of SDK Tools is designed for use
928  with ADT 15.0.0 and later. If you haven't already, we highly recommend updating your <a
929  href="{@docRoot}tools/sdk/eclipse-adt.html">ADT Plugin</a> to 15.0.0.</li>
930  <li>If you are developing outside Eclipse, you must have <a href="http://ant.apache.org/">Apache
931  Ant</a> 1.8 or later.</li>
932</ul>
933
934<dt>Bug fixes:</dt>
935<dd>
936  <ul>
937    <li>Fixed emulator crash on Linux due to improper webcam detection
938    (<a href="http://code.google.com/p/android/issues/detail?id=20952">Issue 20952</a>).</li>
939    <li>Fixed emulator issue when using the <code>-wipe-data</code> argument.</li>
940    <li>Fixed build issue when using RenderScript in projects that target API levels 11-13
941    (<a href="http://code.google.com/p/android/issues/detail?id=21006">Issue 21006</a>).</li>
942    <li>Fixed issue when creating an AVD using the GoogleTV addon
943    (<a href="http://code.google.com/p/android/issues/detail?id=20963">Issue 20963</a>).</li>
944    <li>Fixed <code>ant test</code>
945    (<a href="http://code.google.com/p/android/issues/detail?id=20979">Issue 20979</a>).</li>
946    <li>Fixed <code>android update project</code>
947    (<a href="http://code.google.com/p/android/issues/detail?id=20535">Issue 20535</a>).</li>
948    <li>Fixed scrolling issue in the new Logcat panel of DDMS.</li>
949    <li>Fixed issue with MonkeyRunner
950    (<a href="http://code.google.com/p/android/issues/detail?id=20964">Issue 20964</a>).</li>
951    <li>Fixed issues in the SDK Manager
952    (<a href="http://code.google.com/p/android/issues/detail?id=20939">Issue 20939</a>,
953    <a href="http://code.google.com/p/android/issues/detail?id=20607">Issue 20607</a>).</li>
954  </ul>
955</dd>
956</dl>
957</div>
958</div>
959
960<div class="toggle-content closed">
961  <p><a href="#" onclick="return toggleContent(this)">
962    <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img"
963      alt=""/>SDK Tools, Revision 14</a> <em>(October 2011)</em>
964  </p>
965
966  <div class="toggle-content-toggleme">
967    <p class="note"><strong>Important:</strong> To download the new Android
968    4.0 system components from the Android SDK Manager, you must first update the
969    SDK tools to revision 14 and restart the Android SDK Manager. If you do not,
970    the Android 4.0 system components will not be available for download.</p>
971  <dl>
972<dt>Dependencies:</dt>
973<dd>
974  <ul><li>Android SDK Platform-tools revision 8 or later.</li>
975  <li>If you are developing in Eclipse with ADT, note that this version of SDK Tools is designed for use
976  with ADT 14.0.0 and later. If you haven't already, we highly recommend updating your <a
977  href="{@docRoot}tools/sdk/eclipse-adt.html">ADT Plugin</a> to 14.0.0.</li>
978  <li>If you are developing outside Eclipse, you must have <a href="http://ant.apache.org/">Apache
979  Ant</a> 1.8 or later.</li>
980</ul>
981
982<dt>General notes:</dt>
983<dd>
984  <ul>
985    <li>Added webcam support to Android 4.0 or later platforms to emulate rear-facing cameras when
986    one webcam is present, and to emulate both rear-facing and front-facing cameras when two
987    webcams are present. Webcam support is for Windows and Linux only.
988    Mac support will come in a later release.</li>
989    <li>Changed <code>default.properties</code> to <code>project.properties</code> and
990    <code>build.properties</code> to <code>ant.properties</code>. Any existing
991    projects that you build with Ant must be updated with the <code>android update project</code>
992    command.</li>
993    <li>Changed Ant <code>build.xml</code> file to support improvements to the
994    build system and added and modified Ant commands to support these changes. For a list of Ant
995commands, see the
996<a href="{@docRoot}tools/building/building-cmdline.html#AntReference">Ant Command
997Reference</a>.</li>
998    <li>Changed how library projects are built.</li>
999    <li>Improved incremental builds, so that resource compilation runs less frequently. Builds no
1000    longer run when you edit strings or layouts (unless you add a new <code>id</code>) and no longer
1001    run once for each library project.</li>
1002    <li>Introduced a "PNG crunch cache" that only runs on modified PNG files, instead of
1003    crunching all existing PNG files, all the time.</li>
1004    <li>Revamped the SDK Manager UI (<a href="http://tools.android.com/recent/newsdkmanager">more
1005info</a>).</li>
1006  </ul>
1007  <p>For a complete overview of the build system changes and what you need to do to support them,
1008see the <a href="http://tools.android.com/recent/buildchangesinrevision14">Android Tools Project
1009site</a>.</p>
1010</dd>
1011</dl>
1012</div>
1013</div>
1014
1015<div class="toggle-content closed">
1016  <p><a href="#" onclick="return toggleContent(this)">
1017    <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img"
1018      alt=""/>SDK Tools, Revision 13</a> <em>(September 2011)</em>
1019  </p>
1020
1021  <div class="toggle-content-toggleme">
1022  <dl>
1023<dt>Dependencies:</dt>
1024<dd>
1025<p>If you are developing in Eclipse with ADT, note that this version of SDK Tools is designed for use with
1026ADT 12.0.0 and later. If you haven't already, we highly recommend updating your <a
1027href="{@docRoot}tools/sdk/eclipse-adt.html">ADT Plugin</a> to 12.0.0.</p>
1028
1029<p>If you are developing outside Eclipse, you must have <a href="http://ant.apache.org/">Apache
1030Ant</a> 1.8 or later.</p>
1031
1032<dt>General notes:</dt>
1033<dd>
1034  <ul>
1035    <li>Fix compilation issue in Ant (<code>dex</code> step) when paths have spaces.</li>
1036    <li>Fix issue in emulator installation when paths have spaces.</li>
1037    <li>Fix issue when AVD paths have spaces.</li>
1038    <li>Fix rendering issue when using emulator scaling (<a href="http://code.google.com/p/android/issues/detail?id=18299">see more</a>).</li>
1039  </ul>
1040</dd>
1041</dl>
1042</div>
1043</div>
1044
1045
1046<div class="toggle-content closed">
1047  <p><a href="#" onclick="return toggleContent(this)">
1048    <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img"
1049      alt=""/>SDK Tools, Revision 12</a> <em>(July 2011)</em>
1050  </p>
1051
1052  <div class="toggle-content-toggleme">
1053  <dl>
1054<dt>Dependencies:</dt>
1055<dd>
1056<p>If you are developing in Eclipse with ADT, note that this version of SDK Tools is designed for use with
1057ADT 12.0.0 and later. If you haven't already, we highly recommend updating your <a
1058href="{@docRoot}tools/sdk/eclipse-adt.html">ADT Plugin</a> to 12.0.0.</p>
1059
1060<p>If you are developing outside Eclipse, you must have <a href="http://ant.apache.org/">Apache
1061Ant</a> 1.8 or later.</p>
1062
1063<dt>General notes:</dt>
1064<dd>
1065  <ul>
1066    <li>The AVD manager and emulator can now use system images
1067    compiled for ARM v7 and x86 CPUs.</li>
1068  </ul>
1069</dd>
1070</dl>
1071</div>
1072</div>
1073
1074<div class="toggle-content closed">
1075  <p><a href="#" onclick="return toggleContent(this)">
1076    <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img"
1077      alt=""/>SDK Tools, Revision 11</a> <em>(May 2011)</em>
1078  </p>
1079
1080  <div class="toggle-content-toggleme">
1081  <dl>
1082<dt>Dependencies:</dt>
1083<dd>
1084<p>If you are developing in Eclipse with ADT, note that this version of SDK Tools is designed for use with
1085ADT 10.0.1 and later. If you haven't already, we highly recommend updating your <a
1086href="{@docRoot}tools/sdk/eclipse-adt.html">ADT Plugin</a> to 10.0.1.</p>
1087
1088<p>If you are developing outside Eclipse, you must have <a href="http://ant.apache.org/">Apache
1089Ant</a> 1.8 or later.</p>
1090
1091<dt>General notes:</dt>
1092<dd>
1093  <ul>
1094    <li>Miscellaneous emulator changes to support Android 3.1.</li>
1095  </ul>
1096</dd>
1097</dl>
1098</div>
1099</div>
1100
1101
1102<div class="toggle-content closed">
1103  <p><a href="#" onclick="return toggleContent(this)">
1104    <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img"
1105      alt=""/>SDK Tools, Revision 10</a> <em>(February 2011)</em>
1106  </p>
1107
1108  <div class="toggle-content-toggleme">
1109  <dl>
1110<dt>Dependencies:</dt>
1111<dd>
1112<p>If you are developing in Eclipse with ADT, note that this version of SDK Tools is
1113designed for use with ADT 10.0.0 and later. After installing SDK Tools r10, we
1114highly recommend updating your ADT Plugin to 10.0.0.</p>
1115
1116<p>If you are developing outside Eclipse, you must have <a href="http://ant.apache.org/">Apache
1117Ant</a> 1.8 or later.</p>
1118
1119<dt>General notes:</dt>
1120<dd>
1121  <ul>
1122    <li>The tools now automatically generate Java Programming Language source files (in the
1123<code>gen</code> directory) and
1124    bytecode (in the <code>res/raw</code> directory) from your native <code>.rs</code> files</li>
1125  </ul>
1126</dd>
1127</dl>
1128</div>
1129</div>
1130
1131
1132
1133<div class="toggle-content closed">
1134  <p><a href="#" onclick="return toggleContent(this)">
1135    <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img"
1136      alt=""/>SDK Tools, Revision 9</a> <em>(January 2011)</em>
1137  </p>
1138
1139  <div class="toggle-content-toggleme">
1140  <dl>
1141<dt>Dependencies:</dt>
1142<dd>
1143<p>If you are developing in Eclipse with ADT, note that this version of SDK Tools is
1144designed for use with ADT 9.0.0 and later. After installing SDK Tools r9, we
1145highly recommend updating your ADT Plugin to 9.0.0.</p>
1146
1147<p>If you are developing outside Eclipse, you must have <a href="http://ant.apache.org/">Apache
1148Ant</a> 1.8 or later.</p>
1149
1150<dt>Upgrading to SDK Tools r9:</dt>
1151<dd>
1152<p>If you are upgrading to SDK Tools r9 from SDK Tools r7 or earlier, the default installed location
1153for the <code>adb</code> tool has changed from <code>&lt;<em>SDK</em>&gt;/tools/adb</code> to
1154<code>&lt;<em>SDK</em>&gt;/platform-tools/adb</code>. This means that you should
1155add the new location to your PATH and modify any custom build scripts to
1156reference the new location. Copying the <code>adb</code> executable from the new
1157location to the old is not recommended, since subsequent updates to the SDK
1158Tools will delete the file.</p>
1159</dd>
1160
1161<dt>General notes:</dt>
1162<dd>
1163  <ul>
1164    <li>The default ProGuard configuration, <code>proguard.cfg</code>, now ignores the following classes:
1165      <ul>
1166        <li>classes that extend {@link android.preference.Preference}</li>
1167        <li>classes that extend {@link android.app.backup.BackupAgentHelper}</li>
1168      </ul>
1169    </li>
1170    <li>Ant lib rules now allow you to override <code>java.encoding</code>, <code>java.source</code>,
1171    and <code>java.target</code> properties.</li>
1172    <li>The default encoding for the <code>javac</code> Ant task is now UTF-8.</li>
1173    <li>The LogCat view in DDMS now properly displays UTF-8 characters.</li>
1174    <li>The SDK Manager is more reliable on Windows. For details on the improvements, see the
1175    <a href="http://tools.android.com/recent/sdkmanagerfixes">Android Tools Project Site</a>. </li>
1176    <li>Early look at the new snapshot feature: To improve startup time for the emulator, you can
1177enable snapshots for the system state. The emulator will then restore to the state when it last
1178closed almost instantly. <strong>Note:</strong> The snapshot feature is still under active
1179development and might not always perform as expected.</li>
1180    <li>Fixed the missing JAR file error that prevented <code>draw9patch</code> from running.</li>
1181    <li>Fixed the Windows launch scripts <code>hierarchyviewer</code> and <code>ddms</code> to support
1182    the new location of <code>adb</code>.</li>
1183    <li>Known issues with emulator performance: Because the Android emulator must simulate the ARM
1184instruction set architecture on your computer, emulator performance is  slow. We're working hard to
1185resolve the performance issues and it will improve in future releases.</li>
1186  </ul>
1187</dd>
1188</dl>
1189</div>
1190</div>
1191
1192<div class="toggle-content closed">
1193  <p><a href="#" onclick="return toggleContent(this)">
1194    <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img"
1195      alt=""/>SDK Tools, Revision 8</a> <em>(December 2010)</em>
1196  </p>
1197
1198  <div class="toggle-content-toggleme">
1199<dl>
1200<dt>Dependencies:</dt>
1201<dd>
1202<p>If you are developing in Eclipse with ADT, note that this version of SDK Tools is
1203designed for use with ADT 8.0.0 and later. After installing SDK Tools r8, we
1204highly recommend updating your ADT Plugin to 8.0.0.</p>
1205
1206<p>If you are developing outside Eclipse, you must have <a href="http://ant.apache.org/">Apache
1207Ant</a> 1.8 or later.</p>
1208
1209<p>Also note that SDK Tools r8 requires a new SDK component called
1210<em>Platform-tools</em>. The new Platform-tools component lets all SDK platforms
1211(Android 2.1, Android 2.2, and so on) use the same (latest) version of build
1212tools such as <code>adb</code>, <code>aapt</code>, <code>aidl</code>, and
1213<code>dx</code>. To download the Platform-tools component, use the Android SDK
1214Manager, as described in <a href="{@docRoot}sdk/exploring.html">Exploring the
1215SDK</a></p>
1216
1217<dt>Upgrading from SDK Tools r7:</dt>
1218<dd>
1219<p>If you are upgrading to SDK Tools r8 from an earlier version, note that the
1220the default installed location for the <code>adb</code> tool has changed from
1221<code>&lt;<em>SDK</em>&gt;/tools/adb</code> to
1222<code>&lt;<em>SDK</em>&gt;/platform-tools/adb</code>. This means that you should
1223add the new location to your PATH and modify any custom build scripts to
1224reference the new location. Copying the <code>adb</code> executable from the new
1225location to the old is not recommended, since subsequent updates to the SDK
1226Tools will delete the file.</p>
1227</dd>
1228
1229<dt>General notes:</dt>
1230<dd>
1231<ul>
1232<li>All SDK platforms now support Library Projects.</li>
1233<li>Support for a true debug build. Developers no longer need to add the
1234<code>android:debuggable</code> attribute to the
1235<code>&lt;application&gt;</code> tag in the manifest &mdash; the build tools add
1236the attribute automatically. In Eclipse/ADT, all incremental builds are assumed
1237to be debug builds, so the tools insert <code>android:debuggable="true"</code>.
1238When exporting a signed release build, the tools do not add the attribute. In
1239Ant, a <code>ant debug</code> command automatically inserts the
1240<code>android:debuggable="true"</code> attribute, while <code>ant release</code>
1241does not. If <code>android:debuggable="true"</code> is manually set, then
1242<code>ant release</code> will actually do a debug build, rather than a release
1243build.</li>
1244<li>Automatic ProGuard support in release builds. Developers generate a ProGuard
1245configuration file using the <code>android</code> tool &mdash; the build tools
1246then automatically run ProGuard against the project sources during the build.
1247For more information, see the <a
1248href="{@docRoot}tools/help/proguard.html">ProGuard</a>
1249documentation. </li>
1250<li>New overridable Ant javac properties: <code>java.encoding</code>,
1251<code>java.source</code>, and <code>java.target</code> (default values are
1252"ascii", "1.5", and "1.5", respectively).</li>
1253<li>New UI for the HierarchyViewer tool.</li>
1254</ul>
1255</dd>
1256</dl>
1257</div>
1258</div>
1259
1260<div class="toggle-content closed">
1261  <p><a href="#" onclick="return toggleContent(this)">
1262    <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img"
1263      alt=""/>SDK Tools, Revision 7</a> <em>(September 2010)</em>
1264  </p>
1265
1266  <div class="toggle-content-toggleme">
1267<dl>
1268<dt>Dependencies:</dt>
1269<dd>
1270<p>If you are developing in Eclipse with ADT, note that this version of SDK Tools is
1271designed for use with ADT 0.9.8 and later. After installing SDK Tools r7, we
1272highly recommend updating your ADT Plugin to 0.9.8.</p>
1273</dd>
1274
1275<dt>General notes:</dt>
1276<dd>
1277<ul>
1278<li>Added support for library projects that depend on other library projects.</li>
1279<li>Adds support for aidl files in library projects.</li>
1280<li>Adds support for extension targets in Ant build to perform tasks between the
1281normal tasks: <code>-pre-build</code>, <code>-pre-compile</code>, and
1282<code>-post-compile</code>.</li>
1283<li>Adds support for "headless" SDK update. See <code>android -h update sdk</code>
1284for more information.</li>
1285<li>Fixes location control in DDMS to work in any locale not using '.' as a
1286decimal point.</li>
1287</ul>
1288</ul>
1289</dd>
1290</dl>
1291</div>
1292</div>
1293
1294<div class="toggle-content closed">
1295  <p><a href="#" onclick="return toggleContent(this)">
1296    <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img"
1297      alt=""/>SDK Tools, Revision 6</a> <em>(May 2010)</em>
1298  </p>
1299
1300  <div class="toggle-content-toggleme">
1301<dl>
1302<dt>Dependencies:</dt>
1303<dd>
1304<p>If you are developing in Eclipse with ADT, note that this version of SDK Tools is
1305designed for use with ADT 0.9.7 and later. After installing SDK Tools r6, we
1306highly recommend updating your ADT Plugin to 0.9.7.</p>
1307</dd>
1308
1309<dt>Library projects:</dt>
1310<dd>
1311<p>The SDK Tools now support the use of <em>library projects</em> during
1312development, a capability that lets you store shared Android application
1313code and resources in a separate development project. You can then reference the
1314library project from other Android projects and, at build time, the tools
1315compile the shared code and resources as part of the dependent applications.
1316More information about this feature is available in the <a
1317href="{@docRoot}tools/projects/index.html#LibraryProjects">Creating and Managing Projects</a> document.</p>
1318<p>If you are developing in Eclipse, <a href="eclipse-adt.html">ADT</a>
1319provides the equivalent library project support.</p>
1320</dd>
1321</dl>
1322</div>
1323</div>
1324
1325<div class="toggle-content closed">
1326  <p><a href="#" onclick="return toggleContent(this)">
1327    <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img"
1328      alt=""/>SDK Tools, Revision 5</a> <em>(March 2010)</em>
1329  </p>
1330
1331  <div class="toggle-content-toggleme">
1332<dl>
1333<dt>Dependencies:</dt>
1334<dd><ul>
1335<li>If you are developing in Eclipse with ADT, note that this version of SDK Tools is
1336designed for use with ADT 0.9.6 and later. After installing SDK Tools r5, we
1337highly recommend updating your ADT Plugin to 0.9.6.</li>
1338<li>For Mac OS platforms, OS X 10.4.x (Tiger) is no longer
1339officially supported. </li>
1340</ul>
1341</dd>
1342
1343<dt>SDK and AVD Manager:</dt>
1344<dd>
1345<ul>
1346<li>Fixes SSL download for the standalone version of the SDK Updater.</li>
1347<li>Fixes issue with 64-bit JVM on Windows.</li>
1348<li>Adds support for platform samples components.</li>
1349<li>Improves support for dependency between components.</li>
1350<li>AVDs now sorted by API level.</li>
1351<li>The AVD creation dialog now enforces a minimum SD card size of 9MB.</li>
1352<li>Prevents deletion of running AVDs.</li>
1353<li>Settings are now automatically saved, no need to click "Apply".</li>
1354</ul>
1355</dd>
1356
1357<dt>Emulator:</dt>
1358<dd>
1359<ul>
1360<li>Emulator now requires SD card to be 9MB or more.</li>
1361</ul>
1362</dd>
1363
1364<dt>Layoutopt:</dt>
1365<dd>
1366<ul>
1367<li>Fixes <code>layoutopt.bat</code> to execute correctly on Windows.</li>
1368</ul>
1369</dd>
1370</dl>
1371</div>
1372</div>
1373
1374<div class="toggle-content closed">
1375  <p><a href="#" onclick="return toggleContent(this)">
1376    <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img"
1377      alt=""/>SDK Tools, Revision 4</a> <em>(December 2009)</em>
1378  </p>
1379
1380  <div class="toggle-content-toggleme">
1381<dl>
1382<dt>Dependencies:</dt>
1383<dd><p>This version of SDK Tools is compatible with ADT 0.9.5 and later, but not
1384compatible with earlier versions. If you are developing in Eclipse with ADT, you
1385<strong>must</strong> update your ADT plugin to version 0.9.5 or higher if you
1386install SDK Tools r4 in your SDK. </p></dd>
1387
1388<dt>General notes:</dt>
1389<dd>
1390<ul>
1391<li>Launcher script now forces GDK_NATIVE_WINDOW=true (linux only), to fix a
1392compatibility issue between GTK and SWT.</li>
1393</ul>
1394</dd>
1395
1396<dt>Android SDK and AVD Manager:</dt>
1397<dd>
1398<ul>
1399<li>AVD Launch dialog now shows scale value.</li>
1400<li>Fixes potential NPE in SDK Manager on AVD launch, for older AVD with no
1401skin name specified.</li>
1402<li>Fixes XML validation issue in on older Java versions.</li>
1403<li>No longer forces the use of Java 1.5 on Mac OS X.</li>
1404</ul>
1405</dd>
1406
1407<dt>Emulator:</dt>
1408<dd>
1409<ul>
1410<li>No longer limits the size of the system partition.</li>
1411</ul>
1412</dd>
1413
1414<dt>Ant build tools:</dt>
1415<dd>
1416<ul>
1417<li>.apk packaging now properly ignores vi swap files as well as hidden files.</li>
1418</ul>
1419</dd>
1420</dl>
1421</div>
1422</div>
1423
1424<div class="toggle-content closed">
1425  <p><a href="#" onclick="return toggleContent(this)">
1426    <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img"
1427      alt=""/>SDK Tools, Revision 3</a> <em>(October 2009)</em>
1428  </p>
1429
1430  <div class="toggle-content-toggleme">
1431<dl>
1432<dt>Dependencies:</dt>
1433<dd><p>This version of SDK Tools is compatible with ADT 0.9.4 and later, but not
1434compatible with earlier versions. If you are developing in Eclipse with ADT, you
1435<strong>must</strong> update your ADT plugin to version 0.9.4 or higher if you
1436install SDK Tools r3 in your SDK.</p>
1437</dd>
1438
1439<dt>Android tool:</dt>
1440<dd>
1441<ul>
1442<li>Adds new <code>android create test-project</code> and <code>android update
1443test-project</code> commands to allow for greater flexibility in the location of the
1444main and test projects.</li>
1445</ul>
1446</dd>
1447
1448<dt>DDMS:</dt>
1449<dd>
1450<ul>
1451<li>Adds a button to dump HPROF file for running applications (app must be able
1452to write to the sdcard).</li>
1453<li>Button to start/stop profiling of a running application (app must be able to
1454write to the sdcard). Upon stop, Traceview will automatically be launched to
1455display the trace.</li>
1456<li>Fixed DDMS, Traceview, and the AVD Mananger/SDK Updater to run on Mac OS X
145710.6.</li>
1458<li>Fixed screenshot support for devices running 32-bit framebuffer.</li>
1459</ul>
1460</dd>
1461
1462<dt>Android SDK and AVD Manager:</dt>
1463<dd>
1464<ul>
1465<li>Provides a new UI that lets you set options for controlling
1466the emulator skin, screen size/density, and scale factor used when launching
1467an AVD.</li>
1468<li>Provides improved AVD creation UI, which lets you customize the hardware
1469properties of your AVDs.</li>
1470<li>Now enforces dependencies between platforms and tools components, and
1471between SDK add-ons and platforms.</li>
1472</ul>
1473</dd>
1474
1475<dt>Layoutopt, a new tool for optimizing layouts:</dt>
1476
1477<dd><p>The SDK Tools r3 package includes <code>layoutopt</code>, a new command-line
1478tool that helps you optimize your layout hierarchies. When run against your
1479layout files, the tool analyzes their hierarchies and notifies you of
1480inefficiencies and other potential issues. The tool also provides simple
1481solutions for the issues it finds. For usage, see <a
1482href="/tools/help/layoutopt.html">layoutopt</a>.</p>
1483</dd>
1484</dl>
1485</div>
1486</div>
1487