blob: c60782f52ed8d6a1407793453f7d3825891eb59b [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
5complete set of development and debugging tools for the Android SDK. </p>
Dirk Doughertyee58d1b2009-10-16 15:25:15 -07006
Dirk Dougherty7b229ef2010-03-26 17:32:26 -07007<p>If you are new to the Android SDK, the <a
8href="{@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
12of the SDK Tools, use the <em>Android SDK and AVD Manager</em> to get the
13update, 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
16Components</a>. </p>
Dirk Doughertyee58d1b2009-10-16 15:25:15 -070017
Dirk Dougherty7b229ef2010-03-26 17:32:26 -070018<h2 id="notes">Revisions</h2>
Dirk Doughertybca9f1b2009-11-18 23:06:16 -080019
Dirk Dougherty7b229ef2010-03-26 17:32:26 -070020<p>The sections below provide notes about successive releases of
21the SDK Tools, as denoted by revision number. To determine what revision of the SDK
22Tools you are using, refer to the "Installed Packages" listing in the Android SDK
23and AVD Manager. </p>
Dirk Doughertybca9f1b2009-11-18 23:06:16 -080024
Dirk Dougherty7b229ef2010-03-26 17:32:26 -070025<script type="text/javascript">
26function toggleDiv(link) {
27 var toggleable = $(link).parent();
28 if (toggleable.hasClass("closed")) {
29 //$(".toggleme", toggleable).slideDown("fast");
30 toggleable.removeClass("closed");
31 toggleable.addClass("open");
32 $(".toggle-img", toggleable).attr("title", "hide").attr("src", (toRoot + "assets/images/triangle-opened.png"));
33 } else {
34 //$(".toggleme", toggleable).slideUp("fast");
35 toggleable.removeClass("open");
36 toggleable.addClass("closed");
37 $(".toggle-img", toggleable).attr("title", "show").attr("src", (toRoot + "assets/images/triangle-closed.png"));
38 }
39 return false;
40}
41</script>
42<style>
43.toggleable {
44padding: .25em 1em;
45}
46.toggleme {
47 padding: 1em 1em 0 2em;
48 line-height:1em;
49}
50.toggleable a {
51 text-decoration:none;
52}
53.toggleable.closed .toggleme {
54 display:none;
55}
56#jd-content .toggle-img {
57 margin:0;
58}
59</style>
60<div class="toggleable opened">
61 <a href="#" onclick="return toggleDiv(this)">
62 <img src="{@docRoot}assets/images/triangle-opened.png" class="toggle-img" height="9px" width="9px" />
63SDK Tools, Revision 5</a> <em>(March 2010)</em>
64 <div class="toggleme">
Dirk Doughertybca9f1b2009-11-18 23:06:16 -080065
Dirk Dougherty7b229ef2010-03-26 17:32:26 -070066<dl>
67<dt>Dependencies:</dt>
68<dd><ul>
69<li>If you are developing in Eclipse with ADT, note that SDK Tools r5 is
70designed for use with ADT 0.9.6 and later. After installing SDK Tools r5, we
71highly recommend updating your ADT Plugin to 0.9.6.</li>
72<li>For Mac OS platforms, OS X 10.4.x (Tiger) is no longer
73officially supported. </li>
74</ul>
75</dd>
76
77<dt>SDK and AVD Manager:</dt>
78<dd>
79<ul>
80<li>Fixes SSL download for the standalone version of the SDK Updater.</li>
81<li>Fixes issue with 64-bit JVM on Windows.</li>
82<li>Adds support for platform samples components.</li>
83<li>Improves support for dependency between components.</li>
84<li>AVDs now sorted by API level.</li>
85<li>The AVD creation dialog now enforces a minimum SD card size of 9MB.</li>
86<li>Prevents deletion of running AVDs.</li>
87<li>Settings are now automatically saved, no need to click "Apply".</li>
88</ul>
89</dd>
90
91<dt>Emulator:</dt>
92<dd>
93<ul>
94<li>Emulator now requires SD card to be 9MB or more.</li>
95</ul>
96</dd>
97
98<dt>Layoutopt:</dt>
99<dd>
100<ul>
101<li>Fixes <code>layoutopt.bat</code> to execute correctly on Windows.</li>
102</ul>
103</dd>
104</dl>
105 </div>
106</div>
107
108<div class="toggleable closed">
109 <a href="#" onclick="return toggleDiv(this)">
110 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px" width="9px" />
111SDK Tools, Revision 4</a> <em>(December 2009)</em>
112 <div class="toggleme">
113
114<dl>
115<dt>Dependencies:</dt>
116<dd><p>SDK Tools r4 is compatible with ADT 0.9.5 and later, but not
Dirk Doughertybca9f1b2009-11-18 23:06:16 -0800117compatible with earlier versions. If you are developing in Eclipse with ADT, you
118<strong>must</strong> update your ADT plugin to version 0.9.5 or higher if you
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700119install SDK Tools r4 in your SDK. </p></dd>
Dirk Doughertybca9f1b2009-11-18 23:06:16 -0800120
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700121<dt>General notes:</dt>
122<dd>
Dirk Doughertybca9f1b2009-11-18 23:06:16 -0800123<ul>
124<li>Launcher script now forces GDK_NATIVE_WINDOW=true (linux only), to fix a
125compatibility issue between GTK and SWT.</li>
126</ul>
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700127</dd>
Dirk Doughertybca9f1b2009-11-18 23:06:16 -0800128
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700129<dt>Android SDK and AVD Manager:</dt>
130<dd>
Dirk Doughertybca9f1b2009-11-18 23:06:16 -0800131<ul>
132<li>AVD Launch dialog now shows scale value.</li>
133<li>Fixes potential NPE in SDK Manager on AVD launch, for older AVD with no
134skin name specified.</li>
135<li>Fixes XML validation issue in on older Java versions.</li>
136<li>No longer forces the use of Java 1.5 on Mac OS X.</li>
137</ul>
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700138</dd>
Dirk Doughertybca9f1b2009-11-18 23:06:16 -0800139
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700140<dt>Emulator:</dt>
141<dd>
Dirk Doughertybca9f1b2009-11-18 23:06:16 -0800142<ul>
143<li>No longer limits the size of the system partition.</li>
144</ul>
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700145</dd>
Dirk Doughertybca9f1b2009-11-18 23:06:16 -0800146
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700147<dt>Ant build tools:</dt>
148<dd>
Dirk Doughertybca9f1b2009-11-18 23:06:16 -0800149<ul>
150<li>.apk packaging now properly ignores vi swap files as well as hidden files.</li>
151</ul>
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700152</dd>
153</dl>
154 </div>
155</div>
Dirk Doughertybca9f1b2009-11-18 23:06:16 -0800156
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700157<div class="toggleable closed">
158 <a href="#" onclick="return toggleDiv(this)">
159 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px" width="9px" />
160SDK Tools, Revision 3</a> <em>(October 2009)</em>
161 <div class="toggleme">
Dirk Doughertyee58d1b2009-10-16 15:25:15 -0700162
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700163<dl>
164<dt>Dependencies:</dt>
165<dd><p>SDK Tools r3 is compatible with ADT 0.9.4 and later, but not
Dirk Doughertyee58d1b2009-10-16 15:25:15 -0700166compatible with earlier versions. If you are developing in Eclipse with ADT, you
167<strong>must</strong> update your ADT plugin to version 0.9.4 or higher if you
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700168install SDK Tools r3 in your SDK.</p>
169</dd>
Dirk Doughertyee58d1b2009-10-16 15:25:15 -0700170
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700171<dt>Android tool:</dt>
172<dd>
Dirk Doughertyee58d1b2009-10-16 15:25:15 -0700173<ul>
174<li>Adds new <code>android create test-project</code> and <code>android update
175test-project</code> commands to allow for greater flexibility in the location of the
176main and test projects.</li>
177</ul>
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700178</dd>
Dirk Doughertyee58d1b2009-10-16 15:25:15 -0700179
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700180<dt>DDMS:</dt>
181<dd>
Dirk Doughertyee58d1b2009-10-16 15:25:15 -0700182<ul>
183<li>Adds a button to dump HPROF file for running appplications (app must be able
184to write to the sdcard).</li>
185<li>Button to start/stop profiling of a running application (app must be able to
186write to the sdcard). Upon stop, Traceview will automatically be launched to
187display the trace.</li>
188<li>Fixed DDMS, Traceview, and the AVD Mananger/SDK Updater to run on Mac OS X
18910.6.</li>
190<li>Fixed screenshot support for devices running 32-bit framebuffer.</li>
191</ul>
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700192</dd>
Dirk Doughertyee58d1b2009-10-16 15:25:15 -0700193
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700194<dt>Android SDK and AVD Manager:</dt>
195<dd>
Dirk Doughertyee58d1b2009-10-16 15:25:15 -0700196<ul>
197<li>Provides a new UI that lets you set options for controlling
198the emulator skin, screen size/density, and scale factor used when launching
199an AVD.</li>
200<li>Provides improved AVD creation UI, which lets you customize the hardware
201properties of your AVDs.</li>
202<li>Now enforces dependencies between platforms and tools components, and
203between SDK add-ons and platforms.</li>
204</ul>
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700205</dd>
Dirk Doughertyee58d1b2009-10-16 15:25:15 -0700206
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700207<dt>Layoutopt, a new tool for optimizing layouts:</dt>
Dirk Doughertyee58d1b2009-10-16 15:25:15 -0700208
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700209<dd><p>The SDK Tools r3 package includes <code>layoutopt</code>, a new command-line
Dirk Doughertybf15ce62009-10-23 19:17:12 -0700210tool that helps you optimize your layout hierarchies. When run against your
211layout files, the tool analyzes their hierarchies and notifies you of
212inefficiencies and other potential issues. The tool also provides simple
213solutions for the issues it finds. For usage, see <a
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700214href="/guide/developing/tools/layoutopt.html">layoutopt</a>.</p>
215</dd>
216</dl>
217 </div>
218</div>