blob: 91bcb7d2c33e726e0b22d7a9e90f0cc3c93ddf0b [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>
Joe Fernandeze4f20312011-12-15 13:23:53 -080095 <li>Added Lint tools to detect common errors in Android projects.
96 (<a href="http://tools.android.com/recent/lint">more info</a>)</li>
Joe Fernandez71d5c1d2011-12-15 22:33:41 -080097 <li>Added sensor emulation support, which allows the emulator to read sensor data from a
Joe Fernandeze4f20312011-12-15 13:23:53 -080098 physical Android device.
99 (<a href="http://tools.android.com/recent/sensoremulation">more info</a>)</li>
Joe Fernandez890f7ea2011-11-28 17:00:27 -0800100 <li>Added support for using a webcam to emulate a camera on Mac OS X.</li>
101 </ul>
102</dd>
103<dt>Bug fixes:</dt>
104<dd>
105 <ul>
106 <li>Snapshots now work for Android 4.0 system images.</li>
107 <li>Fixed several small issues for the build file.
108 (<a href="http://code.google.com/p/android/issues/detail?id=21023">Issue 21023</a>,
109 <a href="http://code.google.com/p/android/issues/detail?id=21267">Issue 21267</a>,
110 <a href="http://code.google.com/p/android/issues/detail?id=21465">Issue 21465</a>,
111 <a href="http://code.google.com/p/android/issues/detail?id=21525">Issue 21525</a>).</li>
112 </ul>
113</dd>
114</dl>
115</div>
116</div>
117
118<div class="toggleable closed">
119 <a href="#" onclick="return toggleDiv(this)">
120 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px"
121 width="9px" />
122 SDK Tools, Revision 15</a> <em>(October 2011)</em>
Robert Ly490463f2011-10-24 11:06:36 -0700123
124 <div class="toggleme">
125 <p class="caution"><strong>Important:</strong> To download the new Android
126 4.0 system components from the Android SDK Manager, you must first update the
127 SDK tools to revision 14 or later and restart the Android SDK Manager. If you do not,
128 the Android 4.0 system components will not be available for download.</p>
129 <dl>
130<dt>Dependencies:</dt>
131<dd>
132 <ul><li>Android SDK Platform-tools revision 9 or later.</li>
133 <li>If you are developing in Eclipse with ADT, note that the SDK Tools r15 is designed for use
134 with ADT 15.0.0 and later. If you haven't already, we highly recommend updating your <a
135 href="{@docRoot}sdk/eclipse-adt.html">ADT Plugin</a> to 15.0.0.</li>
136 <li>If you are developing outside Eclipse, you must have <a href="http://ant.apache.org/">Apache
137 Ant</a> 1.8 or later.</li>
138</ul>
139
140<dt>Bug fixes:</dt>
141<dd>
142 <ul>
143 <li>Fixed emulator crash on Linux due to improper webcam detection
144 (<a href="http://code.google.com/p/android/issues/detail?id=20952">Issue 20952</a>).</li>
145 <li>Fixed emulator issue when using the <code>-wipe-data</code> argument.</li>
146 <li>Fixed build issue when using Renderscript in projects that target API levels 11-13
147 (<a href="http://code.google.com/p/android/issues/detail?id=21006">Issue 21006</a>).</li>
148 <li>Fixed issue when creating an AVD using the GoogleTV addon
149 (<a href="http://code.google.com/p/android/issues/detail?id=20963">Issue 20963</a>).</li>
150 <li>Fixed <code>ant test</code>
151 (<a href="http://code.google.com/p/android/issues/detail?id=20979">Issue 20979</a>).</li>
152 <li>Fixed <code>android update project</code>
153 (<a href="http://code.google.com/p/android/issues/detail?id=20535">Issue 20535</a>).</li>
154 <li>Fixed scrolling issue in the new Logcat panel of DDMS.</li>
155 <li>Fixed issue with MonkeyRunner
156 (<a href="http://code.google.com/p/android/issues/detail?id=20964">Issue 20964</a>).</li>
157 <li>Fixed issues in the SDK Manager
158 (<a href="http://code.google.com/p/android/issues/detail?id=20939">Issue 20939</a>,
159 <a href="http://code.google.com/p/android/issues/detail?id=20607">Issue 20607</a>).</li>
160 </ul>
161</dd>
162</dl>
163</div>
164</div>
165
166<div class="toggleable closed">
167 <a href="#" onclick="return toggleDiv(this)">
168 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px"
Joe Fernandez890f7ea2011-11-28 17:00:27 -0800169 width="9px" />
170 SDK Tools, Revision 14</a> <em>(October 2011)</em>
Robert Ly6cf7d9a2011-10-12 15:30:35 -0700171
Robert Ly6c81c302011-10-05 12:59:29 -0700172 <div class="toggleme">
Robert Ly6cf7d9a2011-10-12 15:30:35 -0700173 <p class="note"><strong>Important:</strong> To download the new Android
174 4.0 system components from the Android SDK Manager, you must first update the
175 SDK tools to revision 14 and restart the Android SDK Manager. If you do not,
176 the Android 4.0 system components will not be available for download.</p>
Robert Ly6c81c302011-10-05 12:59:29 -0700177 <dl>
178<dt>Dependencies:</dt>
179<dd>
180 <ul><li>Android SDK Platform-tools revision 8 or later.</li>
181 <li>If you are developing in Eclipse with ADT, note that the SDK Tools r14 is designed for use
182 with ADT 14.0.0 and later. If you haven't already, we highly recommend updating your <a
183 href="{@docRoot}sdk/eclipse-adt.html">ADT Plugin</a> to 14.0.0.</li>
184 <li>If you are developing outside Eclipse, you must have <a href="http://ant.apache.org/">Apache
185 Ant</a> 1.8 or later.</li>
186</ul>
187
188<dt>General notes:</dt>
189<dd>
190 <ul>
Joe Fernandez890f7ea2011-11-28 17:00:27 -0800191 <li>Added webcam support to Android 4.0 or later platforms to emulate rear-facing cameras when
192 one webcam is present, and to emulate both rear-facing and front-facing cameras when two
193 webcams are present. Webcam support is for Windows and Linux only.
Robert Ly6cf7d9a2011-10-12 15:30:35 -0700194 Mac support will come in a later release.</li>
Joe Fernandez890f7ea2011-11-28 17:00:27 -0800195 <li>Changed <code>default.properties</code> to <code>project.properties</code> and
Robert Ly6c81c302011-10-05 12:59:29 -0700196 <code>build.properties</code> to <code>ant.properties</code>. Any existing
197 projects that you build with Ant must be updated with the <code>android update project</code>
198 command.</li>
199 <li>Changed Ant <code>build.xml</code> file to support improvements to the
200 build system and added and modified Ant commands to support these changes. For a list of Ant
201commands, see the
202<a href="{@docRoot}guide/developing/building/building-cmdline.html#AntReference">Ant Command
203Reference</a>.</li>
Joe Fernandez71d5c1d2011-12-15 22:33:41 -0800204 <li>Changed how library projects are built.</li>
Robert Ly6c81c302011-10-05 12:59:29 -0700205 <li>Improved incremental builds, so that resource compilation runs less frequently. Builds no
206 longer run when you edit strings or layouts (unless you add a new <code>id</code>) and no longer
207 run once for each library project.</li>
208 <li>Introduced a "PNG crunch cache" that only runs on modified PNG files, instead of
209 crunching all existing PNG files, all the time.</li>
210 <li>Revamped the SDK Manager UI (<a href="http://tools.android.com/recent/newsdkmanager">more
211info</a>).</li>
212 </ul>
213 <p>For a complete overview of the build system changes and what you need to do to support them,
214see the <a href="http://tools.android.com/recent/buildchangesinrevision14">Android Tools Project
215site</a>.</p>
216</dd>
217</dl>
218</div>
219</div>
220
221<div class="toggleable closed">
222 <a href="#" onclick="return toggleDiv(this)">
223 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px"
224 width="9px" />
Robert Lydec97362011-09-22 10:33:28 -0700225SDK Tools, Revision 13</a> <em>(September 2011)</em>
226 <div class="toggleme">
227 <dl>
228<dt>Dependencies:</dt>
229<dd>
230<p>If you are developing in Eclipse with ADT, note that the SDK Tools r13 is designed for use with
231ADT 12.0.0 and later. If you haven't already, we highly recommend updating your <a
232href="{@docRoot}sdk/eclipse-adt.html">ADT Plugin</a> to 12.0.0.</p>
233
234<p>If you are developing outside Eclipse, you must have <a href="http://ant.apache.org/">Apache
235Ant</a> 1.8 or later.</p>
236
237<dt>General notes:</dt>
238<dd>
239 <ul>
240 <li>Fix compilation issue in Ant (<code>dex</code> step) when paths have spaces.</li>
241 <li>Fix issue in emulator installation when paths have spaces.</li>
242 <li>Fix issue when AVD paths have spaces.</li>
243 <li>Fix rendering issue when using emulator scaling (<a href="http://code.google.com/p/android/issues/detail?id=18299">see more</a>).</li>
244 </ul>
245</dd>
246</dl>
247</div>
248</div>
249
250
251<div class="toggleable closed">
252 <a href="#" onclick="return toggleDiv(this)">
253 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px" width="9px" />
Robert Ly31ee77e2011-07-06 11:16:19 -0700254SDK Tools, Revision 12</a> <em>(July 2011)</em>
Robert Ly205d1c32011-06-28 13:13:14 -0700255 <div class="toggleme">
256 <dl>
257<dt>Dependencies:</dt>
258<dd>
259<p>If you are developing in Eclipse with ADT, note that the SDK Tools r12 is designed for use with
260ADT 12.0.0 and later. If you haven't already, we highly recommend updating your <a
261href="{@docRoot}sdk/eclipse-adt.html">ADT Plugin</a> to 12.0.0.</p>
262
263<p>If you are developing outside Eclipse, you must have <a href="http://ant.apache.org/">Apache
264Ant</a> 1.8 or later.</p>
265
266<dt>General notes:</dt>
267<dd>
268 <ul>
269 <li>The AVD manager and emulator can now use system images
270 compiled for ARM v7 and x86 CPUs.</li>
271 </ul>
272</dd>
273</dl>
274</div>
275</div>
276
277<div class="toggleable closed">
278 <a href="#" onclick="return toggleDiv(this)">
279 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px" width="9px" />
Dirk Doughertyb7c7f152011-03-25 11:54:46 -0700280SDK Tools, Revision 11</a> <em>(May 2011)</em>
Robert Lyccea5d22011-02-11 14:59:36 -0800281 <div class="toggleme">
282 <dl>
283<dt>Dependencies:</dt>
284<dd>
Scott Main19f72012011-05-05 18:27:49 -0700285<p>If you are developing in Eclipse with ADT, note that the SDK Tools r11 is designed for use with
286ADT 10.0.1 and later. If you haven't already, we highly recommend updating your <a
287href="{@docRoot}sdk/eclipse-adt.html">ADT Plugin</a> to 10.0.1.</p>
288
289<p>If you are developing outside Eclipse, you must have <a href="http://ant.apache.org/">Apache
290Ant</a> 1.8 or later.</p>
291
292<dt>General notes:</dt>
293<dd>
294 <ul>
295 <li>Miscellaneous emulator changes to support Android 3.1.</li>
296 </ul>
297</dd>
298</dl>
299</div>
300</div>
301
302
303<div class="toggleable closed">
304 <a href="#" onclick="return toggleDiv(this)">
305 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px"
306width="9px" />
307SDK Tools, Revision 10</a> <em>(February 2011)</em>
308 <div class="toggleme">
309 <dl>
310<dt>Dependencies:</dt>
311<dd>
Robert Lyccea5d22011-02-11 14:59:36 -0800312<p>If you are developing in Eclipse with ADT, note that the SDK Tools r10 is
313designed for use with ADT 10.0.0 and later. After installing SDK Tools r10, we
314highly recommend updating your ADT Plugin to 10.0.0.</p>
315
316<p>If you are developing outside Eclipse, you must have <a href="http://ant.apache.org/">Apache
317Ant</a> 1.8 or later.</p>
318
319<dt>General notes:</dt>
320<dd>
321 <ul>
Scott Main19f72012011-05-05 18:27:49 -0700322 <li>The tools now automatically generate Java Programming Language source files (in the
323<code>gen</code> directory) and
Robert Lyccea5d22011-02-11 14:59:36 -0800324 bytecode (in the <code>res/raw</code> directory) from your native <code>.rs</code> files</li>
325 </ul>
326</dd>
327</dl>
328</div>
329</div>
330
331
332
333<div class="toggleable closed">
334 <a href="#" onclick="return toggleDiv(this)">
335 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px" width="9px" />
Robert Lyedc2aac2011-01-14 16:25:09 -0800336SDK Tools, Revision 9</a> <em>(January 2011)</em>
337 <div class="toggleme">
338 <dl>
339<dt>Dependencies:</dt>
340<dd>
341<p>If you are developing in Eclipse with ADT, note that the SDK Tools r9 is
342designed for use with ADT 9.0.0 and later. After installing SDK Tools r9, we
343highly recommend updating your ADT Plugin to 9.0.0.</p>
344
345<p>If you are developing outside Eclipse, you must have <a href="http://ant.apache.org/">Apache
346Ant</a> 1.8 or later.</p>
347
348<dt>Upgrading to SDK Tools r9:</dt>
349<dd>
350<p>If you are upgrading to SDK Tools r9 from SDK Tools r7 or earlier, the default installed location
351for the <code>adb</code> tool has changed from <code>&lt;<em>SDK</em>&gt;/tools/adb</code> to
352<code>&lt;<em>SDK</em>&gt;/platform-tools/adb</code>. This means that you should
353add the new location to your PATH and modify any custom build scripts to
354reference the new location. Copying the <code>adb</code> executable from the new
355location to the old is not recommended, since subsequent updates to the SDK
356Tools will delete the file.</p>
357</dd>
358
359<dt>General notes:</dt>
360<dd>
361 <ul>
362 <li>The default ProGuard configuration, <code>proguard.cfg</code>, now ignores the following classes:
363 <ul>
364 <li>classes that extend {@link android.preference.Preference}</li>
365 <li>classes that extend {@link android.app.backup.BackupAgentHelper}</li>
366 </ul>
367 </li>
368 <li>Ant lib rules now allow you to override <code>java.encoding</code>, <code>java.source</code>,
369 and <code>java.target</code> properties.</li>
370 <li>The default encoding for the <code>javac</code> Ant task is now UTF-8.</li>
371 <li>The LogCat view in DDMS now properly displays UTF-8 characters.</li>
372 <li>The SDK Manager is more reliable on Windows. For details on the improvements, see the
373 <a href="http://tools.android.com/recent/sdkmanagerfixes">Android Tools Project Site</a>. </li>
Scott Mainf9af3012011-01-27 11:26:29 -0800374 <li>Early look at the new snapshot feature: To improve startup time for the emulator, you can
375enable snapshots for the system state. The emulator will then restore to the state when it last
376closed almost instantly. <strong>Note:</strong> The snapshot feature is still under active
377development and might not always perform as expected.</li>
Robert Lyedc2aac2011-01-14 16:25:09 -0800378 <li>Fixed the missing JAR file error that prevented <code>draw9patch</code> from running.</li>
379 <li>Fixed the Windows launch scripts <code>hierarchyviewer</code> and <code>ddms</code> to support
380 the new location of <code>adb</code>.</li>
Scott Main04f04b22011-01-21 19:11:23 -0800381 <li>Known issues with emulator performance: Because the Android emulator must simulate the ARM
382instruction set architecture on your computer, emulator performance is slow. We're working hard to
383resolve the performance issues and it will improve in future releases.</li>
Robert Lyedc2aac2011-01-14 16:25:09 -0800384 </ul>
385</dd>
386</dl>
387</div>
388</div>
389
390<div class="toggleable closed">
391 <a href="#" onclick="return toggleDiv(this)">
392 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px" width="9px" />
Dirk Dougherty9f7580d2010-10-26 09:29:03 -0700393SDK Tools, Revision 8</a> <em>(December 2010)</em>
394 <div class="toggleme">
395
396<dl>
397<dt>Dependencies:</dt>
398<dd>
399<p>If you are developing in Eclipse with ADT, note that SDK Tools r8 is
400designed for use with ADT 8.0.0 and later. After installing SDK Tools r8, we
401highly recommend updating your ADT Plugin to 8.0.0.</p>
402
Scott Main92b03082010-12-14 17:55:27 -0800403<p>If you are developing outside Eclipse, you must have <a href="http://ant.apache.org/">Apache
404Ant</a> 1.8 or later.</p>
405
Dirk Dougherty9f7580d2010-10-26 09:29:03 -0700406<p>Also note that SDK Tools r8 requires a new SDK component called
407<em>Platform-tools</em>. The new Platform-tools component lets all SDK platforms
408(Android 2.1, Android 2.2, and so on) use the same (latest) version of build
409tools such as <code>adb</code>, <code>aapt</code>, <code>aidl</code>, and
410<code>dx</code>. To download the Platform-tools component, use the Android SDK
411Manager, as described in <a href="adding-components.html">Adding SDK
412Components</a></p>
413
414<dt>Upgrading from SDK Tools r7:</dt>
415<dd>
416<p>If you are upgrading to SDK Tools r8 from an earlier version, note that the
417the default installed location for the <code>adb</code> tool has changed from
418<code>&lt;<em>SDK</em>&gt;/tools/adb</code> to
419<code>&lt;<em>SDK</em>&gt;/platform-tools/adb</code>. This means that you should
420add the new location to your PATH and modify any custom build scripts to
421reference the new location. Copying the <code>adb</code> executable from the new
422location to the old is not recommended, since subsequent updates to the SDK
423Tools will delete the file.</p>
424</dd>
425
426<dt>General notes:</dt>
427<dd>
428<ul>
429<li>All SDK platforms now support Library Projects.</li>
430<li>Support for a true debug build. Developers no longer need to add the
431<code>android:debuggable</code> attribute to the
432<code>&lt;application&gt;</code> tag in the manifest &mdash; the build tools add
433the attribute automatically. In Eclipse/ADT, all incremental builds are assumed
434to be debug builds, so the tools insert <code>android:debuggable="true"</code>.
435When exporting a signed release build, the tools do not add the attribute. In
436Ant, a <code>ant debug</code> command automatically inserts the
437<code>android:debuggable="true"</code> attribute, while <code>ant release</code>
438does not. If <code>android:debuggable="true"</code> is manually set, then
439<code>ant release</code> will actually do a debug build, rather than a release
440build.</li>
441<li>Automatic ProGuard support in release builds. Developers generate a ProGuard
442configuration file using the <code>android</code> tool &mdash; the build tools
443then automatically run ProGuard against the project sources during the build.
444For more information, see the <a
445href="{@docRoot}guide/developing/tools/proguard.html">ProGuard</a>
446documentation. </li>
447<li>New overridable Ant javac properties: <code>java.encoding</code>,
448<code>java.source</code>, and <code>java.target</code> (default values are
449"ascii", "1.5", and "1.5", respectively).</li>
450<li>New UI for the HierarchyViewer tool.</li>
451</ul>
452</dd>
453</dl>
454 </div>
455</div>
456
457<div class="toggleable closed">
458 <a href="#" onclick="return toggleDiv(this)">
459 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px" width="9px" />
Dirk Dougherty022171b2010-07-30 19:24:17 -0700460SDK Tools, Revision 7</a> <em>(September 2010)</em>
461 <div class="toggleme">
462
463<dl>
464<dt>Dependencies:</dt>
465<dd>
466<p>If you are developing in Eclipse with ADT, note that SDK Tools r7 is
467designed for use with ADT 0.9.8 and later. After installing SDK Tools r7, we
468highly recommend updating your ADT Plugin to 0.9.8.</p>
469</dd>
470
471<dt>General notes:</dt>
472<dd>
473<ul>
474<li>Added support for library projects that depend on other library projects.</li>
475<li>Adds support for aidl files in library projects.</li>
476<li>Adds support for extension targets in Ant build to perform tasks between the
477normal tasks: <code>-pre-build</code>, <code>-pre-compile</code>, and
478<code>-post-compile</code>.</li>
479<li>Adds support for "headless" SDK update. See <code>android -h update sdk</code>
480for more information.</li>
481<li>Fixes location control in DDMS to work in any locale not using '.' as a
482decimal point.</li>
Joe Fernandez890f7ea2011-11-28 17:00:27 -0800483</ul>
Dirk Dougherty022171b2010-07-30 19:24:17 -0700484</ul>
485</dd>
486</dl>
487 </div>
488</div>
489
490<div class="toggleable closed">
491 <a href="#" onclick="return toggleDiv(this)">
492 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px" width="9px" />
Dirk Dougherty0d1b0812010-04-07 17:05:16 -0700493SDK Tools, Revision 6</a> <em>(May 2010)</em>
494 <div class="toggleme">
495
496<dl>
497<dt>Dependencies:</dt>
498<dd>
499<p>If you are developing in Eclipse with ADT, note that SDK Tools r6 is
500designed for use with ADT 0.9.7 and later. After installing SDK Tools r6, we
501highly recommend updating your ADT Plugin to 0.9.7.</p>
502</dd>
503
504<dt>Library projects:</dt>
505<dd>
506<p>The SDK Tools now support the use of <em>library projects</em> during
507development, a capability that lets you store shared Android application
508code and resources in a separate development project. You can then reference the
509library project from other Android projects and, at build time, the tools
510compile the shared code and resources as part of the dependent applications.
511More information about this feature is available in the <a
Robert Lyc74a69a82011-01-04 22:48:02 -0800512href="{@docRoot}guide/developing/projects/index.html#LibraryProjects">Creating and Managing Projects</a> document.</p>
513<p>If you are developing in Eclipse, <a href="eclipse-adt.html">ADT</a>
Dirk Dougherty0d1b0812010-04-07 17:05:16 -0700514provides the equivalent library project support.</p>
515</dd>
516</dl>
517 </div>
518</div>
519
520<div class="toggleable closed">
521 <a href="#" onclick="return toggleDiv(this)">
Dirk Dougherty74a74d32010-09-09 18:40:13 -0700522 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px" width="9px" />
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700523SDK Tools, Revision 5</a> <em>(March 2010)</em>
524 <div class="toggleme">
Dirk Doughertybca9f1b2009-11-18 23:06:16 -0800525
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700526<dl>
527<dt>Dependencies:</dt>
528<dd><ul>
529<li>If you are developing in Eclipse with ADT, note that SDK Tools r5 is
530designed for use with ADT 0.9.6 and later. After installing SDK Tools r5, we
531highly recommend updating your ADT Plugin to 0.9.6.</li>
532<li>For Mac OS platforms, OS X 10.4.x (Tiger) is no longer
533officially supported. </li>
534</ul>
535</dd>
536
537<dt>SDK and AVD Manager:</dt>
538<dd>
539<ul>
540<li>Fixes SSL download for the standalone version of the SDK Updater.</li>
541<li>Fixes issue with 64-bit JVM on Windows.</li>
542<li>Adds support for platform samples components.</li>
543<li>Improves support for dependency between components.</li>
544<li>AVDs now sorted by API level.</li>
545<li>The AVD creation dialog now enforces a minimum SD card size of 9MB.</li>
546<li>Prevents deletion of running AVDs.</li>
547<li>Settings are now automatically saved, no need to click "Apply".</li>
548</ul>
549</dd>
550
551<dt>Emulator:</dt>
552<dd>
553<ul>
554<li>Emulator now requires SD card to be 9MB or more.</li>
555</ul>
556</dd>
557
558<dt>Layoutopt:</dt>
559<dd>
560<ul>
561<li>Fixes <code>layoutopt.bat</code> to execute correctly on Windows.</li>
562</ul>
563</dd>
564</dl>
565 </div>
566</div>
567
568<div class="toggleable closed">
569 <a href="#" onclick="return toggleDiv(this)">
570 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px" width="9px" />
571SDK Tools, Revision 4</a> <em>(December 2009)</em>
572 <div class="toggleme">
573
574<dl>
575<dt>Dependencies:</dt>
576<dd><p>SDK Tools r4 is compatible with ADT 0.9.5 and later, but not
Dirk Doughertybca9f1b2009-11-18 23:06:16 -0800577compatible with earlier versions. If you are developing in Eclipse with ADT, you
578<strong>must</strong> update your ADT plugin to version 0.9.5 or higher if you
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700579install SDK Tools r4 in your SDK. </p></dd>
Dirk Doughertybca9f1b2009-11-18 23:06:16 -0800580
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700581<dt>General notes:</dt>
582<dd>
Dirk Doughertybca9f1b2009-11-18 23:06:16 -0800583<ul>
Robert Lydec97362011-09-22 10:33:28 -0700584<li>Launcher script now forces GDK_NATIVE_WINDOW=true (linux only), to fix a
Dirk Doughertybca9f1b2009-11-18 23:06:16 -0800585compatibility issue between GTK and SWT.</li>
586</ul>
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700587</dd>
Dirk Doughertybca9f1b2009-11-18 23:06:16 -0800588
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700589<dt>Android SDK and AVD Manager:</dt>
590<dd>
Dirk Doughertybca9f1b2009-11-18 23:06:16 -0800591<ul>
592<li>AVD Launch dialog now shows scale value.</li>
Robert Lydec97362011-09-22 10:33:28 -0700593<li>Fixes potential NPE in SDK Manager on AVD launch, for older AVD with no
Dirk Doughertybca9f1b2009-11-18 23:06:16 -0800594skin name specified.</li>
595<li>Fixes XML validation issue in on older Java versions.</li>
596<li>No longer forces the use of Java 1.5 on Mac OS X.</li>
597</ul>
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700598</dd>
Dirk Doughertybca9f1b2009-11-18 23:06:16 -0800599
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700600<dt>Emulator:</dt>
601<dd>
Dirk Doughertybca9f1b2009-11-18 23:06:16 -0800602<ul>
603<li>No longer limits the size of the system partition.</li>
604</ul>
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700605</dd>
Dirk Doughertybca9f1b2009-11-18 23:06:16 -0800606
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700607<dt>Ant build tools:</dt>
608<dd>
Dirk Doughertybca9f1b2009-11-18 23:06:16 -0800609<ul>
610<li>.apk packaging now properly ignores vi swap files as well as hidden files.</li>
611</ul>
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700612</dd>
613</dl>
614 </div>
615</div>
Dirk Doughertybca9f1b2009-11-18 23:06:16 -0800616
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700617<div class="toggleable closed">
618 <a href="#" onclick="return toggleDiv(this)">
619 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px" width="9px" />
620SDK Tools, Revision 3</a> <em>(October 2009)</em>
621 <div class="toggleme">
Dirk Doughertyee58d1b2009-10-16 15:25:15 -0700622
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700623<dl>
624<dt>Dependencies:</dt>
625<dd><p>SDK Tools r3 is compatible with ADT 0.9.4 and later, but not
Dirk Doughertyee58d1b2009-10-16 15:25:15 -0700626compatible with earlier versions. If you are developing in Eclipse with ADT, you
627<strong>must</strong> update your ADT plugin to version 0.9.4 or higher if you
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700628install SDK Tools r3 in your SDK.</p>
629</dd>
Dirk Doughertyee58d1b2009-10-16 15:25:15 -0700630
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700631<dt>Android tool:</dt>
632<dd>
Dirk Doughertyee58d1b2009-10-16 15:25:15 -0700633<ul>
634<li>Adds new <code>android create test-project</code> and <code>android update
635test-project</code> commands to allow for greater flexibility in the location of the
636main and test projects.</li>
637</ul>
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700638</dd>
Dirk Doughertyee58d1b2009-10-16 15:25:15 -0700639
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700640<dt>DDMS:</dt>
641<dd>
Dirk Doughertyee58d1b2009-10-16 15:25:15 -0700642<ul>
Scott Main19f72012011-05-05 18:27:49 -0700643<li>Adds a button to dump HPROF file for running applications (app must be able
Dirk Doughertyee58d1b2009-10-16 15:25:15 -0700644to write to the sdcard).</li>
645<li>Button to start/stop profiling of a running application (app must be able to
646write to the sdcard). Upon stop, Traceview will automatically be launched to
647display the trace.</li>
648<li>Fixed DDMS, Traceview, and the AVD Mananger/SDK Updater to run on Mac OS X
64910.6.</li>
650<li>Fixed screenshot support for devices running 32-bit framebuffer.</li>
651</ul>
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700652</dd>
Dirk Doughertyee58d1b2009-10-16 15:25:15 -0700653
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700654<dt>Android SDK and AVD Manager:</dt>
655<dd>
Dirk Doughertyee58d1b2009-10-16 15:25:15 -0700656<ul>
657<li>Provides a new UI that lets you set options for controlling
Robert Lydec97362011-09-22 10:33:28 -0700658the emulator skin, screen size/density, and scale factor used when launching
Dirk Doughertyee58d1b2009-10-16 15:25:15 -0700659an AVD.</li>
660<li>Provides improved AVD creation UI, which lets you customize the hardware
661properties of your AVDs.</li>
662<li>Now enforces dependencies between platforms and tools components, and
663between SDK add-ons and platforms.</li>
664</ul>
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700665</dd>
Dirk Doughertyee58d1b2009-10-16 15:25:15 -0700666
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700667<dt>Layoutopt, a new tool for optimizing layouts:</dt>
Dirk Doughertyee58d1b2009-10-16 15:25:15 -0700668
Robert Lydec97362011-09-22 10:33:28 -0700669<dd><p>The SDK Tools r3 package includes <code>layoutopt</code>, a new command-line
670tool that helps you optimize your layout hierarchies. When run against your
671layout files, the tool analyzes their hierarchies and notifies you of
672inefficiencies and other potential issues. The tool also provides simple
673solutions for the issues it finds. For usage, see <a
Dirk Dougherty7b229ef2010-03-26 17:32:26 -0700674href="/guide/developing/tools/layoutopt.html">layoutopt</a>.</p>
675</dd>
676</dl>
677 </div>
678</div>