1 page.title=SDK Tools 2 excludeFromSuggestions=true 3 @jd:body 4 5 <p>SDK Tools is a downloadable component for the Android SDK. It includes the 6 complete set of development and debugging tools for the Android SDK.</p> 7 8 <p>If you are new to the Android SDK, the <a 9 href="{@docRoot}sdk/index.html">SDK starter package</a> installs the 10 latest revision of the SDK Tools in the <code><sdk>/tools</code> directory.</p> 11 12 <p>If you are already using the SDK and you want to update to the latest version 13 of the SDK Tools, use the <em>Android SDK Manager</em> to get the 14 update, rather than downloading a new SDK starter package. For more information 15 about how to update, see <a 16 href="{@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 22 the SDK Tools, as denoted by revision number. To determine what revision of the SDK 23 Tools 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 26 href="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 >sdk</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 596 with 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 599 unprotected 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 631 single application, including ddms, traceview, hierarchyviewer and Tracer for GLES. (<a 632 href="{@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 634 to capture a slice of system activity, plus additional information tagged from the <strong>Settings 635 > Developer Options > Monitoring: Enable traces</strong> or with specific calls added to your 636 application code.</li> 637 </li> 638 <li>Build System 639 <ul> 640 <li>Added automatic merging of library project manifest files into the including 641 project'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 643 the build system to generate a temporary ProGuard {@code keep-rules} file containing classes that 644 are referenced from XML files (such as custom views) and pass this to ProGuard at shrink time. This 645 can 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 647 default ProGuard configuration file have also been removed.</li> 648 <li>Added two ProGuard configuration files for use in projects: {@code 649 proguard-android-optimize.txt} which enables optimizations and {@code proguard-android.txt} which 650 disables 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 > 659 Options</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 670 projects, including Library Projects and third-party jars.</li> 671 <li>Fixed deployment logic so that applications with embedded tests can now be deployed 672 and 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 690 the <a href="{@docRoot}sdk/exploring.html">Android SDK Manager</a>. Use this tool to 691 download 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 709 acceleration.</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 751 in 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 788 API 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 792 Windows 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 795 install 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, 807 this update fixes the {@code Conversion to Dalvik format failed with error 1} error some users have 808 experienced.</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 812 kept in project and the generic Android flags distributed (and updated) with the tools 813 themselves.</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 819 generate a class called {@code BuildConfig} containing a {@code DEBUG} constant that is 820 automatically set according to your build type. You can check the ({@code BuildConfig.DEBUG}) 821 constant 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 826 custom attributes must use the namespace URI {@code http://schemas.android.com/apk/res-auto} instead 827 of the URI that includes the app package name. This URI is replaced with the app specific one at 828 build time.</li> 829 </ul> 830 </li> 831 <li>Lint 832 <ul> 833 <li>Updated Lint to check Android application code. Lint rules which previously 834 performed pattern based searches in the application code (such as the unused resource check) have 835 been 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 837 the unused resource check properly handle resources declared in a library project and referenced in 838 a 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 841 ignore 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 995 commands, see the 996 <a href="{@docRoot}tools/building/building-cmdline.html#AntReference">Ant Command 997 Reference</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 1005 info</a>).</li> 1006 </ul> 1007 <p>For a complete overview of the build system changes and what you need to do to support them, 1008 see the <a href="http://tools.android.com/recent/buildchangesinrevision14">Android Tools Project 1009 site</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 1026 ADT 12.0.0 and later. If you haven't already, we highly recommend updating your <a 1027 href="{@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 1030 Ant</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 1057 ADT 12.0.0 and later. If you haven't already, we highly recommend updating your <a 1058 href="{@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 1061 Ant</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 1085 ADT 10.0.1 and later. If you haven't already, we highly recommend updating your <a 1086 href="{@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 1089 Ant</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 1113 designed for use with ADT 10.0.0 and later. After installing SDK Tools r10, we 1114 highly 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 1117 Ant</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 1144 designed for use with ADT 9.0.0 and later. After installing SDK Tools r9, we 1145 highly 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 1148 Ant</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 1153 for the <code>adb</code> tool has changed from <code><<em>SDK</em>>/tools/adb</code> to 1154 <code><<em>SDK</em>>/platform-tools/adb</code>. This means that you should 1155 add the new location to your PATH and modify any custom build scripts to 1156 reference the new location. Copying the <code>adb</code> executable from the new 1157 location to the old is not recommended, since subsequent updates to the SDK 1158 Tools 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 1177 enable snapshots for the system state. The emulator will then restore to the state when it last 1178 closed almost instantly. <strong>Note:</strong> The snapshot feature is still under active 1179 development 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 1184 instruction set architecture on your computer, emulator performance is slow. We're working hard to 1185 resolve 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 1203 designed for use with ADT 8.0.0 and later. After installing SDK Tools r8, we 1204 highly 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 1207 Ant</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 1212 tools 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 1214 Manager, as described in <a href="{@docRoot}sdk/exploring.html">Exploring the 1215 SDK</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 1220 the default installed location for the <code>adb</code> tool has changed from 1221 <code><<em>SDK</em>>/tools/adb</code> to 1222 <code><<em>SDK</em>>/platform-tools/adb</code>. This means that you should 1223 add the new location to your PATH and modify any custom build scripts to 1224 reference the new location. Copying the <code>adb</code> executable from the new 1225 location to the old is not recommended, since subsequent updates to the SDK 1226 Tools 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><application></code> tag in the manifest — the build tools add 1236 the attribute automatically. In Eclipse/ADT, all incremental builds are assumed 1237 to be debug builds, so the tools insert <code>android:debuggable="true"</code>. 1238 When exporting a signed release build, the tools do not add the attribute. In 1239 Ant, a <code>ant debug</code> command automatically inserts the 1240 <code>android:debuggable="true"</code> attribute, while <code>ant release</code> 1241 does 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 1243 build.</li> 1244 <li>Automatic ProGuard support in release builds. Developers generate a ProGuard 1245 configuration file using the <code>android</code> tool — the build tools 1246 then automatically run ProGuard against the project sources during the build. 1247 For more information, see the <a 1248 href="{@docRoot}tools/help/proguard.html">ProGuard</a> 1249 documentation. </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 1271 designed for use with ADT 0.9.8 and later. After installing SDK Tools r7, we 1272 highly 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 1281 normal 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> 1284 for more information.</li> 1285 <li>Fixes location control in DDMS to work in any locale not using '.' as a 1286 decimal 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 1305 designed for use with ADT 0.9.7 and later. After installing SDK Tools r6, we 1306 highly 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 1312 development, a capability that lets you store shared Android application 1313 code and resources in a separate development project. You can then reference the 1314 library project from other Android projects and, at build time, the tools 1315 compile the shared code and resources as part of the dependent applications. 1316 More information about this feature is available in the <a 1317 href="{@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> 1319 provides 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 1336 designed for use with ADT 0.9.6 and later. After installing SDK Tools r5, we 1337 highly 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 1339 officially 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 1384 compatible 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 1386 install 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 1392 compatibility 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 1401 skin 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 1434 compatible 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 1436 install 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 1443 test-project</code> commands to allow for greater flexibility in the location of the 1444 main 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 1452 to write to the sdcard).</li> 1453 <li>Button to start/stop profiling of a running application (app must be able to 1454 write to the sdcard). Upon stop, Traceview will automatically be launched to 1455 display the trace.</li> 1456 <li>Fixed DDMS, Traceview, and the AVD Mananger/SDK Updater to run on Mac OS X 1457 10.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 1466 the emulator skin, screen size/density, and scale factor used when launching 1467 an AVD.</li> 1468 <li>Provides improved AVD creation UI, which lets you customize the hardware 1469 properties of your AVDs.</li> 1470 <li>Now enforces dependencies between platforms and tools components, and 1471 between 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 1478 tool that helps you optimize your layout hierarchies. When run against your 1479 layout files, the tool analyzes their hierarchies and notifies you of 1480 inefficiencies and other potential issues. The tool also provides simple 1481 solutions for the issues it finds. For usage, see <a 1482 href="/tools/help/layoutopt.html">layoutopt</a>.</p> 1483 </dd> 1484 </dl> 1485 </div> 1486 </div> 1487
