1page.title=Platforms 2@jd:body 3 4<div id="qv-wrapper"> 5<div id="qv"> 6 7 8<h2>See Also</h2> 9<ol> 10 <li><a href="{@docRoot}about/versions/android-4.0-highlights.html">Ice Cream Sandwich 11Highlights and APIs</a></li> 12 <li><a href="{@docRoot}about/versions/android-3.0-highlights.html">Honeycomb 13Highlights and APIs</a></li> 14 <li><a href="{@docRoot}about/versions/android-2.3-highlights.html">Gingerbread 15Highlights and APIs</a></li> 16</ol> 17 18</div> 19</div> 20 21 22 23<p>To develop an Android app, you must install at least one Android platform from the SDK Manager 24against which you can compile your app. Often, any given version of the Android will be revised 25with bug fixes or other changes, as denoted by the "revision" number. Below, you'll find the 26release notes for each version of the platform and the subsequent revisions to the platform 27version.</p> 28 29<p>To determine what revision of an Android platform you 30have installed, refer to the "Installed Packages" listing in the Android SDK Manager.</p> 31 32 33 34 35 36 37 38 39<h2 id="4.0.3">Android 4.0.3</h2> 40 41 42<p class="caution"><strong>Important:</strong> To download the new Android 434.0.x system components from the Android SDK Manager, you must first update the 44SDK tools to revision 14 or later and restart the Android SDK Manager. If you do not, 45the Android 4.0.x system components will not be available for download.</p> 46 47<div class="toggle-content opened"> 48 49 <p><a href="#" onclick="return toggleContent(this)"> 50 <img src="{@docRoot}assets/images/triangle-opened.png" 51class="toggle-content-img" alt="" /> 52 Revision 3</a> <em>(March 2012)</em> 53 </a></p> 54 55 <div class="toggle-content-toggleme" style="padding-left:2em;"> 56 57 <p>Maintenance update. The system version is 4.0.4.</p> 58 <p class="note"><strong>Note:</strong> This system image includes support for emulator 59hardware graphics acceleration when used with SDK Tools r17 or higher. 60(<a href="{@docRoot}tools/devices/emulator.html#accel-graphics">more info</a>)</p> 61 <dl> 62 <dt>Dependencies:</dt> 63 <dd>SDK Tools r17 or higher is required.</dd> 64 </dl> 65 66 </div> 67</div> 68 69<div class="toggle-content closed" > 70 71 <p><a href="#" onclick="return toggleContent(this)"> 72 <img src="{@docRoot}assets/images/triangle-closed.png" 73class="toggle-content-img" alt="" /> 74 Revision 2</a> <em>(January 2012)</em> 75 </a></p> 76 77 <div class="toggle-content-toggleme" style="padding-left:2em;"> 78 79 <p>Maintenance update. The system version is 4.0.3.</p> 80 <dl> 81 <dt>Dependencies:</dt> 82 <dd>SDK Tools r14 or higher is required.</dd> 83 </dl> 84 85 </div> 86</div> 87 88<div class="toggle-content closed" > 89 90 <p><a href="#" onclick="return toggleContent(this)"> 91 <img src="{@docRoot}assets/images/triangle-closed.png" 92class="toggle-content-img" alt="" /> 93 Revision 1</a> <em>(December 2011)</em> 94 </a></p> 95 96 <div class="toggle-content-toggleme" style="padding-left:2em;"> 97 98 <p>Initial release. The system version is 4.0.3.</p> 99 <dl> 100 <dt>Dependencies:</dt> 101 <dd>SDK Tools r14 or higher is required.</dd> 102 </dl> 103 104 </div> 105</div> 106 107<h3>Emulator Skins</h3> 108 109<p>The downloadable platform includes the following emulator skins:</p> 110 111<ul> 112 <li> 113 QVGA (240x320, low density, small screen) 114 </li> 115 <li> 116 WQVGA400 (240x400, low density, normal screen) 117 </li> 118 <li> 119 WQVGA432 (240x432, low density, normal screen) 120 </li> 121 <li> 122 HVGA (320x480, medium density, normal screen) 123 </li> 124 <li> 125 WVGA800 (480x800, high density, normal screen) 126 </li> 127 <li> 128 WVGA854 (480x854 high density, normal screen) 129 </li> 130 <li> 131 WXGA720 (1280x720, extra-high density, normal screen) 132 </li> 133 <li> 134 WSVGA (1024x600, medium density, large screen) 135 </li> 136 <li> 137 WXGA (1280x800, medium density, xlarge screen) 138 </li> 139</ul> 140 141<p>To test your application on an emulator that represents the latest Android device, you can create 142an AVD with the new WXGA720 skin (it's an xhdpi, normal screen device). Note that the emulator 143currently doesn't support the new on-screen navigation bar for devices without hardware navigation 144buttons, so when using this skin, you must use keyboard keys <em>Home</em> for the Home button, 145<em>ESC</em> for the Back button, and <em>F2</em> or <em>Page-up</em> for the Menu button.</p> 146 147<p>However, due to performance issues in the emulator when running high-resolution screens such as 148the one for the WXGA720 skin, we recommend that you primarily use the traditional WVGA800 skin 149(hdpi, normal screen) to test your application.</p> 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165<h2 id="4.0">Android 4.0</h2> 166 167 168<div class="toggle-content closed"> 169 170 <p><a href="#" onclick="return toggleContent(this)"> 171 <img src="{@docRoot}assets/images/triangle-closed.png" 172class="toggle-content-img" alt="" /> 173 Android 4.0, Revision 2</a> <em>(December 2011)</em> 174 </a></p> 175 176 <div class="toggle-content-toggleme" style="padding-left:2em;"> 177 <p>Maintenance update. The system version is 4.0.2.</p> 178 <dl> 179 <dt>Dependencies:</dt> 180 <dd>SDK Tools r14 or higher is required.</dd> 181 </dl> 182 </div> 183</div> 184 185<div class="toggle-content closed"> 186 187 <p><a href="#" onclick="return toggleContent(this)"> 188 <img src="{@docRoot}assets/images/triangle-closed.png" 189class="toggle-content-img" alt="" /> 190 Android 4.0, Revision 1</a> <em>(October 2011)</em> 191 </a></p> 192 193 <div class="toggle-content-toggleme" style="padding-left:2em;"> 194 <p>Initial release. The system version is 4.0.1.</p> 195 <dl> 196 <dt>Dependencies:</dt> 197 <dd>SDK Tools r14 or higher is required.</dd> 198 </dl> 199 </div> 200</div> 201 202 203<h3>Emulator Skins</h3> 204 205<p>The downloadable platform includes the following emulator skins:</p> 206 207<ul> 208 <li> 209 QVGA (240x320, low density, small screen) 210 </li> 211 <li> 212 WQVGA400 (240x400, low density, normal screen) 213 </li> 214 <li> 215 WQVGA432 (240x432, low density, normal screen) 216 </li> 217 <li> 218 HVGA (320x480, medium density, normal screen) 219 </li> 220 <li> 221 WVGA800 (480x800, high density, normal screen) 222 </li> 223 <li> 224 WVGA854 (480x854 high density, normal screen) 225 </li> 226 <li> 227 WXGA720 (1280x720, extra-high density, normal screen) <span class="new">new</span> 228 </li> 229 <li> 230 WSVGA (1024x600, medium density, large screen) <span class="new">new</span> 231 </li> 232 <li> 233 WXGA (1280x800, medium density, xlarge screen) 234 </li> 235</ul> 236 237<p>To test your application on an emulator that represents the latest Android device, you can create 238an AVD with the new WXGA720 skin (it's an xhdpi, normal screen device). Note that the emulator 239currently doesn't support the new on-screen navigation bar for devices without hardware navigation 240buttons, so when using this skin, you must use keyboard keys <em>Home</em> for the Home button, 241<em>ESC</em> for the Back button, and <em>F2</em> or <em>Page-up</em> for the Menu button.</p> 242 243<p>However, due to performance issues in the emulator when running high-resolution screens such as 244the one for the WXGA720 skin, we recommend that you primarily use the traditional WVGA800 skin 245(hdpi, normal screen) to test your application.</p> 246 247 248 249 250 251 252 253 254 255 256 257 258 259<h2 id="3.2">Android 3.2</h2> 260 261 262 263<div class="toggle-content closed"> 264 265 <p><a href="#" onclick="return toggleContent(this)"> 266 <img src="{@docRoot}assets/images/triangle-closed.png" 267class="toggle-content-img" alt="" /> 268 Android 3.2, Revision 1</a> <em>(July 2011)</em> 269 </a></p> 270 271 <div class="toggle-content-toggleme" style="padding-left:2em;"> 272 273<dl> 274<dt>Initial release. SDK Tools r12 or higher is recommended.</dt> 275</dl> 276 277 </div> 278</div> 279 280 281 282 283<h3>Emulator Skins</h3> 284 285<p>The downloadable platform includes the following emulator skin:</p> 286 287<ul> 288 <li> 289 WXGA (1280x800, medium density, xlarge screen) 290 </li> 291</ul> 292 293<p>For more information about how to develop an application that displays 294and functions properly on all Android-powered devices, see <a 295href="{@docRoot}guide/practices/screens_support.html">Supporting Multiple 296Screens</a>.</p> 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315<h2 id="3.1">Android 3.1</h2> 316 317 318<div class="toggle-content closed"> 319 320<p><a href="#" onclick="return toggleContent(this)"> 321 <img src="{@docRoot}assets/images/triangle-closed.png" 322class="toggle-content-img" alt="" /> 323 Android 3.1, Revision 3</a> <em>(July 2011)</em> 324</a></p> 325 326<div class="toggle-content-toggleme" style="padding-left:2em;"> 327 328<dl> 329<dt>Dependencies:</dt> 330<dd> 331<p>Requires <a href="{@docRoot}tools/sdk/tools-notes.html">SDK Tools r12</a> or 332higher.</p> 333</dd> 334<dt>Notes:</dt> 335<dd> 336<p>Improvements to the platform's rendering library to support the visual layout editor in the ADT 337Eclipse plugin. This revision allows for more drawing features in ADT and fixes several 338bugs in the previous rendering library. It also unlocks several editor features that were added in 339ADT 12.</p> 340</dd> 341</dl> 342 343</div> 344</div> 345 346 347<div class="toggle-content closed" > 348 349<p><a href="#" onclick="return toggleContent(this)"> 350 <img src="{@docRoot}assets/images/triangle-closed.png" 351class="toggle-content-img" alt="" /> 352 Android 3.1, Revision 2</a> <em>(May 2011)</em> 353</a></p> 354 355<div class="toggle-content-toggleme" style="padding-left:2em;"> 356 357<dl> 358<dt>Dependencies:</dt> 359<dd> 360<p>Requires <a href="{@docRoot}tools/sdk/tools-notes.html">SDK Tools r11</a> or 361higher.</p> 362</dd> 363<dt>Notes:</dt> 364<dd> 365<p>Fixes an issue with the visual layout editor rendering library that prevented Android 3.1 from 366running in ADT.</p> 367</dd> 368</dl> 369 370</div> 371</div> 372 373 374<div class="toggle-content closed"> 375 376<p><a href="#" onclick="return toggleContent(this)"> 377 <img src="{@docRoot}assets/images/triangle-closed.png" 378class="toggle-content-img" alt="" /> 379 Android 3.1, Revision 1</a> <em>(May 2011)</em> 380</a></p> 381 382<div class="toggle-content-toggleme" style="padding-left:2em;"> 383 384<dl> 385<dt>Dependencies:</dt> 386<dd> 387<p>Requires <a href="{@docRoot}tools/sdk/tools-notes.html">SDK Tools r11</a> or 388higher.</p> 389</dd> 390</dl> 391 392</div> 393</div> 394 395 396<h3>Emulator Skins</h3> 397 398<p>The downloadable platform includes the following emulator skin:</p> 399 400<ul> 401 <li> 402 WXGA (1280x800, medium density, xlarge screen) 403 </li> 404</ul> 405 406<p>For more information about how to develop an application that displays 407and functions properly on all Android-powered devices, see <a 408href="{@docRoot}guide/practices/screens_support.html">Supporting Multiple 409Screens</a>.</p> 410 411 412 413 414 415 416 417 418 419 420 421<h2 id="3.0">Android 3.0</h2> 422 423 424<div class="toggle-content closed" > 425 426<p><a href="#" onclick="return toggleContent(this)"> 427 <img src="{@docRoot}assets/images/triangle-closed.png" 428class="toggle-content-img" alt="" /> 429 Android 3.0, Revision 2</a> <em>(July 2011)</em> 430</a></p> 431 432<div class="toggle-content-toggleme" style="padding-left:2em;"> 433 434<dl> 435<dt>Dependencies:</dt> 436<dd> 437<p>Requires <a href="{@docRoot}tools/sdk/tools-notes.html">SDK Tools r12</a> or 438higher.</p> 439</dd> 440<dt>Notes:</dt> 441<dd> 442<p>Improvements to the platform's rendering library to support the visual layout editor in the ADT 443Eclipse plugin. This revision allows for more drawing features in ADT and fixes several 444bugs in the previous rendering library. It also unlocks several editor features that were added in 445ADT 12.</p> 446</dd> 447</dl> 448 449</div> 450</div> 451 452<div class="toggle-content closed"> 453 454<p><a href="#" onclick="return toggleContent(this)"> 455 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" alt="" /> 456 Android 3.0, Revision 1</a> <em>(February 2011)</em> 457</a></p> 458 459<div class="toggle-content-toggleme" style="padding-left:2em;"> 460 461<dl> 462<dt>Dependencies:</dt> 463<dd> 464<p>Requires <a href="{@docRoot}tools/sdk/tools-notes.html">SDK Tools r10</a> or higher.</p> 465</dd> 466</dl> 467 468</div> 469</div> 470 471 472 473<h3>Emulator Skins</h3> 474 475<p>The downloadable platform includes the following emulator skin:</p> 476 477<ul> 478 <li> 479 WXGA (1280x800, medium density, xlarge screen) 480 </li> 481</ul> 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500<h2 id="2.3.4">Android 2.3.4</h2> 501 502 503 504<p>The sections below provide notes about successive releases of 505the Android 2.3.4 platform component for the Android SDK, as denoted by 506revision number. To determine what revision(s) of the Android 5072.3.4 platforms are installed in your SDK environment, refer to 508the "Installed Packages" listing in the Android SDK and AVD Manager.</p> 509 510<div class="toggle-content closed" > 511 512<p><a href="#" onclick="return toggleContent(this)"> 513 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" alt="" /> 514 Android 2.3.4, Revision 1</a> <em>(May 2011)</em> 515</a></p> 516 517 <div class="toggle-content-toggleme" style="padding-left:2em;"> 518 <dl> 519 <dt>Dependencies:</dt> 520 <dd> 521 <p>Requires SDK Tools r11 or higher.</p> 522 </dd> 523 </dl> 524 </div> 525</div> 526 527 528<h3>Emulator Skins</h3> 529 530<p>The downloadable platform includes a set of emulator skins that you can use 531for modeling your application in different screen sizes and resolutions. The 532emulator skins are:</p> 533 534<ul> 535 <li> 536 QVGA (240x320, low density, small screen) 537 </li> 538 <li> 539 WQVGA400 (240x400, low density, normal screen) 540 </li> 541 <li> 542 WQVGA432 (240x432, low density, normal screen) 543 </li> 544 <li> 545 HVGA (320x480, medium density, normal screen) 546 </li> 547 <li> 548 WVGA800 (480x800, high density, normal screen) 549 </li> 550 <li> 551 WVGA854 (480x854 high density, normal screen) 552 </li> 553</ul> 554 555 556 557 558 559 560 561 562 563 564 565 566 567<h2 id="2.3.3">Android 2.3.3</h2> 568 569 570<div class="toggle-content closed" > 571 572<p><a href="#" onclick="return toggleContent(this)"> 573 <img src="{@docRoot}assets/images/triangle-closed.png" 574class="toggle-content-img" alt="" /> 575 Android 2.3.3, Revision 2</a> <em>(July 2011)</em> 576</a></p> 577 578<div class="toggle-content-toggleme" style="padding-left:2em;"> 579 580<dl> 581<dt>Dependencies:</dt> 582<dd> 583<p>Requires <a href="{@docRoot}tools/sdk/tools-notes.html">SDK Tools r12</a> or 584higher.</p> 585</dd> 586<dt>Notes:</dt> 587<dd> 588<p>Improvements to the platform's rendering library to support the visual layout editor in the ADT 589Eclipse plugin. This revision allows for more drawing features in ADT and fixes several 590bugs in the previous rendering library. It also unlocks several editor features that were added in 591ADT 12.</p> 592</dd> 593</dl> 594 595</div> 596</div> 597 598<div class="toggle-content closed" > 599 600<p><a href="#" onclick="return toggleContent(this)"> 601 <img src="{@docRoot}assets/images/triangle-closed.png" 602class="toggle-content-img" alt="" /> 603 Android 2.3.3, Revision 1</a> <em>(February 2011)</em> 604</a></p> 605 606<div class="toggle-content-toggleme" style="padding-left:2em;"> 607<dl> 608<dt>Dependencies:</dt> 609<dd> 610<p>Requires SDK Tools r9 or higher.</p> 611</dd> 612</dl> 613 614</div> 615</div> 616 617 618<h3>Emulator Skins</h3> 619 620<p>The downloadable platform includes a set of emulator skins that you can use 621for modeling your application in different screen sizes and resolutions. The 622emulator skins are:</p> 623 624<ul> 625 <li> 626 QVGA (240x320, low density, small screen) 627 </li> 628 <li> 629 WQVGA400 (240x400, low density, normal screen) 630 </li> 631 <li> 632 WQVGA432 (240x432, low density, normal screen) 633 </li> 634 <li> 635 HVGA (320x480, medium density, normal screen) 636 </li> 637 <li> 638 WVGA800 (480x800, high density, normal screen) 639 </li> 640 <li> 641 WVGA854 (480x854 high density, normal screen) 642 </li> 643</ul> 644 645 646 647 648 649 650 651 652 653 654 655 656<h2 id="2.3">Android 2.3</h2> 657 658 659 660<p>The sections below provide notes about successive releases of 661the Android 2.3 platform component for the Android SDK, as denoted by 662revision number. To determine what revision(s) of the Android 6632.3 platforms are installed in your SDK environment, refer to 664the "Installed Packages" listing in the Android SDK and AVD Manager.</p> 665 666 667<div class="toggle-content closed" > 668 669<p><a href="#" onclick="return toggleContent(this)"> 670 <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img" alt="" /> 671 Android 2.3, Revision 1</a> <em>(December 2010)</em> 672</a></p> 673 674 <div class="toggle-content-toggleme" style="padding-left:2em;"> 675 <dl> 676 <dt>Dependencies:</dt> 677 <dd> 678 <p>Requires SDK Tools r8 or higher.</p> 679 </dd> 680 </dl> 681 </div> 682</div> 683 684 685<h3>Emulator Skins</h3> 686 687<p>The downloadable platform includes a set of emulator skins that you can use 688for modeling your application in different screen sizes and resolutions. The 689emulator skins are:</p> 690 691<ul> 692 <li> 693 QVGA (240x320, low density, small screen) 694 </li> 695 <li> 696 WQVGA400 (240x400, low density, normal screen) 697 </li> 698 <li> 699 WQVGA432 (240x432, low density, normal screen) 700 </li> 701 <li> 702 HVGA (320x480, medium density, normal screen) 703 </li> 704 <li> 705 WVGA800 (480x800, high density, normal screen) 706 </li> 707 <li> 708 WVGA854 (480x854 high density, normal screen) 709 </li> 710</ul> 711 712 713 714 715 716 717 718 719 720<h2 id="2.2">Android 2.2</h2> 721 722 723<div class="toggle-content closed" > 724 725<p><a href="#" onclick="return toggleContent(this)"> 726 <img src="{@docRoot}assets/images/triangle-closed.png" 727class="toggle-content-img" alt="" /> 728 Android {@sdkPlatformVersion}, Revision 3</a> <em>(July 2011)</em> 729</a></p> 730 731<div class="toggle-content-toggleme" style="padding-left:2em;"> 732 733<dl> 734<dt>Dependencies:</dt> 735<dd> 736<p>Requires <a href="{@docRoot}tools/sdk/tools-notes.html">SDK Tools r12</a> or 737higher.</p> 738</dd> 739<dt>Notes:</dt> 740<dd> 741<p>Improvements to the platform's rendering library to support the visual layout editor in the ADT 742Eclipse plugin. This revision allows for more drawing features in ADT and fixes several 743bugs in the previous rendering library. It also unlocks several editor features that were added in 744ADT 12.</p> 745</dd> 746</dl> 747 748</div> 749</div> 750 751<div class="toggle-content closed" > 752 753<p><a href="#" onclick="return toggleContent(this)"> 754 <img src="{@docRoot}assets/images/triangle-closed.png" 755class="toggle-content-img" alt="" /> 756 Android {@sdkPlatformVersion}, Revision 2</a> <em>(July 2010)</em> 757</a></p> 758 759<div class="toggle-content-toggleme" style="padding-left:2em;"> 760<dt>Dependencies:</dt> 761<dd> 762<p>Requires SDK Tools r6 or higher.</p> 763</dd> 764 765<dt>System Image:</dt> 766<dd> 767<ul> 768<li>Adds default Search Widget.</li> 769<li>Includes proper provisioning for the platform's Backup Manager. For more information about how 770to use the Backup Manager, see <a href="{@docRoot}guide/topics/data/backup.html">Data 771Backup</a>.</li> 772<li>Updates the Android 2.2 system image to FRF91.</li> 773</ul> 774</dd> 775 776</dl> 777 </div> 778</div> 779 780<div class="toggle-content closed"> 781 782<p><a href="#" onclick="return toggleContent(this)"> 783 <img src="{@docRoot}assets/images/triangle-closed.png" 784class="toggle-content-img" alt="" /> 785 Android {@sdkPlatformVersion}, Revision 1</a> <em>(May 2010)</em> 786</a></p> 787 788<div class="toggle-content-toggleme" style="padding-left:2em;"> 789<dl> 790<dt>Dependencies:</dt> 791<dd> 792<p>Requires SDK Tools r6 or higher.</p> 793</dd> 794 795<dt>Tools:</dt> 796<dd> 797<p>Adds support for building with Android library projects. See <a href="tools-notes.html">SDK 798Tools, r6</a> for information.</p> 799</dd> 800 801</dl> 802 </div> 803</div> 804 805 806<h3>Emulator Skins</h3> 807 808<p>The downloadable platform includes a set of emulator skins that you can use 809for modeling your application in different screen sizes and resolutions. The 810emulator skins are:</p> 811 812<ul> 813 <li> 814 QVGA (240x320, low density, small screen) 815 </li> 816 <li> 817 WQVGA (240x400, low density, normal screen) 818 </li> 819 <li> 820 FWQVGA (240x432, low density, normal screen) 821 </li> 822 <li> 823 HVGA (320x480, medium density, normal screen) 824 </li> 825 <li> 826 WVGA800 (480x800, high density, normal screen) 827 </li> 828 <li> 829 WVGA854 (480x854 high density, normal screen) 830 </li> 831</ul>