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