am d92cc9a4: Merge change I33eb64c0 into eclair
Merge commit 'd92cc9a4ba2cf38f133cc2b51fe1cd0be8659db9' into eclair-plus-aosp * commit 'd92cc9a4ba2cf38f133cc2b51fe1cd0be8659db9': docs: add 2.1 platform notes, win usb driver notes
This commit is contained in:
Scott Main
281
docs/html/sdk/android-2.1.jd
Normal file
281
docs/html/sdk/android-2.1.jd
Normal file
@@ -0,0 +1,281 @@
|
||||
page.title=Android 2.1, Release 1
|
||||
sdk.platform.version=2.1
|
||||
sdk.platform.apiLevel=7
|
||||
sdk.platform.majorMinor=minor
|
||||
sdk.platform.releaseDate=January 2010
|
||||
sdk.platform.deployableDate=January 2010
|
||||
|
||||
@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}.
|
||||
This release includes new API
|
||||
changes and bug fixes. For information on changes, see the <a href="#api">Framework API</a>
|
||||
section.</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
|
||||
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 SDK. For more information,
|
||||
see <a href="{@docRoot}sdk/adding-components.html">Adding SDK
|
||||
Components</a>.</p>
|
||||
|
||||
|
||||
<h2 id="features">Platform Highlights</h2>
|
||||
|
||||
<p>Android {@sdkPlatformVersion} does not add significant user features, see the <a
|
||||
href="http://developer.android.com/sdk/android-2.0-highlights.html">Android
|
||||
2.0 Platform Highlights</a> document for the latest user features.</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;padding-bottom:0;margin-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>
|
||||
WQVGA (240x400, low density, normal screen)
|
||||
</li>
|
||||
<li>
|
||||
FWQVGA (240x432, low density, normal 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 changes made to 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. 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>
|
||||
|
||||
<p>The following is a summary of some notable changes to the framework APIs.</p>
|
||||
|
||||
<h4>Live Wallpapers</h4>
|
||||
|
||||
<p>The following additions provide APIs for you to develop active (and
|
||||
interactive) wallpapers:</p>
|
||||
<ul>
|
||||
<li>New {@link android.service.wallpaper} package.</li>
|
||||
<li>New {@link android.app.WallpaperInfo} class.</li>
|
||||
<li>Updated {@link android.app.WallpaperManager}.</li>
|
||||
</ul>
|
||||
|
||||
<h4>Telephony</h4>
|
||||
|
||||
<ul>
|
||||
<li>New {@link android.telephony.SignalStrength} class provides information
|
||||
about the device's current network signal. This can be acquired from the
|
||||
new {@link
|
||||
android.telephony.PhoneStateListener#onSignalStrengthsChanged(SignalStrength)}
|
||||
callback.</li>
|
||||
|
||||
<li>New {@link
|
||||
android.telephony.PhoneStateListener#onDataConnectionStateChanged(int,int)}
|
||||
callback.</li>
|
||||
</ul>
|
||||
|
||||
<h4>Views</h4>
|
||||
|
||||
<ul>
|
||||
<li>New {@link android.view.View} methods {@link android.view.View#isOpaque()}
|
||||
and {@link android.view.View#onDrawScrollBars(Canvas)}.</li>
|
||||
|
||||
<li>New {@link android.widget.RemoteViews} methods {@link
|
||||
android.widget.RemoteViews#addView(int,RemoteViews)} and {@link
|
||||
android.widget.RemoteViews#removeAllViews(int)}.</li>
|
||||
|
||||
<li>New {@link android.view.ViewGroup} methods {@link
|
||||
android.view.ViewGroup#isChildrenDrawingOrderEnabled()} and {@link
|
||||
android.view.ViewGroup#setChildrenDrawingOrderEnabled(boolean)}.</li>
|
||||
</ul>
|
||||
|
||||
<h4>WebKit</h4>
|
||||
|
||||
<ul>
|
||||
<li>New {@link android.webkit.WebStorage} methods to manipulate web
|
||||
storage databases.</li>
|
||||
|
||||
<li>New {@link android.webkit.GeolocationPermissions} methods to
|
||||
get Geolocation permissions from, and set them on the WebView.</li>
|
||||
|
||||
<li>New {@link android.webkit.WebSettings} methods to manage settings for
|
||||
app cache, web storage, and zooming based on screen density.</li>
|
||||
|
||||
<li>New {@link android.webkit.WebChromeClient} methods for handling video,
|
||||
browsing history, custom Views, app cache limits, and more.</li>
|
||||
</ul>
|
||||
|
||||
</ul>
|
||||
|
||||
<!--
|
||||
<h3 id="behavior-changes">Behavior changes</h3>
|
||||
|
||||
<h3 id="bug-fixes">Bug fixes</h3>
|
||||
-->
|
||||
|
||||
<h3 id="api-diff">API differences report</h3>
|
||||
|
||||
<p>For a detailed view of all API changes in Android {@sdkPlatformVersion} (API
|
||||
Level {@sdkPlatformApiLevel}), as compared to API Level 6, see the <a
|
||||
href="{@docRoot}sdk/api_diff/{@sdkPlatformApiLevel}/changes.html">API
|
||||
Differences Report</a>.</p>
|
||||
|
||||
@@ -61,15 +61,18 @@
|
||||
</li>
|
||||
</ul>
|
||||
<ul>
|
||||
<li><a href="<?cs var:toroot ?>sdk/android-2.0.1.html">Android 2.0.1
|
||||
<li><a href="<?cs var:toroot ?>sdk/android-2.1.html">Android 2.1
|
||||
Platform</a> <span class="new">new!</span>
|
||||
</li>
|
||||
<li><a href="<?cs var:toroot ?>sdk/android-1.6.html">Android 1.6
|
||||
Platform</a> <span class="new">new!</span></li>
|
||||
Platform</a></li>
|
||||
<li><a href="<?cs var:toroot ?>sdk/android-1.5.html">Android 1.5 Platform</a></li>
|
||||
<li class="toggle-list">
|
||||
<div><a href="#" onclick="toggle(this.parentNode.parentNode,true); return false;">Older Platforms</a></div>
|
||||
<ul>
|
||||
<li><a href="<?cs var:toroot ?>sdk/android-2.0.1.html">Android 2.0.1
|
||||
Platform</a>
|
||||
</li>
|
||||
<li><a href="<?cs var:toroot ?>sdk/android-2.0.html">Android 2.0
|
||||
Platform</a>
|
||||
</li>
|
||||
@@ -80,10 +83,9 @@
|
||||
</ul>
|
||||
<ul>
|
||||
<li><a href="<?cs var:toroot ?>sdk/tools-notes.html">SDK Tools, r4</a>
|
||||
<span class="new">new!</span>
|
||||
</li>
|
||||
<li><a href="<?cs var:toroot ?>sdk/win-usb.html">USB Driver for
|
||||
Windows, r2</a>
|
||||
Windows, r3</a> <span class="new">new!</span>
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
@@ -109,7 +111,7 @@ Windows, r2</a>
|
||||
<span style="display:none" class="zh-TW"></span></a>
|
||||
</li>
|
||||
<li><a href="<?cs var:toroot ?>sdk/adt-notes.html">ADT <?cs var:adt.zip.version ?>
|
||||
<span class="new">new!</span></a>
|
||||
</a>
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
|
||||
@@ -36,6 +36,9 @@ Device</a> to start development with a device.</p>
|
||||
|
||||
<h2 id="RevisionNotes">Revision Notes</h2>
|
||||
|
||||
<h4>Revision 3</h4>
|
||||
<p>Adds support for the Nexus One. Released January 2010.</p>
|
||||
|
||||
<h4>Revision 2</h4>
|
||||
<p>Adds support for the Verizon Droid (or similar hardware on
|
||||
other carriers). Released November 2009.</p>
|
||||
@@ -55,6 +58,7 @@ devices:</p>
|
||||
<li>T-Mobile G1* / ADP1</li>
|
||||
<li>T-Mobile myTouch 3G* / Google Ion</li>
|
||||
<li>Verizon Droid*</li>
|
||||
<li>Nexus One</li>
|
||||
</ul>
|
||||
<p>* <em>Or similar hardware on other carriers</em></p>
|
||||
<p>Any additional devices will require Windows drivers provided by
|
||||
|
||||
@@ -153,7 +153,7 @@ public class PhoneStateListener {
|
||||
* @see ServiceState#STATE_IN_SERVICE
|
||||
* @see ServiceState#STATE_OUT_OF_SERVICE
|
||||
* @see ServiceState#STATE_POWER_OFF
|
||||
* @deprecated see #onSignalStrengthsChanged
|
||||
* @deprecated Use {@link #onSignalStrengthsChanged(SignalStrength)}
|
||||
*/
|
||||
@Deprecated
|
||||
public void onSignalStrengthChanged(int asu) {
|
||||
|
||||
Reference in New Issue
Block a user