docs/html/sdk/android-1.6.jd - SHIFTPHONES/android_frameworks_base - Gitiles

 page.title=Android 1.6, Release 1
 sdk.platform.version=1.6
 sdk.platform.apiLevel=4
 sdk.platform.majorMinor=minor
 sdk.platform.releaseDate=September 2009
 sdk.platform.deployableDate=October 2009

 @jd:body

 <div id="qv-wrapper">
 <div id="qv">

   <h2>In this document</h2>
   <ol>
 	<li><a href="#features">Platform Highlights</a></li>
 	<li><a href="#apps">Built-in Applications</a></li>
 	<li><a href="#locs">Locales</a></li>
 	<li><a href="#skins">Emulator Skins</a></li>
 	<li><a href="#api">Framework API</a>
         <ol>
 	<li><a href="#api-level">API level</a></li>
 	<li><a href="#api-changes">API changes summary</a></li>
 	<li><a href="{@docRoot}sdk/api_diff/{@sdkPlatformApiLevel}/changes.html">API differences report &raquo;</a> </li>
         </ol></li>
   </ol>

   <h2>See Also</h2>
   <ol>
     <li><a href="{@docRoot}sdk/adding-components.html">Adding SDK Components</a></li>
   </ol>

 </div>
 </div>

 <p>
 <em>Date:</em> {@sdkPlatformReleaseDate}<br />
 <em>API Level:</em>&nbsp;<strong>{@sdkPlatformApiLevel}</strong></p>

 <p>Android {@sdkPlatformVersion} is a {@sdkPlatformMajorMinor} platform release
 deployable to Android-powered handsets starting in {@sdkPlatformDeployableDate}.
 The release includes new features for users and developers, as well as changes
 in the Android framework API. </p>

 <p>For developers, the Android {@sdkPlatformVersion} platform is available as a
 downloadable component for the Android SDK. The downloadable platform includes a
 fully compliant Android library and system image, as well as a set of emulator
 skins, sample applications, and more. The downloadable platform is fully
 compliant and includes no external libraries. </p>

 <p>To get started developing or testing against the Android
 {@sdkPlatformVersion} platform, use the Android SDK and AVD Manager tool to
 download the platform into your Android 1.6 or later SDK. For more information,
 see <a href="{@docRoot}sdk/adding-components.html">Adding SDK
 Components</a>.</p>


 <h2 id="features">Platform Highlights</h2>

 <p>For a list of new user features and platform highlights, see the <a
 href="http://developer.android.com/sdk/android-{@sdkPlatformVersion}-highlights.html">Android
 {@sdkPlatformVersion} Platform Highlights</a> document.</p>


 <h2 id="apps">Built-in Applications</h2>

 <p>The system image included in the downloadable platform provides these
 built-in applications:</p>

 <table style="border:0;padding-bottom:0;margin-bottom:0;">
 <tr>
 <td style="border:0;padding-bottom:0;margin-bottom:0;">
 	<ul>
 	<li>Alarm Clock</li>
 	<li>Browser</li>
 	<li>Calculator</li>
 	<li>Camcorder</li>
 	<li>Camera</li>
 	<li>Contacts</li>
 	<li>Custom Locale (developer app)</li>
 	<li>Dev Tools (developer app)</li>
 	<li>Dialer</li>
 	</ul>
 </td>
 <td style="border:0;padding-bottom:0;margin-bottom:0;padding-left:5em;">
 	<ul>
 	<li>Email</li>
 	<li>Gallery</li>
 	<li>Gestures Builder</li>
 	<li>IME for Japanese text input</li>
 	<li>Messaging</li>
 	<li>Music</li>
 	<li>Settings</li>
 	<li>Spare Parts (developer app)</li>
 	</ul>
 </td>
 </tr>
 </table>

 <h2 id="locs" style="margin-top:.75em;">Locales</h2>

 <p>The system image included in the downloadable platform provides a variety of
 built-in locales. In some cases, region-specific strings are available for the
 locales. In other cases, a default version of the language is used. The
 languages that are available in the Android {@sdkPlatformVersion} system
 image are listed below (with <em>language</em>_<em>country/region</em>
 locale descriptor).</p>

 <table style="border:0;margin-bottom:0;padding-bottom:0;">
 <tr>
 <td style="border:0;padding-bottom:0;margin-bottom:0;">
 <ul>
 <li>Chinese, PRC (zh_CN)</li>
 <li>Chinese, Taiwan (zh_TW)</li>
 <li>Czech (cs_CZ)</li>
 <li>Dutch, Netherlands (nl_NL)</li>
 <li>Dutch, Belgium (nl_BE)</li>
 <li>English, US (en_US)</li>
 <li>English, Britain (en_GB)</li>
 <li>English, Canada (en_CA)</li>
 <li>English, Australia (en_AU)</li>
 <li>English, New Zealand (en_NZ)</li>
 <li>English, Singapore(en_SG)</li>
 <li>French, France (fr_FR)</li>
 <li>French, Belgium (fr_BE)</li>
 </ul>
 </td>
 <td style="border:0;padding-bottom:0;margin-bottom:0;padding-left:5em;">
 <li>French, Canada (fr_CA)</li>
 <li>French, Switzerland (fr_CH)</li>
 <li>German, Germany (de_DE)</li>
 <li>German, Austria (de_AT)</li>
 <li>German, Switzerland (de_CH)</li>
 <li>German, Liechtenstein (de_LI)</li>
 <li>Italian, Italy (it_IT)</li>
 <li>Italian, Switzerland (it_CH)</li>
 <li>Japanese (ja_JP)</li>
 <li>Korean (ko_KR)</li>
 <li>Polish (pl_PL)</li>
 <li>Russian (ru_RU)</li>
 <li>Spanish (es_ES)</li>
 </td>
 </tr>
 </table>

 <p>Localized UI strings match the locales that are accessible
 through Settings.</p>

 <h2 id="skins">Emulator Skins</h2>

 <p>The downloadable platform includes a set of emulator skins that you can use for modeling your application in different screen sizes and resolutions. The emulator skins are: </p>

 <ul>
   <li>
     QVGA (240x320, low density, small screen)
   </li>
   <li>
     HVGA (320x480, medium density, normal screen)
   </li>
   <li>
     WVGA800 (480x800, high density, normal screen)
   </li>
   <li>
     WVGA854 (480x854 high density, normal screen)
   </li>
 </ul>

 <p>For more information about how to develop an application that displays and functions properly on all Android-powered devices, see <a href="{@docRoot}guide/practices/screens_support.html">Supporting Multiple Screens</a>.</p>


 <h2 id="api">Framework API</h2>

 <p>The sections below provide information about the application framework API provided by the Android {@sdkPlatformVersion} platform. </p>


 <h3 id="api-level">API level</h3>

 <p>The Android {@sdkPlatformVersion} platform delivers an updated version of the framework
 API. As with previous versions, the Android {@sdkPlatformVersion} API
 is assigned an integer identifier &mdash; <strong>{@sdkPlatformApiLevel}</strong> &mdash; that is
 stored in the system itself. This identifier, called the "API Level", allows the
 system to correctly determine whether an application is compatible with
 the system, prior to installing the application. </p>

 <p>To use APIs introduced in Android {@sdkPlatformVersion} in your application, you need to
 set the proper value, "{@sdkPlatformApiLevel}", in the attributes of the <code>&lt;uses-sdk&gt;</code>
 element in your application's manifest. </p>

 <p>For more information about how to use API Level, see the <a
 href="{@docRoot}guide/appendix/api-levels.html">API Levels</a> document. </p>

 <h3 id="api-changes">API changes summary</h3>

 <h4 id="UIFramework">UI framework</h4>
     <ul>
       <li>New classes in {@link android.view.animation}
       to control the behavior of animations:
         <ul>
           <li><code>AnticipateInterpolator</code></li>
           <li><code>AnticipateOvershootInterpolator</code></li>
           <li><code>BounceInterpolator</code></li>
           <li><code>OvershootInterpolator</code></li>
         </ul>
       </li>
       <li>New XML attribute <code>android:onClick</code> to specify a View's
 <a href="/reference/android/view/View.OnClickListener.html">View.OnClickListener</a>
 from a layout file.
       </li>
       <li>New support for dealing with varying screen densities. Density
 information is associated with Bitmap and Canvas for performing the
 correct scaling. The framework will automatically scale bitmaps and
 nine-patches based on the density the resource was found under and the
 density of the screen, etc.
       </li><p>To use APIs introduced in Android {@sdkPlatformVersion} in your application, you need to
 set the proper value, "{@sdkPlatformApiLevel}", in the attributes of the <code>&lt;uses-sdk&gt;</code>
 element in your application's manifest. </p>
     </ul>

 <h4>Search framework</h4>
   <ul>
     <li>Applications can now expose relevant content to users as search
 suggestions in the Quick Search Box, a new device-wide search capability that is
 accessible from the home screen. To support this, the search framework adds new
 attributes to the searchable metadata file. For complete information, see the
 {@link android.app.SearchManager SearchManager} documentation.
     </li>
   </ul>

 <h4>Accessibility framework</h4>
   <ul>
     <li>New {@link android.view.accessibility android.accessibility} package
 that includes classes for capturing accessibility events and forwarding them to
 an {@link android.accessibilityservice AccessibilityService} handler. </li>
     <li>New {@link android.accessibilityservice AccessibilityService} package
 that lets your application track user events and provide visual, audible, or
 haptic feedback to the user. </li>
   </ul>

 <h4>Gesture Input</h4>
   <ul>
     <li>New {@link android.gesture gesture} API for creating, recognizing,
 loading, and saving gestures.</li>
   </ul>

 <h4>Text-to-speech</h4>
   <ul>
     <li>New {@link android.speech.tts android.speech.tts} package provides
 classes for synthesizing speech from text, for immediate playback or to create a
 sound file.</li>
   </ul>

 <h4>Graphics</h4>
   <ul>
     <li>Classes in {@link android.graphics android.graphics} now support scaling
 for different screen densities.</li>
   </ul>

 <h4>Telephony</h4>
   <ul>
     <li>New {@link android.telephony.SmsManager SmsManager} and other classes
 for sending and receiving SMS messages.</li>
   </ul>

 <h4>Utilities</h4>
   <ul>
     <li>New {@link android.util.DisplayMetrics DisplayMetrics} fields for
 determining the density of the current device screen.</li>
   </ul>

 <h4 id="AndroidManifest">Android Manifest elements</h4>

     <ul>
       <li>New <a href="{@docRoot}guide/topics/manifest/supports-screens-element.html">{@code
       &lt;supports-screens>}</a> element lets you specify the device screen sizes that your
       application is designed and tested to support, where "size" is a combination
       of resolution and density. If your application is run on a device whose screen
       size is not specified in the <code>&lt;supports-screen&gt;</code> element, the system
       displays the application in <em>compatibility mode</em>, which performs best-effort scaling
       of the application UI to match the resolution and density of the screen.

     <p>The attributes available for defining an application's screen support are:

         <ul>

           <li><code>smallScreen</code>: Boolean value that indicates whether the
             application is designed to run on devices with small screens.
             Examples: QVGA low density; VGA high density.
           </li>
           <li><code>normalScreens</code>: Boolean value that indicates whether
             the application is designed to run on devices with normal screens.
             Examples: WQVGA low density; HVGA medium density; WVGA high density.
           </li>
           <li><code>largeScreens</code>: Boolean value that indicates whether
             the application is designed to run on devices with significantly
             larger screens, such that special care may be required on
             the application's part to make proper use of the screen area.
             Examples: VGA medium density; WVGA medium density.
           </li>
           <li><code>anyDensity</code>: Boolean value that indicates whether
             the application can accommodate any screen density.
           </li>
           <li><code>resizable</code>: Boolean value that indicates whether
             the application can expand its layout to fit slightly larger screens.
           </li>
         </ul>
     </p>
     </li>

       <li>New <a href="{@docRoot}guide/topics/manifest/uses-feature-element.html">{@code &lt;uses-feature>}</a>
         element lets an application specify hardware (or other)
         features that it requires to function normally. When an application
         specifies such features, the system allows the application to be installed only
         on devices that offer the required features. The element supports these
         attributes:
         <ul>
           <li><code>name</code>: The name of the feature required by the application. Currently accepts
           "android.hardware.camera" and "android.hardware.camera.autofocus" values, which specify that a
           camera and camera autofocus are required, respectively.</li>
           <li><code>glEsVersion</code>: Indicates the minimum version of OpenGL ES required.</li>
         </ul>
       </li>
       <li>New attributes for the
       <a href="{@docRoot}guide/topics/manifest/uses-sdk-element.html">{@code &lt;uses-sdk>}</a> element:
         <ul>
           <li><code>maxSdkVersion</code>: This indicates the maximum API Level on which an application is
           designed to run. If an application declares this attribute, the Android system prevents the user
           from installing the application if the system's API Level is higher than the value specified in
           this attribute. </li>
           <li><code>targetSdkVersion</code>: This indicates the API Level that the application is targeting.
           It is able to run on older versions (down to minSdkVersion), but was explicitly tested to
           work with the version specified here. Specifying this version allows the platform to
           disable compatibility code that is not required or enable newer features that are not
           available to older applications. </li>
         </ul>
       </li>

       </li>
     </ul>

 <h4>New Permissions</h4>

     <ul>
       <li>{@link android.Manifest.permission#CHANGE_WIFI_MULTICAST_STATE
           CHANGE_WIFI_MULTICAST_STATE}: Allows applications to enter Wi-Fi
           Multicast mode.
       </li>
       <li>{@link android.Manifest.permission#GLOBAL_SEARCH}: Allows the
           global search system to access the data of a specified content provider.
       </li>
       <li>{@link android.Manifest.permission#INSTALL_LOCATION_PROVIDER INSTALL_LOCATION_PROVIDER}:
           Allows an application to install a location provider into the Location Manager.
       </li>
       <li>{@link android.Manifest.permission#READ_HISTORY_BOOKMARKS READ_HISTORY_BOOKMARKS}:
           Allows an application to read (but not write) the user's browsing history
           and bookmarks.
       </li>
       <li>{@link android.Manifest.permission#WRITE_HISTORY_BOOKMARKS WRITE_HISTORY_BOOKMARKS}:
           Allows an application to write (but not read) the user's browsing history
           and bookmarks.
       </li>
       <li>{@link android.Manifest.permission#WRITE_EXTERNAL_STORAGE WRITE_EXTERNAL_STORAGE}:
           Allows an application to write to external storage. Applications using API Level 3
           and lower will be implicitly granted this permission (and this will be visible to
           the user); Applications using API Level 4 or higher must explicitly request this
           permission.
       </li>
     </ul>


 <h3 id="api-diff">API differences report</h3>

 <p>For a detailed view of API changes in Android {@sdkPlatformVersion} (API Level {@sdkPlatformApiLevel}), as compared to
 the previous version, see the <a href="{@docRoot}sdk/api_diff/{@sdkPlatformApiLevel}/changes.html">API
 Differences Report</a>.</p>
	page.title=Android 1.6, Release 1
	sdk.platform.version=1.6
	sdk.platform.apiLevel=4
	sdk.platform.majorMinor=minor
	sdk.platform.releaseDate=September 2009
	sdk.platform.deployableDate=October 2009

	@jd:body

	<div id="qv-wrapper">
	<div id="qv">

	<h2>In this document</h2>
	<ol>
	<li><a href="#features">Platform Highlights</a></li>
	<li><a href="#apps">Built-in Applications</a></li>
	<li><a href="#locs">Locales</a></li>
	<li><a href="#skins">Emulator Skins</a></li>
	<li><a href="#api">Framework API</a>
	<ol>
	<li><a href="#api-level">API level</a></li>
	<li><a href="#api-changes">API changes summary</a></li>
	<li><a href="{@docRoot}sdk/api_diff/{@sdkPlatformApiLevel}/changes.html">API differences report »</a> </li>
	</ol></li>
	</ol>

	<h2>See Also</h2>
	<ol>
	<li><a href="{@docRoot}sdk/adding-components.html">Adding SDK Components</a></li>
	</ol>

	</div>
	</div>

	<p>
	<em>Date:</em> {@sdkPlatformReleaseDate}<br />
	<em>API Level:</em> <strong>{@sdkPlatformApiLevel}</strong></p>

	<p>Android {@sdkPlatformVersion} is a {@sdkPlatformMajorMinor} platform release
	deployable to Android-powered handsets starting in {@sdkPlatformDeployableDate}.
	The release includes new features for users and developers, as well as changes
	in the Android framework API. </p>

	<p>For developers, the Android {@sdkPlatformVersion} platform is available as a
	downloadable component for the Android SDK. The downloadable platform includes a
	fully compliant Android library and system image, as well as a set of emulator
	skins, sample applications, and more. The downloadable platform is fully
	compliant and includes no external libraries. </p>

	<p>To get started developing or testing against the Android
	{@sdkPlatformVersion} platform, use the Android SDK and AVD Manager tool to
	download the platform into your Android 1.6 or later SDK. For more information,
	see <a href="{@docRoot}sdk/adding-components.html">Adding SDK
	Components</a>.</p>


	<h2 id="features">Platform Highlights</h2>

	<p>For a list of new user features and platform highlights, see the <a
	href="http://developer.android.com/sdk/android-{@sdkPlatformVersion}-highlights.html">Android
	{@sdkPlatformVersion} Platform Highlights</a> document.</p>


	<h2 id="apps">Built-in Applications</h2>

	<p>The system image included in the downloadable platform provides these
	built-in applications:</p>

	<table style="border:0;padding-bottom:0;margin-bottom:0;">
	<tr>
	<td style="border:0;padding-bottom:0;margin-bottom:0;">
	<ul>
	<li>Alarm Clock</li>
	<li>Browser</li>
	<li>Calculator</li>
	<li>Camcorder</li>
	<li>Camera</li>
	<li>Contacts</li>
	<li>Custom Locale (developer app)</li>
	<li>Dev Tools (developer app)</li>
	<li>Dialer</li>
	</ul>
	</td>
	<td style="border:0;padding-bottom:0;margin-bottom:0;padding-left:5em;">
	<ul>
	<li>Email</li>
	<li>Gallery</li>
	<li>Gestures Builder</li>
	<li>IME for Japanese text input</li>
	<li>Messaging</li>
	<li>Music</li>
	<li>Settings</li>
	<li>Spare Parts (developer app)</li>
	</ul>
	</td>
	</tr>
	</table>

	<h2 id="locs" style="margin-top:.75em;">Locales</h2>

	<p>The system image included in the downloadable platform provides a variety of
	built-in locales. In some cases, region-specific strings are available for the
	locales. In other cases, a default version of the language is used. The
	languages that are available in the Android {@sdkPlatformVersion} system
	image are listed below (with <em>language</em>_<em>country/region</em>
	locale descriptor).</p>

	<table style="border:0;margin-bottom:0;padding-bottom:0;">
	<tr>
	<td style="border:0;padding-bottom:0;margin-bottom:0;">
	<ul>
	<li>Chinese, PRC (zh_CN)</li>
	<li>Chinese, Taiwan (zh_TW)</li>
	<li>Czech (cs_CZ)</li>
	<li>Dutch, Netherlands (nl_NL)</li>
	<li>Dutch, Belgium (nl_BE)</li>
	<li>English, US (en_US)</li>
	<li>English, Britain (en_GB)</li>
	<li>English, Canada (en_CA)</li>
	<li>English, Australia (en_AU)</li>
	<li>English, New Zealand (en_NZ)</li>
	<li>English, Singapore(en_SG)</li>
	<li>French, France (fr_FR)</li>
	<li>French, Belgium (fr_BE)</li>
	</ul>
	</td>
	<td style="border:0;padding-bottom:0;margin-bottom:0;padding-left:5em;">
	<li>French, Canada (fr_CA)</li>
	<li>French, Switzerland (fr_CH)</li>
	<li>German, Germany (de_DE)</li>
	<li>German, Austria (de_AT)</li>
	<li>German, Switzerland (de_CH)</li>
	<li>German, Liechtenstein (de_LI)</li>
	<li>Italian, Italy (it_IT)</li>
	<li>Italian, Switzerland (it_CH)</li>
	<li>Japanese (ja_JP)</li>
	<li>Korean (ko_KR)</li>
	<li>Polish (pl_PL)</li>
	<li>Russian (ru_RU)</li>
	<li>Spanish (es_ES)</li>
	</td>
	</tr>
	</table>

	<p>Localized UI strings match the locales that are accessible
	through Settings.</p>

	<h2 id="skins">Emulator Skins</h2>

	<p>The downloadable platform includes a set of emulator skins that you can use for modeling your application in different screen sizes and resolutions. The emulator skins are: </p>

	<ul>
	<li>
	QVGA (240x320, low density, small screen)
	</li>
	<li>
	HVGA (320x480, medium density, normal screen)
	</li>
	<li>
	WVGA800 (480x800, high density, normal screen)
	</li>
	<li>
	WVGA854 (480x854 high density, normal screen)
	</li>
	</ul>

	<p>For more information about how to develop an application that displays and functions properly on all Android-powered devices, see <a href="{@docRoot}guide/practices/screens_support.html">Supporting Multiple Screens</a>.</p>


	<h2 id="api">Framework API</h2>

	<p>The sections below provide information about the application framework API provided by the Android {@sdkPlatformVersion} platform. </p>


	<h3 id="api-level">API level</h3>

	<p>The Android {@sdkPlatformVersion} platform delivers an updated version of the framework
	API. As with previous versions, the Android {@sdkPlatformVersion} API
	is assigned an integer identifier — <strong>{@sdkPlatformApiLevel}</strong> — that is
	stored in the system itself. This identifier, called the "API Level", allows the
	system to correctly determine whether an application is compatible with
	the system, prior to installing the application. </p>

	<p>To use APIs introduced in Android {@sdkPlatformVersion} in your application, you need to
	set the proper value, "{@sdkPlatformApiLevel}", in the attributes of the <code><uses-sdk></code>
	element in your application's manifest. </p>

	<p>For more information about how to use API Level, see the <a
	href="{@docRoot}guide/appendix/api-levels.html">API Levels</a> document. </p>

	<h3 id="api-changes">API changes summary</h3>

	<h4 id="UIFramework">UI framework</h4>
	<ul>
	<li>New classes in {@link android.view.animation}
	to control the behavior of animations:
	<ul>
	<li><code>AnticipateInterpolator</code></li>
	<li><code>AnticipateOvershootInterpolator</code></li>
	<li><code>BounceInterpolator</code></li>
	<li><code>OvershootInterpolator</code></li>
	</ul>
	</li>
	<li>New XML attribute <code>android:onClick</code> to specify a View's
	<a href="/reference/android/view/View.OnClickListener.html">View.OnClickListener</a>
	from a layout file.
	</li>
	<li>New support for dealing with varying screen densities. Density
	information is associated with Bitmap and Canvas for performing the
	correct scaling. The framework will automatically scale bitmaps and
	nine-patches based on the density the resource was found under and the
	density of the screen, etc.
	</li><p>To use APIs introduced in Android {@sdkPlatformVersion} in your application, you need to
	set the proper value, "{@sdkPlatformApiLevel}", in the attributes of the <code><uses-sdk></code>
	element in your application's manifest. </p>
	</ul>

	<h4>Search framework</h4>
	<ul>
	<li>Applications can now expose relevant content to users as search
	suggestions in the Quick Search Box, a new device-wide search capability that is
	accessible from the home screen. To support this, the search framework adds new
	attributes to the searchable metadata file. For complete information, see the
	{@link android.app.SearchManager SearchManager} documentation.
	</li>
	</ul>

	<h4>Accessibility framework</h4>
	<ul>
	<li>New {@link android.view.accessibility android.accessibility} package
	that includes classes for capturing accessibility events and forwarding them to
	an {@link android.accessibilityservice AccessibilityService} handler. </li>
	<li>New {@link android.accessibilityservice AccessibilityService} package
	that lets your application track user events and provide visual, audible, or
	haptic feedback to the user. </li>
	</ul>

	<h4>Gesture Input</h4>
	<ul>
	<li>New {@link android.gesture gesture} API for creating, recognizing,
	loading, and saving gestures.</li>
	</ul>

	<h4>Text-to-speech</h4>
	<ul>
	<li>New {@link android.speech.tts android.speech.tts} package provides
	classes for synthesizing speech from text, for immediate playback or to create a
	sound file.</li>
	</ul>

	<h4>Graphics</h4>
	<ul>
	<li>Classes in {@link android.graphics android.graphics} now support scaling
	for different screen densities.</li>
	</ul>

	<h4>Telephony</h4>
	<ul>
	<li>New {@link android.telephony.SmsManager SmsManager} and other classes
	for sending and receiving SMS messages.</li>
	</ul>

	<h4>Utilities</h4>
	<ul>
	<li>New {@link android.util.DisplayMetrics DisplayMetrics} fields for
	determining the density of the current device screen.</li>
	</ul>

	<h4 id="AndroidManifest">Android Manifest elements</h4>

	<ul>
	<li>New <a href="{@docRoot}guide/topics/manifest/supports-screens-element.html">{@code
	<supports-screens>}</a> element lets you specify the device screen sizes that your
	application is designed and tested to support, where "size" is a combination
	of resolution and density. If your application is run on a device whose screen
	size is not specified in the <code><supports-screen></code> element, the system
	displays the application in <em>compatibility mode</em>, which performs best-effort scaling
	of the application UI to match the resolution and density of the screen.

	<p>The attributes available for defining an application's screen support are:

	<ul>

	<li><code>smallScreen</code>: Boolean value that indicates whether the
	application is designed to run on devices with small screens.
	Examples: QVGA low density; VGA high density.
	</li>
	<li><code>normalScreens</code>: Boolean value that indicates whether
	the application is designed to run on devices with normal screens.
	Examples: WQVGA low density; HVGA medium density; WVGA high density.
	</li>
	<li><code>largeScreens</code>: Boolean value that indicates whether
	the application is designed to run on devices with significantly
	larger screens, such that special care may be required on
	the application's part to make proper use of the screen area.
	Examples: VGA medium density; WVGA medium density.
	</li>
	<li><code>anyDensity</code>: Boolean value that indicates whether
	the application can accommodate any screen density.
	</li>
	<li><code>resizable</code>: Boolean value that indicates whether
	the application can expand its layout to fit slightly larger screens.
	</li>
	</ul>
	</p>
	</li>

	<li>New <a href="{@docRoot}guide/topics/manifest/uses-feature-element.html">{@code <uses-feature>}</a>
	element lets an application specify hardware (or other)
	features that it requires to function normally. When an application
	specifies such features, the system allows the application to be installed only
	on devices that offer the required features. The element supports these
	attributes:
	<ul>
	<li><code>name</code>: The name of the feature required by the application. Currently accepts
	"android.hardware.camera" and "android.hardware.camera.autofocus" values, which specify that a
	camera and camera autofocus are required, respectively.</li>
	<li><code>glEsVersion</code>: Indicates the minimum version of OpenGL ES required.</li>
	</ul>
	</li>
	<li>New attributes for the
	<a href="{@docRoot}guide/topics/manifest/uses-sdk-element.html">{@code <uses-sdk>}</a> element:
	<ul>
	<li><code>maxSdkVersion</code>: This indicates the maximum API Level on which an application is
	designed to run. If an application declares this attribute, the Android system prevents the user
	from installing the application if the system's API Level is higher than the value specified in
	this attribute. </li>
	<li><code>targetSdkVersion</code>: This indicates the API Level that the application is targeting.
	It is able to run on older versions (down to minSdkVersion), but was explicitly tested to
	work with the version specified here. Specifying this version allows the platform to
	disable compatibility code that is not required or enable newer features that are not
	available to older applications. </li>
	</ul>
	</li>

	</li>
	</ul>

	<h4>New Permissions</h4>

	<ul>
	<li>{@link android.Manifest.permission#CHANGE_WIFI_MULTICAST_STATE
	CHANGE_WIFI_MULTICAST_STATE}: Allows applications to enter Wi-Fi
	Multicast mode.
	</li>
	<li>{@link android.Manifest.permission#GLOBAL_SEARCH}: Allows the
	global search system to access the data of a specified content provider.
	</li>
	<li>{@link android.Manifest.permission#INSTALL_LOCATION_PROVIDER INSTALL_LOCATION_PROVIDER}:
	Allows an application to install a location provider into the Location Manager.
	</li>
	<li>{@link android.Manifest.permission#READ_HISTORY_BOOKMARKS READ_HISTORY_BOOKMARKS}:
	Allows an application to read (but not write) the user's browsing history
	and bookmarks.
	</li>
	<li>{@link android.Manifest.permission#WRITE_HISTORY_BOOKMARKS WRITE_HISTORY_BOOKMARKS}:
	Allows an application to write (but not read) the user's browsing history
	and bookmarks.
	</li>
	<li>{@link android.Manifest.permission#WRITE_EXTERNAL_STORAGE WRITE_EXTERNAL_STORAGE}:
	Allows an application to write to external storage. Applications using API Level 3
	and lower will be implicitly granted this permission (and this will be visible to
	the user); Applications using API Level 4 or higher must explicitly request this
	permission.
	</li>
	</ul>


	<h3 id="api-diff">API differences report</h3>

	<p>For a detailed view of API changes in Android {@sdkPlatformVersion} (API Level {@sdkPlatformApiLevel}), as compared to
	the previous version, see the <a href="{@docRoot}sdk/api_diff/{@sdkPlatformApiLevel}/changes.html">API
	Differences Report</a>.</p>