1page.title=Android 2.1 Platform 2sdk.platform.version=2.1 3sdk.platform.apiLevel=7 4sdk.platform.majorMinor=minor 5 6@jd:body 7 8<div id="qv-wrapper"> 9<div id="qv"> 10 11<h2>In this document</h2> 12<ol> 13 <li><a href="#features">Platform Highlights</a></li> 14 <li><a href="#relnotes">Revisions</a></li> 15 <li><a href="#api-level">API Level</a></li> 16 <li><a href="#api">Framework API Changes</a> 17 <li><a href="#apps">Built-in Applications</a></li> 18 <li><a href="#locs">Locales</a></li> 19 <li><a href="#skins">Emulator Skins</a></li> 20 21 </ol> 22 </li> 23</ol> 24 25<h2>Reference</h2> 26<ol> 27<li><a 28href="{@docRoot}sdk/api_diff/{@sdkPlatformApiLevel}/changes.html">API 29Differences Report »</a> </li> 30</ol> 31 32<h2>See Also</h2> 33<ol> 34 <li><a href="{@docRoot}sdk/adding-components.html">Adding SDK Components</a></li> 35</ol> 36 37</div> 38</div> 39 40<p> 41<em>API Level:</em> <strong>{@sdkPlatformApiLevel}</strong></p> 42 43<p>Android {@sdkPlatformVersion} is a {@sdkPlatformMajorMinor} platform release 44deployable to Android-powered handsets starting in January 2010. 45This release includes new API 46changes and bug fixes. For information on changes, see the <a href="#api">Framework API</a> 47section.</p> 48 49<p>For developers, the Android {@sdkPlatformVersion} platform is available as a 50downloadable component for the Android SDK. The downloadable platform includes a 51fully compliant Android library and system image, as well as a set of emulator 52skins, sample applications, and more. The downloadable platform 53includes no external libraries. </p> 54 55<p>To get started developing or testing against the Android 56{@sdkPlatformVersion} platform, use the Android SDK and AVD Manager tool to 57download the platform into your SDK. For more information, 58see <a href="{@docRoot}sdk/adding-components.html">Adding SDK 59Components</a>.</p> 60 61 62<h2 id="features">Platform Highlights</h2> 63 64<p>Android {@sdkPlatformVersion} does not add significant user features, see the <a 65href="http://developer.android.com/sdk/android-2.0-highlights.html">Android 662.0 Platform Highlights</a> document for the latest user features.</p> 67 68<h2 id="relnotes">Revisions</h2> 69 70<p>The sections below provide notes about successive releases of 71the Android {@sdkPlatformVersion} platform component for the Android SDK, as denoted by 72revision number. To determine what revision(s) of the Android 73{@sdkPlatformVersion} platforms are installed in your SDK environment, refer to 74the "Installed Packages" listing in the Android SDK and AVD Manager.</p> 75 76 77<div class="toggle-content opened" style="padding-left:1em;"> 78 79<p><a href="#" onclick="return toggleContent(this)"> 80 <img src="{@docRoot}assets/images/triangle-opened.png" 81class="toggle-content-img" alt="" /> 82 Android {@sdkPlatformVersion}, Revision 3</a> <em>(July 2011)</em> 83</a></p> 84 85<div class="toggle-content-toggleme" style="padding-left:2em;"> 86 87<dl> 88<dt>Dependencies:</dt> 89<dd> 90<p>Requires <a href="{@docRoot}sdk/tools-notes.html">SDK Tools r12</a> or 91higher.</p> 92</dd> 93<dt>Notes:</dt> 94<dd> 95<p>Improvements to the platform's rendering library to support the visual layout editor in the ADT 96Eclipse plugin. This revision allows for more drawing features in ADT and fixes several 97bugs in the previous rendering library. It also unlocks several editor features that were added in 98ADT 12.</p> 99</dd> 100</dl> 101 102</div> 103</div> 104 105<div class="toggle-content closed" style="padding-left:1em;"> 106 107<p><a href="#" onclick="return toggleContent(this)"> 108 <img src="{@docRoot}assets/images/triangle-closed.png" 109class="toggle-content-img" alt="" /> 110 Android {@sdkPlatformVersion}, Revision 2</a> <em>(May 2010)</em> 111</a></p> 112 113<div class="toggle-content-toggleme" style="padding-left:2em;"> 114<dl> 115<dt>Dependencies:</dt> 116<dd> 117<p>Requires SDK Tools r6 or higher.</p> 118</dd> 119 120<dt>Tools:</dt> 121<dd> 122<ul> 123<li>Adds support for library projects in the Ant build system.</li> 124<li>Adds improved layout rendering in ADT’s visual layout editor.</li> 125</ul> 126</dd> 127 128</dl> 129 </div> 130</div> 131 132<div class="toggle-content closed" style="padding-left:1em;"> 133 134<p><a href="#" onclick="return toggleContent(this)"> 135 <img src="{@docRoot}assets/images/triangle-closed.png" 136class="toggle-content-img" alt="" /> 137 Android {@sdkPlatformVersion}, Revision 1</a> <em>(January 2010)</em> 138</a></p> 139 140<div class="toggle-content-toggleme" style="padding-left:2em;"> 141<dl> 142<dt>Dependencies:</dt> 143<dd> 144<p>Requires SDK Tools r4 or higher.</p> 145</dd> 146</dl> 147 </div> 148</div> 149 150 151<h2 id="api-level">API Level</h2> 152 153<p>The Android {@sdkPlatformVersion} platform delivers an updated version of 154the framework API. The Android {@sdkPlatformVersion} API 155is assigned an integer identifier — 156<strong>{@sdkPlatformApiLevel}</strong> — that is 157stored in the system itself. This identifier, called the "API Level", allows the 158system to correctly determine whether an application is compatible with 159the system, prior to installing the application. </p> 160 161<p>To use APIs introduced in Android {@sdkPlatformVersion} in your 162application, you need to set the proper value, "{@sdkPlatformApiLevel}", in the 163<code>android:minSdkVersion</code> attributes of the <code><uses-sdk></code> 164element in your application's manifest. </p> 165 166<p>For more information about how to use API Level, see the <a 167href="{@docRoot}guide/appendix/api-levels.html">API Levels</a> document. </p> 168 169 170<h2 id="api">Framework API Changes</h2> 171 172<p>The sections below provide information about changes made to the application 173framework API provided by the Android {@sdkPlatformVersion} platform.</p> 174 175<h3>Live Wallpapers</h3> 176 177<p>The following additions provide APIs for you to develop animated wallpapers:</p> 178<ul> 179<li>New {@link android.service.wallpaper} package.</li> 180<li>New {@link android.app.WallpaperInfo} class.</li> 181<li>Updated {@link android.app.WallpaperManager}.</li> 182</ul> 183 184<p>Additionally, if your application uses or provides Live Wallpapers, you must 185remember to add a <a 186href="{@docRoot}guide/topics/manifest/uses-feature-element.html"><code><uses-feature></code></a> 187 element to the application's manifest, declaring the attribute 188<code>android:name="android.software.live_wallpaper"</code>. For example:</p> 189 190<pre class="no-pretty-print"> 191<uses-feature android:name="android.software.live_wallpaper" /> 192</pre> 193 194<p>When you've published your application, Android Market checks for the 195presence of this element and uses it as a filter, ensuring that your application 196is not made available to users whose devices do not support Live Wallpapers. 197</p> 198 199<h3>Telephony</h3> 200 201<ul> 202<li>New {@link android.telephony.SignalStrength} class provides information 203about the device's current network signal. This can be acquired from the 204new {@link 205android.telephony.PhoneStateListener#onSignalStrengthsChanged(SignalStrength)} 206callback.</li> 207 208<li>New {@link 209android.telephony.PhoneStateListener#onDataConnectionStateChanged(int,int)} 210callback.</li> 211</ul> 212 213<h3>Views</h3> 214 215<ul> 216<li>New {@link android.view.View} methods {@link android.view.View#isOpaque()} 217and {@link android.view.View#onDrawScrollBars(Canvas)}.</li> 218 219<li>New {@link android.widget.RemoteViews} methods {@link 220android.widget.RemoteViews#addView(int,RemoteViews)} and {@link 221android.widget.RemoteViews#removeAllViews(int)}.</li> 222 223<li>New {@link android.view.ViewGroup} methods {@link 224android.view.ViewGroup#isChildrenDrawingOrderEnabled()} and {@link 225android.view.ViewGroup#setChildrenDrawingOrderEnabled(boolean)}.</li> 226</ul> 227 228<h3>WebKit</h3> 229 230<ul> 231<li>New {@link android.webkit.WebStorage} methods to manipulate web 232storage databases.</li> 233 234<li>New {@link android.webkit.GeolocationPermissions} methods to 235get Geolocation permissions from, and set them on the WebView.</li> 236 237<li>New {@link android.webkit.WebSettings} methods to manage settings for 238app cache, web storage, and zooming based on screen density.</li> 239 240<li>New {@link android.webkit.WebChromeClient} methods for handling video, 241browsing history, custom Views, app cache limits, and more.</li> 242</ul> 243 244</ul> 245 246<!-- 247<h3 id="behavior-changes">Behavior changes</h3> 248 249<h3 id="bug-fixes">Bug fixes</h3> 250--> 251 252<h3 id="api-diff">API differences report</h3> 253 254<p>For a detailed view of all API changes in Android {@sdkPlatformVersion} (API 255Level {@sdkPlatformApiLevel}), as compared to API Level 6, see the <a 256href="{@docRoot}sdk/api_diff/{@sdkPlatformApiLevel}/changes.html">API 257Differences Report</a>.</p> 258 259<h2 id="apps">Built-in Applications</h2> 260 261<p>The system image included in the downloadable platform provides these 262built-in applications:</p> 263 264<table style="border:0;padding-bottom:0;margin-bottom:0;"> 265<tr> 266<td style="border:0;padding-bottom:0;margin-bottom:0;"> 267 <ul> 268 <li>Alarm Clock</li> 269 <li>Browser</li> 270 <li>Calculator</li> 271 <li>Camera</li> 272 <li>Contacts</li> 273 <li>Custom Locale (developer app)</li> 274 <li>Dev Tools (developer app)</li> 275 <li>Email</li> 276 </ul> 277</td> 278<td style="border:0;padding-bottom:0;margin-bottom:0;padding-left:5em;"> 279 <ul> 280 281 <li>Gallery</li> 282 <li>IMEs for Japanese, Chinese, and Latin text input</li> 283 <li>Messaging</li> 284 <li>Music</li> 285 <li>Phone</li> 286 <li>Settings</li> 287 <li>Spare Parts (developer app)</li> 288 </ul> 289</td> 290</tr> 291</table> 292 293 294<h2 id="locs" style="margin-top:.75em;">Locales</h2> 295 296<p>The system image included in the downloadable platform provides a variety of 297built-in locales. In some cases, region-specific strings are available for the 298locales. In other cases, a default version of the language is used. The 299languages that are available in the Android {@sdkPlatformVersion} system 300image are listed below (with <em>language</em>_<em>country/region</em> locale 301descriptor).</p> 302 303<table style="border:0;padding-bottom:0;margin-bottom:0;"> 304<tr> 305<td style="border:0;padding-bottom:0;margin-bottom:0;"> 306<ul> 307<li>Chinese, PRC (zh_CN)</li> 308<li>Chinese, Taiwan (zh_TW)</li> 309<li>Czech (cs_CZ)</li> 310<li>Dutch, Netherlands (nl_NL)</li> 311<li>Dutch, Belgium (nl_BE)</li> 312<li>English, US (en_US)</li> 313<li>English, Britain (en_GB)</li> 314<li>English, Canada (en_CA)</li> 315<li>English, Australia (en_AU)</li> 316<li>English, New Zealand (en_NZ)</li> 317<li>English, Singapore(en_SG)</li> 318<li>French, France (fr_FR)</li> 319<li>French, Belgium (fr_BE)</li> 320</ul> 321</td> 322<td style="border:0;padding-bottom:0;margin-bottom:0;padding-left:5em;"> 323<li>French, Canada (fr_CA)</li> 324<li>French, Switzerland (fr_CH)</li> 325<li>German, Germany (de_DE)</li> 326<li>German, Austria (de_AT)</li> 327<li>German, Switzerland (de_CH)</li> 328<li>German, Liechtenstein (de_LI)</li> 329<li>Italian, Italy (it_IT)</li> 330<li>Italian, Switzerland (it_CH)</li> 331<li>Japanese (ja_JP)</li> 332<li>Korean (ko_KR)</li> 333<li>Polish (pl_PL)</li> 334<li>Russian (ru_RU)</li> 335<li>Spanish (es_ES)</li> 336</td> 337</tr> 338</table> 339 340<p>Localized UI strings match the locales that are accessible 341through Settings.</p> 342 343<h2 id="skins">Emulator Skins</h2> 344 345<p>The downloadable platform includes a set of emulator skins that you can use 346for modeling your application in different screen sizes and resolutions. The 347emulator skins are:</p> 348 349<ul> 350 <li> 351 QVGA (240x320, low density, small screen) 352 </li> 353 <li> 354 WQVGA (240x400, low density, normal screen) 355 </li> 356 <li> 357 FWQVGA (240x432, low density, normal screen) 358 </li> 359 <li> 360 HVGA (320x480, medium density, normal screen) 361 </li> 362 <li> 363 WVGA800 (480x800, high density, normal screen) 364 </li> 365 <li> 366 WVGA854 (480x854 high density, normal screen) 367 </li> 368</ul> 369 370<p>For more information about how to develop an application that displays 371and functions properly on all Android-powered devices, see <a 372href="{@docRoot}guide/practices/screens_support.html">Supporting Multiple 373Screens</a>.</p> 374
