Dirk Dougherty | 7b229ef | 2010-03-26 17:32:26 -0700 | [diff] [blame] | 1 | page.title=SDK Tools |
Dirk Dougherty | ee58d1b | 2009-10-16 15:25:15 -0700 | [diff] [blame] | 2 | @jd:body |
| 3 | |
Dirk Dougherty | 7b229ef | 2010-03-26 17:32:26 -0700 | [diff] [blame] | 4 | <p>SDK Tools is a downloadable component for the Android SDK. It includes the |
Robert Ly | 6c81c30 | 2011-10-05 12:59:29 -0700 | [diff] [blame] | 5 | complete set of development and debugging tools for the Android SDK.</p> |
Dirk Dougherty | ee58d1b | 2009-10-16 15:25:15 -0700 | [diff] [blame] | 6 | |
Robert Ly | dec9736 | 2011-09-22 10:33:28 -0700 | [diff] [blame] | 7 | <p>If you are new to the Android SDK, the <a |
Dirk Dougherty | 7b229ef | 2010-03-26 17:32:26 -0700 | [diff] [blame] | 8 | href="{@docRoot}sdk/index.html">SDK starter package</a> installs the |
| 9 | latest revision of the SDK Tools in the <code><sdk>/tools</code> directory.</p> |
Dirk Dougherty | bf15ce6 | 2009-10-23 19:17:12 -0700 | [diff] [blame] | 10 | |
Dirk Dougherty | 5c2a502 | 2009-12-17 16:59:46 -0800 | [diff] [blame] | 11 | <p>If you are already using the SDK and you want to update to the latest version |
Joe Fernandez | 890f7ea | 2011-11-28 17:00:27 -0800 | [diff] [blame^] | 12 | of the SDK Tools, use the <em>Android SDK Manager</em> to get the |
Dirk Dougherty | 5c2a502 | 2009-12-17 16:59:46 -0800 | [diff] [blame] | 13 | update, rather than downloading a new SDK starter package. For more information |
| 14 | about how to update, see <a |
| 15 | href="{@docRoot}sdk/adding-components.html#UpdatingComponents">Updating SDK |
Robert Ly | 6c81c30 | 2011-10-05 12:59:29 -0700 | [diff] [blame] | 16 | Components</a>.</p> |
Dirk Dougherty | ee58d1b | 2009-10-16 15:25:15 -0700 | [diff] [blame] | 17 | |
Robert Ly | edc2aac | 2011-01-14 16:25:09 -0800 | [diff] [blame] | 18 | |
Dirk Dougherty | 7b229ef | 2010-03-26 17:32:26 -0700 | [diff] [blame] | 19 | <h2 id="notes">Revisions</h2> |
Dirk Dougherty | bca9f1b | 2009-11-18 23:06:16 -0800 | [diff] [blame] | 20 | |
Dirk Dougherty | 7b229ef | 2010-03-26 17:32:26 -0700 | [diff] [blame] | 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 |
Joe Fernandez | 890f7ea | 2011-11-28 17:00:27 -0800 | [diff] [blame^] | 23 | Tools you are using, refer to the "Installed Packages" listing in the Android SDK Manager. </p> |
Dirk Dougherty | bca9f1b | 2009-11-18 23:06:16 -0800 | [diff] [blame] | 24 | |
Scott Main | e0974327 | 2011-10-14 11:25:46 -0700 | [diff] [blame] | 25 | <p>For a summary of all known issues in SDK Tools, see <a |
Scott Main | b321cd9 | 2011-10-20 12:57:43 -0700 | [diff] [blame] | 26 | href="http://tools.android.com/knownissues">http://tools.android.com/knownissues</a>.</p> |
Scott Main | e0974327 | 2011-10-14 11:25:46 -0700 | [diff] [blame] | 27 | |
Dirk Dougherty | 7b229ef | 2010-03-26 17:32:26 -0700 | [diff] [blame] | 28 | <script type="text/javascript"> |
| 29 | function toggleDiv(link) { |
| 30 | var toggleable = $(link).parent(); |
| 31 | if (toggleable.hasClass("closed")) { |
| 32 | //$(".toggleme", toggleable).slideDown("fast"); |
| 33 | toggleable.removeClass("closed"); |
| 34 | toggleable.addClass("open"); |
| 35 | $(".toggle-img", toggleable).attr("title", "hide").attr("src", (toRoot + "assets/images/triangle-opened.png")); |
| 36 | } else { |
| 37 | //$(".toggleme", toggleable).slideUp("fast"); |
| 38 | toggleable.removeClass("open"); |
| 39 | toggleable.addClass("closed"); |
| 40 | $(".toggle-img", toggleable).attr("title", "show").attr("src", (toRoot + "assets/images/triangle-closed.png")); |
| 41 | } |
| 42 | return false; |
| 43 | } |
| 44 | </script> |
| 45 | <style> |
| 46 | .toggleable { |
| 47 | padding: .25em 1em; |
| 48 | } |
| 49 | .toggleme { |
| 50 | padding: 1em 1em 0 2em; |
| 51 | line-height:1em; |
| 52 | } |
| 53 | .toggleable a { |
| 54 | text-decoration:none; |
| 55 | } |
Dirk Dougherty | 0d1b081 | 2010-04-07 17:05:16 -0700 | [diff] [blame] | 56 | .toggleme a { |
| 57 | text-decoration:underline; |
| 58 | } |
Dirk Dougherty | 7b229ef | 2010-03-26 17:32:26 -0700 | [diff] [blame] | 59 | .toggleable.closed .toggleme { |
| 60 | display:none; |
| 61 | } |
| 62 | #jd-content .toggle-img { |
| 63 | margin:0; |
| 64 | } |
| 65 | </style> |
Dirk Dougherty | 0d1b081 | 2010-04-07 17:05:16 -0700 | [diff] [blame] | 66 | |
Robert Ly | 490463f | 2011-10-24 11:06:36 -0700 | [diff] [blame] | 67 | |
Dirk Dougherty | 7b229ef | 2010-03-26 17:32:26 -0700 | [diff] [blame] | 68 | <div class="toggleable opened"> |
| 69 | <a href="#" onclick="return toggleDiv(this)"> |
Robert Ly | 6c81c30 | 2011-10-05 12:59:29 -0700 | [diff] [blame] | 70 | <img src="{@docRoot}assets/images/triangle-opened.png" class="toggle-img" height="9px" |
Joe Fernandez | 890f7ea | 2011-11-28 17:00:27 -0800 | [diff] [blame^] | 71 | width="9px" /> |
| 72 | SDK Tools, Revision 16</a> <em>(December 2011)</em> |
| 73 | |
| 74 | <div class="toggleme"> |
| 75 | <p class="caution"><strong>Important:</strong> To download the new Android |
| 76 | 4.0 system components from the Android SDK Manager, you must first update the |
| 77 | SDK tools to revision 14 or later and restart the Android SDK Manager. If you do not, |
| 78 | the Android 4.0 system components will not be available for download.</p> |
| 79 | |
| 80 | <dl> |
| 81 | <dt>Dependencies:</dt> |
| 82 | <dd> |
| 83 | <ul> |
| 84 | <li>Android SDK Platform-tools revision 9 or later.</li> |
| 85 | <li>If you are developing in Eclipse with ADT, note that the SDK Tools r16 is designed for use |
| 86 | with ADT 16.0.0 and later. If you haven't already, we highly recommend updating your |
| 87 | <a href="{@docRoot}sdk/eclipse-adt.html">ADT Plugin</a> to 16.0.0.</li> |
| 88 | <li>If you are developing outside Eclipse, you must have <a href="http://ant.apache.org/">Apache |
| 89 | Ant</a> 1.8 or later.</li> |
| 90 | </ul> |
| 91 | </dd> |
| 92 | <dt>General notes:</dt> |
| 93 | <dd> |
| 94 | <ul> |
| 95 | <li>Added Lint tools to detect common errors in Android projects. (<a |
| 96 | href="http://tools.android.com/recent/lint">more info</a>)</li> |
| 97 | <li>Added sensor emulation support, which allows the emulator to read sensor data from a |
| 98 | physical Android device.</li> |
| 99 | <li>Added support for using a webcam to emulate a camera on Mac OS X.</li> |
| 100 | </ul> |
| 101 | </dd> |
| 102 | <dt>Bug fixes:</dt> |
| 103 | <dd> |
| 104 | <ul> |
| 105 | <li>Snapshots now work for Android 4.0 system images.</li> |
| 106 | <li>Fixed several small issues for the build file. |
| 107 | (<a href="http://code.google.com/p/android/issues/detail?id=21023">Issue 21023</a>, |
| 108 | <a href="http://code.google.com/p/android/issues/detail?id=21267">Issue 21267</a>, |
| 109 | <a href="http://code.google.com/p/android/issues/detail?id=21465">Issue 21465</a>, |
| 110 | <a href="http://code.google.com/p/android/issues/detail?id=21525">Issue 21525</a>).</li> |
| 111 | </ul> |
| 112 | </dd> |
| 113 | </dl> |
| 114 | </div> |
| 115 | </div> |
| 116 | |
| 117 | <div class="toggleable closed"> |
| 118 | <a href="#" onclick="return toggleDiv(this)"> |
| 119 | <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px" |
| 120 | width="9px" /> |
| 121 | SDK Tools, Revision 15</a> <em>(October 2011)</em> |
Robert Ly | 490463f | 2011-10-24 11:06:36 -0700 | [diff] [blame] | 122 | |
| 123 | <div class="toggleme"> |
| 124 | <p class="caution"><strong>Important:</strong> To download the new Android |
| 125 | 4.0 system components from the Android SDK Manager, you must first update the |
| 126 | SDK tools to revision 14 or later and restart the Android SDK Manager. If you do not, |
| 127 | the Android 4.0 system components will not be available for download.</p> |
| 128 | <dl> |
| 129 | <dt>Dependencies:</dt> |
| 130 | <dd> |
| 131 | <ul><li>Android SDK Platform-tools revision 9 or later.</li> |
| 132 | <li>If you are developing in Eclipse with ADT, note that the SDK Tools r15 is designed for use |
| 133 | with ADT 15.0.0 and later. If you haven't already, we highly recommend updating your <a |
| 134 | href="{@docRoot}sdk/eclipse-adt.html">ADT Plugin</a> to 15.0.0.</li> |
| 135 | <li>If you are developing outside Eclipse, you must have <a href="http://ant.apache.org/">Apache |
| 136 | Ant</a> 1.8 or later.</li> |
| 137 | </ul> |
| 138 | |
| 139 | <dt>Bug fixes:</dt> |
| 140 | <dd> |
| 141 | <ul> |
| 142 | <li>Fixed emulator crash on Linux due to improper webcam detection |
| 143 | (<a href="http://code.google.com/p/android/issues/detail?id=20952">Issue 20952</a>).</li> |
| 144 | <li>Fixed emulator issue when using the <code>-wipe-data</code> argument.</li> |
| 145 | <li>Fixed build issue when using Renderscript in projects that target API levels 11-13 |
| 146 | (<a href="http://code.google.com/p/android/issues/detail?id=21006">Issue 21006</a>).</li> |
| 147 | <li>Fixed issue when creating an AVD using the GoogleTV addon |
| 148 | (<a href="http://code.google.com/p/android/issues/detail?id=20963">Issue 20963</a>).</li> |
| 149 | <li>Fixed <code>ant test</code> |
| 150 | (<a href="http://code.google.com/p/android/issues/detail?id=20979">Issue 20979</a>).</li> |
| 151 | <li>Fixed <code>android update project</code> |
| 152 | (<a href="http://code.google.com/p/android/issues/detail?id=20535">Issue 20535</a>).</li> |
| 153 | <li>Fixed scrolling issue in the new Logcat panel of DDMS.</li> |
| 154 | <li>Fixed issue with MonkeyRunner |
| 155 | (<a href="http://code.google.com/p/android/issues/detail?id=20964">Issue 20964</a>).</li> |
| 156 | <li>Fixed issues in the SDK Manager |
| 157 | (<a href="http://code.google.com/p/android/issues/detail?id=20939">Issue 20939</a>, |
| 158 | <a href="http://code.google.com/p/android/issues/detail?id=20607">Issue 20607</a>).</li> |
| 159 | </ul> |
| 160 | </dd> |
| 161 | </dl> |
| 162 | </div> |
| 163 | </div> |
| 164 | |
| 165 | <div class="toggleable closed"> |
| 166 | <a href="#" onclick="return toggleDiv(this)"> |
| 167 | <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px" |
Joe Fernandez | 890f7ea | 2011-11-28 17:00:27 -0800 | [diff] [blame^] | 168 | width="9px" /> |
| 169 | SDK Tools, Revision 14</a> <em>(October 2011)</em> |
Robert Ly | 6cf7d9a | 2011-10-12 15:30:35 -0700 | [diff] [blame] | 170 | |
Robert Ly | 6c81c30 | 2011-10-05 12:59:29 -0700 | [diff] [blame] | 171 | <div class="toggleme"> |
Robert Ly | 6cf7d9a | 2011-10-12 15:30:35 -0700 | [diff] [blame] | 172 | <p class="note"><strong>Important:</strong> To download the new Android |
| 173 | 4.0 system components from the Android SDK Manager, you must first update the |
| 174 | SDK tools to revision 14 and restart the Android SDK Manager. If you do not, |
| 175 | the Android 4.0 system components will not be available for download.</p> |
Robert Ly | 6c81c30 | 2011-10-05 12:59:29 -0700 | [diff] [blame] | 176 | <dl> |
| 177 | <dt>Dependencies:</dt> |
| 178 | <dd> |
| 179 | <ul><li>Android SDK Platform-tools revision 8 or later.</li> |
| 180 | <li>If you are developing in Eclipse with ADT, note that the SDK Tools r14 is designed for use |
| 181 | with ADT 14.0.0 and later. If you haven't already, we highly recommend updating your <a |
| 182 | href="{@docRoot}sdk/eclipse-adt.html">ADT Plugin</a> to 14.0.0.</li> |
| 183 | <li>If you are developing outside Eclipse, you must have <a href="http://ant.apache.org/">Apache |
| 184 | Ant</a> 1.8 or later.</li> |
| 185 | </ul> |
| 186 | |
| 187 | <dt>General notes:</dt> |
| 188 | <dd> |
| 189 | <ul> |
Joe Fernandez | 890f7ea | 2011-11-28 17:00:27 -0800 | [diff] [blame^] | 190 | <li>Added webcam support to Android 4.0 or later platforms to emulate rear-facing cameras when |
| 191 | one webcam is present, and to emulate both rear-facing and front-facing cameras when two |
| 192 | webcams are present. Webcam support is for Windows and Linux only. |
Robert Ly | 6cf7d9a | 2011-10-12 15:30:35 -0700 | [diff] [blame] | 193 | Mac support will come in a later release.</li> |
Joe Fernandez | 890f7ea | 2011-11-28 17:00:27 -0800 | [diff] [blame^] | 194 | <li>Changed <code>default.properties</code> to <code>project.properties</code> and |
Robert Ly | 6c81c30 | 2011-10-05 12:59:29 -0700 | [diff] [blame] | 195 | <code>build.properties</code> to <code>ant.properties</code>. Any existing |
| 196 | projects that you build with Ant must be updated with the <code>android update project</code> |
| 197 | command.</li> |
| 198 | <li>Changed Ant <code>build.xml</code> file to support improvements to the |
| 199 | build system and added and modified Ant commands to support these changes. For a list of Ant |
| 200 | commands, see the |
| 201 | <a href="{@docRoot}guide/developing/building/building-cmdline.html#AntReference">Ant Command |
| 202 | Reference</a>.</li> |
Robert Ly | 6c81c30 | 2011-10-05 12:59:29 -0700 | [diff] [blame] | 203 | <li>Changed how library projects are built.</a></li> |
| 204 | <li>Improved incremental builds, so that resource compilation runs less frequently. Builds no |
| 205 | longer run when you edit strings or layouts (unless you add a new <code>id</code>) and no longer |
| 206 | run once for each library project.</li> |
| 207 | <li>Introduced a "PNG crunch cache" that only runs on modified PNG files, instead of |
| 208 | crunching all existing PNG files, all the time.</li> |
| 209 | <li>Revamped the SDK Manager UI (<a href="http://tools.android.com/recent/newsdkmanager">more |
| 210 | info</a>).</li> |
| 211 | </ul> |
| 212 | <p>For a complete overview of the build system changes and what you need to do to support them, |
| 213 | see the <a href="http://tools.android.com/recent/buildchangesinrevision14">Android Tools Project |
| 214 | site</a>.</p> |
| 215 | </dd> |
| 216 | </dl> |
| 217 | </div> |
| 218 | </div> |
| 219 | |
| 220 | <div class="toggleable closed"> |
| 221 | <a href="#" onclick="return toggleDiv(this)"> |
| 222 | <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px" |
| 223 | width="9px" /> |
Robert Ly | dec9736 | 2011-09-22 10:33:28 -0700 | [diff] [blame] | 224 | SDK Tools, Revision 13</a> <em>(September 2011)</em> |
| 225 | <div class="toggleme"> |
| 226 | <dl> |
| 227 | <dt>Dependencies:</dt> |
| 228 | <dd> |
| 229 | <p>If you are developing in Eclipse with ADT, note that the SDK Tools r13 is designed for use with |
| 230 | ADT 12.0.0 and later. If you haven't already, we highly recommend updating your <a |
| 231 | href="{@docRoot}sdk/eclipse-adt.html">ADT Plugin</a> to 12.0.0.</p> |
| 232 | |
| 233 | <p>If you are developing outside Eclipse, you must have <a href="http://ant.apache.org/">Apache |
| 234 | Ant</a> 1.8 or later.</p> |
| 235 | |
| 236 | <dt>General notes:</dt> |
| 237 | <dd> |
| 238 | <ul> |
| 239 | <li>Fix compilation issue in Ant (<code>dex</code> step) when paths have spaces.</li> |
| 240 | <li>Fix issue in emulator installation when paths have spaces.</li> |
| 241 | <li>Fix issue when AVD paths have spaces.</li> |
| 242 | <li>Fix rendering issue when using emulator scaling (<a href="http://code.google.com/p/android/issues/detail?id=18299">see more</a>).</li> |
| 243 | </ul> |
| 244 | </dd> |
| 245 | </dl> |
| 246 | </div> |
| 247 | </div> |
| 248 | |
| 249 | |
| 250 | <div class="toggleable closed"> |
| 251 | <a href="#" onclick="return toggleDiv(this)"> |
| 252 | <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px" width="9px" /> |
Robert Ly | 31ee77e | 2011-07-06 11:16:19 -0700 | [diff] [blame] | 253 | SDK Tools, Revision 12</a> <em>(July 2011)</em> |
Robert Ly | 205d1c3 | 2011-06-28 13:13:14 -0700 | [diff] [blame] | 254 | <div class="toggleme"> |
| 255 | <dl> |
| 256 | <dt>Dependencies:</dt> |
| 257 | <dd> |
| 258 | <p>If you are developing in Eclipse with ADT, note that the SDK Tools r12 is designed for use with |
| 259 | ADT 12.0.0 and later. If you haven't already, we highly recommend updating your <a |
| 260 | href="{@docRoot}sdk/eclipse-adt.html">ADT Plugin</a> to 12.0.0.</p> |
| 261 | |
| 262 | <p>If you are developing outside Eclipse, you must have <a href="http://ant.apache.org/">Apache |
| 263 | Ant</a> 1.8 or later.</p> |
| 264 | |
| 265 | <dt>General notes:</dt> |
| 266 | <dd> |
| 267 | <ul> |
| 268 | <li>The AVD manager and emulator can now use system images |
| 269 | compiled for ARM v7 and x86 CPUs.</li> |
| 270 | </ul> |
| 271 | </dd> |
| 272 | </dl> |
| 273 | </div> |
| 274 | </div> |
| 275 | |
| 276 | <div class="toggleable closed"> |
| 277 | <a href="#" onclick="return toggleDiv(this)"> |
| 278 | <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px" width="9px" /> |
Dirk Dougherty | b7c7f15 | 2011-03-25 11:54:46 -0700 | [diff] [blame] | 279 | SDK Tools, Revision 11</a> <em>(May 2011)</em> |
Robert Ly | ccea5d2 | 2011-02-11 14:59:36 -0800 | [diff] [blame] | 280 | <div class="toggleme"> |
| 281 | <dl> |
| 282 | <dt>Dependencies:</dt> |
| 283 | <dd> |
Scott Main | 19f7201 | 2011-05-05 18:27:49 -0700 | [diff] [blame] | 284 | <p>If you are developing in Eclipse with ADT, note that the SDK Tools r11 is designed for use with |
| 285 | ADT 10.0.1 and later. If you haven't already, we highly recommend updating your <a |
| 286 | href="{@docRoot}sdk/eclipse-adt.html">ADT Plugin</a> to 10.0.1.</p> |
| 287 | |
| 288 | <p>If you are developing outside Eclipse, you must have <a href="http://ant.apache.org/">Apache |
| 289 | Ant</a> 1.8 or later.</p> |
| 290 | |
| 291 | <dt>General notes:</dt> |
| 292 | <dd> |
| 293 | <ul> |
| 294 | <li>Miscellaneous emulator changes to support Android 3.1.</li> |
| 295 | </ul> |
| 296 | </dd> |
| 297 | </dl> |
| 298 | </div> |
| 299 | </div> |
| 300 | |
| 301 | |
| 302 | <div class="toggleable closed"> |
| 303 | <a href="#" onclick="return toggleDiv(this)"> |
| 304 | <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px" |
| 305 | width="9px" /> |
| 306 | SDK Tools, Revision 10</a> <em>(February 2011)</em> |
| 307 | <div class="toggleme"> |
| 308 | <dl> |
| 309 | <dt>Dependencies:</dt> |
| 310 | <dd> |
Robert Ly | ccea5d2 | 2011-02-11 14:59:36 -0800 | [diff] [blame] | 311 | <p>If you are developing in Eclipse with ADT, note that the SDK Tools r10 is |
| 312 | designed for use with ADT 10.0.0 and later. After installing SDK Tools r10, we |
| 313 | highly recommend updating your ADT Plugin to 10.0.0.</p> |
| 314 | |
| 315 | <p>If you are developing outside Eclipse, you must have <a href="http://ant.apache.org/">Apache |
| 316 | Ant</a> 1.8 or later.</p> |
| 317 | |
| 318 | <dt>General notes:</dt> |
| 319 | <dd> |
| 320 | <ul> |
Scott Main | 19f7201 | 2011-05-05 18:27:49 -0700 | [diff] [blame] | 321 | <li>The tools now automatically generate Java Programming Language source files (in the |
| 322 | <code>gen</code> directory) and |
Robert Ly | ccea5d2 | 2011-02-11 14:59:36 -0800 | [diff] [blame] | 323 | bytecode (in the <code>res/raw</code> directory) from your native <code>.rs</code> files</li> |
| 324 | </ul> |
| 325 | </dd> |
| 326 | </dl> |
| 327 | </div> |
| 328 | </div> |
| 329 | |
| 330 | |
| 331 | |
| 332 | <div class="toggleable closed"> |
| 333 | <a href="#" onclick="return toggleDiv(this)"> |
| 334 | <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px" width="9px" /> |
Robert Ly | edc2aac | 2011-01-14 16:25:09 -0800 | [diff] [blame] | 335 | SDK Tools, Revision 9</a> <em>(January 2011)</em> |
| 336 | <div class="toggleme"> |
| 337 | <dl> |
| 338 | <dt>Dependencies:</dt> |
| 339 | <dd> |
| 340 | <p>If you are developing in Eclipse with ADT, note that the SDK Tools r9 is |
| 341 | designed for use with ADT 9.0.0 and later. After installing SDK Tools r9, we |
| 342 | highly recommend updating your ADT Plugin to 9.0.0.</p> |
| 343 | |
| 344 | <p>If you are developing outside Eclipse, you must have <a href="http://ant.apache.org/">Apache |
| 345 | Ant</a> 1.8 or later.</p> |
| 346 | |
| 347 | <dt>Upgrading to SDK Tools r9:</dt> |
| 348 | <dd> |
| 349 | <p>If you are upgrading to SDK Tools r9 from SDK Tools r7 or earlier, the default installed location |
| 350 | for the <code>adb</code> tool has changed from <code><<em>SDK</em>>/tools/adb</code> to |
| 351 | <code><<em>SDK</em>>/platform-tools/adb</code>. This means that you should |
| 352 | add the new location to your PATH and modify any custom build scripts to |
| 353 | reference the new location. Copying the <code>adb</code> executable from the new |
| 354 | location to the old is not recommended, since subsequent updates to the SDK |
| 355 | Tools will delete the file.</p> |
| 356 | </dd> |
| 357 | |
| 358 | <dt>General notes:</dt> |
| 359 | <dd> |
| 360 | <ul> |
| 361 | <li>The default ProGuard configuration, <code>proguard.cfg</code>, now ignores the following classes: |
| 362 | <ul> |
| 363 | <li>classes that extend {@link android.preference.Preference}</li> |
| 364 | <li>classes that extend {@link android.app.backup.BackupAgentHelper}</li> |
| 365 | </ul> |
| 366 | </li> |
| 367 | <li>Ant lib rules now allow you to override <code>java.encoding</code>, <code>java.source</code>, |
| 368 | and <code>java.target</code> properties.</li> |
| 369 | <li>The default encoding for the <code>javac</code> Ant task is now UTF-8.</li> |
| 370 | <li>The LogCat view in DDMS now properly displays UTF-8 characters.</li> |
| 371 | <li>The SDK Manager is more reliable on Windows. For details on the improvements, see the |
| 372 | <a href="http://tools.android.com/recent/sdkmanagerfixes">Android Tools Project Site</a>. </li> |
Scott Main | f9af301 | 2011-01-27 11:26:29 -0800 | [diff] [blame] | 373 | <li>Early look at the new snapshot feature: To improve startup time for the emulator, you can |
| 374 | enable snapshots for the system state. The emulator will then restore to the state when it last |
| 375 | closed almost instantly. <strong>Note:</strong> The snapshot feature is still under active |
| 376 | development and might not always perform as expected.</li> |
Robert Ly | edc2aac | 2011-01-14 16:25:09 -0800 | [diff] [blame] | 377 | <li>Fixed the missing JAR file error that prevented <code>draw9patch</code> from running.</li> |
| 378 | <li>Fixed the Windows launch scripts <code>hierarchyviewer</code> and <code>ddms</code> to support |
| 379 | the new location of <code>adb</code>.</li> |
Scott Main | 04f04b2 | 2011-01-21 19:11:23 -0800 | [diff] [blame] | 380 | <li>Known issues with emulator performance: Because the Android emulator must simulate the ARM |
| 381 | instruction set architecture on your computer, emulator performance is slow. We're working hard to |
| 382 | resolve the performance issues and it will improve in future releases.</li> |
Robert Ly | edc2aac | 2011-01-14 16:25:09 -0800 | [diff] [blame] | 383 | </ul> |
| 384 | </dd> |
| 385 | </dl> |
| 386 | </div> |
| 387 | </div> |
| 388 | |
| 389 | <div class="toggleable closed"> |
| 390 | <a href="#" onclick="return toggleDiv(this)"> |
| 391 | <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px" width="9px" /> |
Dirk Dougherty | 9f7580d | 2010-10-26 09:29:03 -0700 | [diff] [blame] | 392 | SDK Tools, Revision 8</a> <em>(December 2010)</em> |
| 393 | <div class="toggleme"> |
| 394 | |
| 395 | <dl> |
| 396 | <dt>Dependencies:</dt> |
| 397 | <dd> |
| 398 | <p>If you are developing in Eclipse with ADT, note that SDK Tools r8 is |
| 399 | designed for use with ADT 8.0.0 and later. After installing SDK Tools r8, we |
| 400 | highly recommend updating your ADT Plugin to 8.0.0.</p> |
| 401 | |
Scott Main | 92b0308 | 2010-12-14 17:55:27 -0800 | [diff] [blame] | 402 | <p>If you are developing outside Eclipse, you must have <a href="http://ant.apache.org/">Apache |
| 403 | Ant</a> 1.8 or later.</p> |
| 404 | |
Dirk Dougherty | 9f7580d | 2010-10-26 09:29:03 -0700 | [diff] [blame] | 405 | <p>Also note that SDK Tools r8 requires a new SDK component called |
| 406 | <em>Platform-tools</em>. The new Platform-tools component lets all SDK platforms |
| 407 | (Android 2.1, Android 2.2, and so on) use the same (latest) version of build |
| 408 | tools such as <code>adb</code>, <code>aapt</code>, <code>aidl</code>, and |
| 409 | <code>dx</code>. To download the Platform-tools component, use the Android SDK |
| 410 | Manager, as described in <a href="adding-components.html">Adding SDK |
| 411 | Components</a></p> |
| 412 | |
| 413 | <dt>Upgrading from SDK Tools r7:</dt> |
| 414 | <dd> |
| 415 | <p>If you are upgrading to SDK Tools r8 from an earlier version, note that the |
| 416 | the default installed location for the <code>adb</code> tool has changed from |
| 417 | <code><<em>SDK</em>>/tools/adb</code> to |
| 418 | <code><<em>SDK</em>>/platform-tools/adb</code>. This means that you should |
| 419 | add the new location to your PATH and modify any custom build scripts to |
| 420 | reference the new location. Copying the <code>adb</code> executable from the new |
| 421 | location to the old is not recommended, since subsequent updates to the SDK |
| 422 | Tools will delete the file.</p> |
| 423 | </dd> |
| 424 | |
| 425 | <dt>General notes:</dt> |
| 426 | <dd> |
| 427 | <ul> |
| 428 | <li>All SDK platforms now support Library Projects.</li> |
| 429 | <li>Support for a true debug build. Developers no longer need to add the |
| 430 | <code>android:debuggable</code> attribute to the |
| 431 | <code><application></code> tag in the manifest — the build tools add |
| 432 | the attribute automatically. In Eclipse/ADT, all incremental builds are assumed |
| 433 | to be debug builds, so the tools insert <code>android:debuggable="true"</code>. |
| 434 | When exporting a signed release build, the tools do not add the attribute. In |
| 435 | Ant, a <code>ant debug</code> command automatically inserts the |
| 436 | <code>android:debuggable="true"</code> attribute, while <code>ant release</code> |
| 437 | does not. If <code>android:debuggable="true"</code> is manually set, then |
| 438 | <code>ant release</code> will actually do a debug build, rather than a release |
| 439 | build.</li> |
| 440 | <li>Automatic ProGuard support in release builds. Developers generate a ProGuard |
| 441 | configuration file using the <code>android</code> tool — the build tools |
| 442 | then automatically run ProGuard against the project sources during the build. |
| 443 | For more information, see the <a |
| 444 | href="{@docRoot}guide/developing/tools/proguard.html">ProGuard</a> |
| 445 | documentation. </li> |
| 446 | <li>New overridable Ant javac properties: <code>java.encoding</code>, |
| 447 | <code>java.source</code>, and <code>java.target</code> (default values are |
| 448 | "ascii", "1.5", and "1.5", respectively).</li> |
| 449 | <li>New UI for the HierarchyViewer tool.</li> |
| 450 | </ul> |
| 451 | </dd> |
| 452 | </dl> |
| 453 | </div> |
| 454 | </div> |
| 455 | |
| 456 | <div class="toggleable closed"> |
| 457 | <a href="#" onclick="return toggleDiv(this)"> |
| 458 | <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px" width="9px" /> |
Dirk Dougherty | 022171b | 2010-07-30 19:24:17 -0700 | [diff] [blame] | 459 | SDK Tools, Revision 7</a> <em>(September 2010)</em> |
| 460 | <div class="toggleme"> |
| 461 | |
| 462 | <dl> |
| 463 | <dt>Dependencies:</dt> |
| 464 | <dd> |
| 465 | <p>If you are developing in Eclipse with ADT, note that SDK Tools r7 is |
| 466 | designed for use with ADT 0.9.8 and later. After installing SDK Tools r7, we |
| 467 | highly recommend updating your ADT Plugin to 0.9.8.</p> |
| 468 | </dd> |
| 469 | |
| 470 | <dt>General notes:</dt> |
| 471 | <dd> |
| 472 | <ul> |
| 473 | <li>Added support for library projects that depend on other library projects.</li> |
| 474 | <li>Adds support for aidl files in library projects.</li> |
| 475 | <li>Adds support for extension targets in Ant build to perform tasks between the |
| 476 | normal tasks: <code>-pre-build</code>, <code>-pre-compile</code>, and |
| 477 | <code>-post-compile</code>.</li> |
| 478 | <li>Adds support for "headless" SDK update. See <code>android -h update sdk</code> |
| 479 | for more information.</li> |
| 480 | <li>Fixes location control in DDMS to work in any locale not using '.' as a |
| 481 | decimal point.</li> |
Joe Fernandez | 890f7ea | 2011-11-28 17:00:27 -0800 | [diff] [blame^] | 482 | </ul> |
Dirk Dougherty | 022171b | 2010-07-30 19:24:17 -0700 | [diff] [blame] | 483 | </ul> |
| 484 | </dd> |
| 485 | </dl> |
| 486 | </div> |
| 487 | </div> |
| 488 | |
| 489 | <div class="toggleable closed"> |
| 490 | <a href="#" onclick="return toggleDiv(this)"> |
| 491 | <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px" width="9px" /> |
Dirk Dougherty | 0d1b081 | 2010-04-07 17:05:16 -0700 | [diff] [blame] | 492 | SDK Tools, Revision 6</a> <em>(May 2010)</em> |
| 493 | <div class="toggleme"> |
| 494 | |
| 495 | <dl> |
| 496 | <dt>Dependencies:</dt> |
| 497 | <dd> |
| 498 | <p>If you are developing in Eclipse with ADT, note that SDK Tools r6 is |
| 499 | designed for use with ADT 0.9.7 and later. After installing SDK Tools r6, we |
| 500 | highly recommend updating your ADT Plugin to 0.9.7.</p> |
| 501 | </dd> |
| 502 | |
| 503 | <dt>Library projects:</dt> |
| 504 | <dd> |
| 505 | <p>The SDK Tools now support the use of <em>library projects</em> during |
| 506 | development, a capability that lets you store shared Android application |
| 507 | code and resources in a separate development project. You can then reference the |
| 508 | library project from other Android projects and, at build time, the tools |
| 509 | compile the shared code and resources as part of the dependent applications. |
| 510 | More information about this feature is available in the <a |
Robert Ly | c74a69a8 | 2011-01-04 22:48:02 -0800 | [diff] [blame] | 511 | href="{@docRoot}guide/developing/projects/index.html#LibraryProjects">Creating and Managing Projects</a> document.</p> |
| 512 | <p>If you are developing in Eclipse, <a href="eclipse-adt.html">ADT</a> |
Dirk Dougherty | 0d1b081 | 2010-04-07 17:05:16 -0700 | [diff] [blame] | 513 | provides the equivalent library project support.</p> |
| 514 | </dd> |
| 515 | </dl> |
| 516 | </div> |
| 517 | </div> |
| 518 | |
| 519 | <div class="toggleable closed"> |
| 520 | <a href="#" onclick="return toggleDiv(this)"> |
Dirk Dougherty | 74a74d3 | 2010-09-09 18:40:13 -0700 | [diff] [blame] | 521 | <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px" width="9px" /> |
Dirk Dougherty | 7b229ef | 2010-03-26 17:32:26 -0700 | [diff] [blame] | 522 | SDK Tools, Revision 5</a> <em>(March 2010)</em> |
| 523 | <div class="toggleme"> |
Dirk Dougherty | bca9f1b | 2009-11-18 23:06:16 -0800 | [diff] [blame] | 524 | |
Dirk Dougherty | 7b229ef | 2010-03-26 17:32:26 -0700 | [diff] [blame] | 525 | <dl> |
| 526 | <dt>Dependencies:</dt> |
| 527 | <dd><ul> |
| 528 | <li>If you are developing in Eclipse with ADT, note that SDK Tools r5 is |
| 529 | designed for use with ADT 0.9.6 and later. After installing SDK Tools r5, we |
| 530 | highly recommend updating your ADT Plugin to 0.9.6.</li> |
| 531 | <li>For Mac OS platforms, OS X 10.4.x (Tiger) is no longer |
| 532 | officially supported. </li> |
| 533 | </ul> |
| 534 | </dd> |
| 535 | |
| 536 | <dt>SDK and AVD Manager:</dt> |
| 537 | <dd> |
| 538 | <ul> |
| 539 | <li>Fixes SSL download for the standalone version of the SDK Updater.</li> |
| 540 | <li>Fixes issue with 64-bit JVM on Windows.</li> |
| 541 | <li>Adds support for platform samples components.</li> |
| 542 | <li>Improves support for dependency between components.</li> |
| 543 | <li>AVDs now sorted by API level.</li> |
| 544 | <li>The AVD creation dialog now enforces a minimum SD card size of 9MB.</li> |
| 545 | <li>Prevents deletion of running AVDs.</li> |
| 546 | <li>Settings are now automatically saved, no need to click "Apply".</li> |
| 547 | </ul> |
| 548 | </dd> |
| 549 | |
| 550 | <dt>Emulator:</dt> |
| 551 | <dd> |
| 552 | <ul> |
| 553 | <li>Emulator now requires SD card to be 9MB or more.</li> |
| 554 | </ul> |
| 555 | </dd> |
| 556 | |
| 557 | <dt>Layoutopt:</dt> |
| 558 | <dd> |
| 559 | <ul> |
| 560 | <li>Fixes <code>layoutopt.bat</code> to execute correctly on Windows.</li> |
| 561 | </ul> |
| 562 | </dd> |
| 563 | </dl> |
| 564 | </div> |
| 565 | </div> |
| 566 | |
| 567 | <div class="toggleable closed"> |
| 568 | <a href="#" onclick="return toggleDiv(this)"> |
| 569 | <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px" width="9px" /> |
| 570 | SDK Tools, Revision 4</a> <em>(December 2009)</em> |
| 571 | <div class="toggleme"> |
| 572 | |
| 573 | <dl> |
| 574 | <dt>Dependencies:</dt> |
| 575 | <dd><p>SDK Tools r4 is compatible with ADT 0.9.5 and later, but not |
Dirk Dougherty | bca9f1b | 2009-11-18 23:06:16 -0800 | [diff] [blame] | 576 | compatible with earlier versions. If you are developing in Eclipse with ADT, you |
| 577 | <strong>must</strong> update your ADT plugin to version 0.9.5 or higher if you |
Dirk Dougherty | 7b229ef | 2010-03-26 17:32:26 -0700 | [diff] [blame] | 578 | install SDK Tools r4 in your SDK. </p></dd> |
Dirk Dougherty | bca9f1b | 2009-11-18 23:06:16 -0800 | [diff] [blame] | 579 | |
Dirk Dougherty | 7b229ef | 2010-03-26 17:32:26 -0700 | [diff] [blame] | 580 | <dt>General notes:</dt> |
| 581 | <dd> |
Dirk Dougherty | bca9f1b | 2009-11-18 23:06:16 -0800 | [diff] [blame] | 582 | <ul> |
Robert Ly | dec9736 | 2011-09-22 10:33:28 -0700 | [diff] [blame] | 583 | <li>Launcher script now forces GDK_NATIVE_WINDOW=true (linux only), to fix a |
Dirk Dougherty | bca9f1b | 2009-11-18 23:06:16 -0800 | [diff] [blame] | 584 | compatibility issue between GTK and SWT.</li> |
| 585 | </ul> |
Dirk Dougherty | 7b229ef | 2010-03-26 17:32:26 -0700 | [diff] [blame] | 586 | </dd> |
Dirk Dougherty | bca9f1b | 2009-11-18 23:06:16 -0800 | [diff] [blame] | 587 | |
Dirk Dougherty | 7b229ef | 2010-03-26 17:32:26 -0700 | [diff] [blame] | 588 | <dt>Android SDK and AVD Manager:</dt> |
| 589 | <dd> |
Dirk Dougherty | bca9f1b | 2009-11-18 23:06:16 -0800 | [diff] [blame] | 590 | <ul> |
| 591 | <li>AVD Launch dialog now shows scale value.</li> |
Robert Ly | dec9736 | 2011-09-22 10:33:28 -0700 | [diff] [blame] | 592 | <li>Fixes potential NPE in SDK Manager on AVD launch, for older AVD with no |
Dirk Dougherty | bca9f1b | 2009-11-18 23:06:16 -0800 | [diff] [blame] | 593 | skin name specified.</li> |
| 594 | <li>Fixes XML validation issue in on older Java versions.</li> |
| 595 | <li>No longer forces the use of Java 1.5 on Mac OS X.</li> |
| 596 | </ul> |
Dirk Dougherty | 7b229ef | 2010-03-26 17:32:26 -0700 | [diff] [blame] | 597 | </dd> |
Dirk Dougherty | bca9f1b | 2009-11-18 23:06:16 -0800 | [diff] [blame] | 598 | |
Dirk Dougherty | 7b229ef | 2010-03-26 17:32:26 -0700 | [diff] [blame] | 599 | <dt>Emulator:</dt> |
| 600 | <dd> |
Dirk Dougherty | bca9f1b | 2009-11-18 23:06:16 -0800 | [diff] [blame] | 601 | <ul> |
| 602 | <li>No longer limits the size of the system partition.</li> |
| 603 | </ul> |
Dirk Dougherty | 7b229ef | 2010-03-26 17:32:26 -0700 | [diff] [blame] | 604 | </dd> |
Dirk Dougherty | bca9f1b | 2009-11-18 23:06:16 -0800 | [diff] [blame] | 605 | |
Dirk Dougherty | 7b229ef | 2010-03-26 17:32:26 -0700 | [diff] [blame] | 606 | <dt>Ant build tools:</dt> |
| 607 | <dd> |
Dirk Dougherty | bca9f1b | 2009-11-18 23:06:16 -0800 | [diff] [blame] | 608 | <ul> |
| 609 | <li>.apk packaging now properly ignores vi swap files as well as hidden files.</li> |
| 610 | </ul> |
Dirk Dougherty | 7b229ef | 2010-03-26 17:32:26 -0700 | [diff] [blame] | 611 | </dd> |
| 612 | </dl> |
| 613 | </div> |
| 614 | </div> |
Dirk Dougherty | bca9f1b | 2009-11-18 23:06:16 -0800 | [diff] [blame] | 615 | |
Dirk Dougherty | 7b229ef | 2010-03-26 17:32:26 -0700 | [diff] [blame] | 616 | <div class="toggleable closed"> |
| 617 | <a href="#" onclick="return toggleDiv(this)"> |
| 618 | <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-img" height="9px" width="9px" /> |
| 619 | SDK Tools, Revision 3</a> <em>(October 2009)</em> |
| 620 | <div class="toggleme"> |
Dirk Dougherty | ee58d1b | 2009-10-16 15:25:15 -0700 | [diff] [blame] | 621 | |
Dirk Dougherty | 7b229ef | 2010-03-26 17:32:26 -0700 | [diff] [blame] | 622 | <dl> |
| 623 | <dt>Dependencies:</dt> |
| 624 | <dd><p>SDK Tools r3 is compatible with ADT 0.9.4 and later, but not |
Dirk Dougherty | ee58d1b | 2009-10-16 15:25:15 -0700 | [diff] [blame] | 625 | compatible with earlier versions. If you are developing in Eclipse with ADT, you |
| 626 | <strong>must</strong> update your ADT plugin to version 0.9.4 or higher if you |
Dirk Dougherty | 7b229ef | 2010-03-26 17:32:26 -0700 | [diff] [blame] | 627 | install SDK Tools r3 in your SDK.</p> |
| 628 | </dd> |
Dirk Dougherty | ee58d1b | 2009-10-16 15:25:15 -0700 | [diff] [blame] | 629 | |
Dirk Dougherty | 7b229ef | 2010-03-26 17:32:26 -0700 | [diff] [blame] | 630 | <dt>Android tool:</dt> |
| 631 | <dd> |
Dirk Dougherty | ee58d1b | 2009-10-16 15:25:15 -0700 | [diff] [blame] | 632 | <ul> |
| 633 | <li>Adds new <code>android create test-project</code> and <code>android update |
| 634 | test-project</code> commands to allow for greater flexibility in the location of the |
| 635 | main and test projects.</li> |
| 636 | </ul> |
Dirk Dougherty | 7b229ef | 2010-03-26 17:32:26 -0700 | [diff] [blame] | 637 | </dd> |
Dirk Dougherty | ee58d1b | 2009-10-16 15:25:15 -0700 | [diff] [blame] | 638 | |
Dirk Dougherty | 7b229ef | 2010-03-26 17:32:26 -0700 | [diff] [blame] | 639 | <dt>DDMS:</dt> |
| 640 | <dd> |
Dirk Dougherty | ee58d1b | 2009-10-16 15:25:15 -0700 | [diff] [blame] | 641 | <ul> |
Scott Main | 19f7201 | 2011-05-05 18:27:49 -0700 | [diff] [blame] | 642 | <li>Adds a button to dump HPROF file for running applications (app must be able |
Dirk Dougherty | ee58d1b | 2009-10-16 15:25:15 -0700 | [diff] [blame] | 643 | to write to the sdcard).</li> |
| 644 | <li>Button to start/stop profiling of a running application (app must be able to |
| 645 | write to the sdcard). Upon stop, Traceview will automatically be launched to |
| 646 | display the trace.</li> |
| 647 | <li>Fixed DDMS, Traceview, and the AVD Mananger/SDK Updater to run on Mac OS X |
| 648 | 10.6.</li> |
| 649 | <li>Fixed screenshot support for devices running 32-bit framebuffer.</li> |
| 650 | </ul> |
Dirk Dougherty | 7b229ef | 2010-03-26 17:32:26 -0700 | [diff] [blame] | 651 | </dd> |
Dirk Dougherty | ee58d1b | 2009-10-16 15:25:15 -0700 | [diff] [blame] | 652 | |
Dirk Dougherty | 7b229ef | 2010-03-26 17:32:26 -0700 | [diff] [blame] | 653 | <dt>Android SDK and AVD Manager:</dt> |
| 654 | <dd> |
Dirk Dougherty | ee58d1b | 2009-10-16 15:25:15 -0700 | [diff] [blame] | 655 | <ul> |
| 656 | <li>Provides a new UI that lets you set options for controlling |
Robert Ly | dec9736 | 2011-09-22 10:33:28 -0700 | [diff] [blame] | 657 | the emulator skin, screen size/density, and scale factor used when launching |
Dirk Dougherty | ee58d1b | 2009-10-16 15:25:15 -0700 | [diff] [blame] | 658 | an AVD.</li> |
| 659 | <li>Provides improved AVD creation UI, which lets you customize the hardware |
| 660 | properties of your AVDs.</li> |
| 661 | <li>Now enforces dependencies between platforms and tools components, and |
| 662 | between SDK add-ons and platforms.</li> |
| 663 | </ul> |
Dirk Dougherty | 7b229ef | 2010-03-26 17:32:26 -0700 | [diff] [blame] | 664 | </dd> |
Dirk Dougherty | ee58d1b | 2009-10-16 15:25:15 -0700 | [diff] [blame] | 665 | |
Dirk Dougherty | 7b229ef | 2010-03-26 17:32:26 -0700 | [diff] [blame] | 666 | <dt>Layoutopt, a new tool for optimizing layouts:</dt> |
Dirk Dougherty | ee58d1b | 2009-10-16 15:25:15 -0700 | [diff] [blame] | 667 | |
Robert Ly | dec9736 | 2011-09-22 10:33:28 -0700 | [diff] [blame] | 668 | <dd><p>The SDK Tools r3 package includes <code>layoutopt</code>, a new command-line |
| 669 | tool that helps you optimize your layout hierarchies. When run against your |
| 670 | layout files, the tool analyzes their hierarchies and notifies you of |
| 671 | inefficiencies and other potential issues. The tool also provides simple |
| 672 | solutions for the issues it finds. For usage, see <a |
Dirk Dougherty | 7b229ef | 2010-03-26 17:32:26 -0700 | [diff] [blame] | 673 | href="/guide/developing/tools/layoutopt.html">layoutopt</a>.</p> |
| 674 | </dd> |
| 675 | </dl> |
| 676 | </div> |
| 677 | </div> |