diff options
| -rw-r--r-- | docs/html/images/icon_dashboard.png | bin | 0 -> 1761 bytes | |||
| -rw-r--r-- | docs/html/index.jd | 14 | ||||
| -rw-r--r-- | docs/html/resources/dashboard/platform-versions.jd | 79 | ||||
| -rw-r--r-- | docs/html/resources/resources_toc.cs | 10 | ||||
| -rw-r--r-- | docs/html/sdk/android-2.1.jd | 281 | ||||
| -rw-r--r-- | docs/html/sdk/sdk_toc.cs | 12 | ||||
| -rw-r--r-- | docs/html/sdk/win-usb.jd | 4 | ||||
| -rw-r--r-- | telephony/java/android/telephony/PhoneStateListener.java | 2 |
8 files changed, 392 insertions, 10 deletions
diff --git a/docs/html/images/icon_dashboard.png b/docs/html/images/icon_dashboard.png Binary files differnew file mode 100644 index 0000000..04793e0 --- /dev/null +++ b/docs/html/images/icon_dashboard.png diff --git a/docs/html/index.jd b/docs/html/index.jd index 0d72e80..d340793 100644 --- a/docs/html/index.jd +++ b/docs/html/index.jd @@ -76,11 +76,17 @@ home=true <td colspan="2"><div class="seperator"> </div></td> </tr> <tr> - <td class="imageCell"><a href="http://www.youtube.com/user/androiddevelopers"><img src="{@docRoot}assets/images/video-droid.png" style="padding:0" /></a></td> + <td class="imageCell"><a +href="{@docRoot}resources/dashboard/platform-versions.html"><img +src="{@docRoot}images/icon_dashboard.png" style="padding:0" /></a></td> <td> - <h2 class="green">Watch</h2> - <object width="150" height="140"><param name="movie" value="http://www.youtube.com/v/N6YdwzAvwOA&hl=en&fs=1"></param><param name="allowFullScreen" value="true"></param><param name="allowscriptaccess" value="always"></param><embed src="http://www.youtube.com/v/N6YdwzAvwOA&hl=en&fs=1" type="application/x-shockwave-flash" allowscriptaccess="always" allowfullscreen="true" width="150" height="140"></embed></object> - <p style="margin-top:1em"><a href="{@docRoot}videos/index.html">More Android videos »</a></p> + <h2 class="green">Target Devices</h2> + <p>The Device Dashboard +provides information about deployed Android devices to +help you target suitable device configurations as you build and update your +apps.</p> + <p><a +href="{@docRoot}resources/dashboard/platform-versions.html">Learn more »</a></p> </td> </tr> diff --git a/docs/html/resources/dashboard/platform-versions.jd b/docs/html/resources/dashboard/platform-versions.jd new file mode 100644 index 0000000..2757850 --- /dev/null +++ b/docs/html/resources/dashboard/platform-versions.jd @@ -0,0 +1,79 @@ +page.title=Platform Versions +@jd:body + +<style type="text/css"> +div.dashboard-panel { + max-width:928px; + margin:0 0 1em 0; + padding:20px 20px 0 20px; + border:1px solid #d3ecf5; + border-radius:7px; + -moz-border-radius:7px; + -webkit-border-radius:7px; + background-color: #DAF3FC; + box-shadow:2px 3px 1px #eee; + -moz-box-shadow:2px 3px 1px #eee; + -webkit-box-shadow:2px 3px 1px #eee; + overflow:hidden; +} +#jd-content div.dashboard-panel img { + margin:0 20px 20px 0; + padding:0; + border:1px solid #ccc; + float:left; +} +div.dashboard-panel table { + margin:0 0 20px 0; + float:left; + background-color:#fff; +} +div.dashboard-panel th { + white-space:nowrap; +} +</style> + +<p>This page provides data about the relative number of active devices +running a given version of the Android platform. This can help you +understand the landscape of device distribution and decide how to prioritize +the development of your application features for the devices currently in the +the hands of users.</p> + +<p class="note"><strong>Note:</strong> This data is based on the number +of Android devices that have accessed Android Market within a 14-day period +ending on the data collection date noted below.</p> + +<div class="dashboard-panel"> + +<img alt="" width="400" height="250" +src="http://chart.apis.google.com/chart?cht=p&chs=400x250&chd=t:0.3,27.7,54.2,2.9,14.8&chl=Android%201.1|Android%201.5|Android%201.6|Android%202.0|Android%202.0.1&chco=c4df9b,6fad0c" /> + +<!-- f6faf2,a3c539 --> + +<table> +<tr> + <th>Android Platform</th> + <th>Percent of Devices</th> +</tr> +<tr> + <td>Android 1.1</td> + <td>0.3%</td> +</tr> +<tr> + <td>Android 1.5</td> + <td>27.7%</td> +</tr> +<tr> + <td>Android 1.6</td> + <td>54.2%</td></tr> +<tr> + <td>Android 2.0</td> + <td>2.9%</td> +</tr> +<tr> + <td>Android 2.0.1</td> + <td>14.8%</td> +</tr> +</table> +</div> + +<p><em>Data collected during two weeks ending on 12/14/2009</em></p> diff --git a/docs/html/resources/resources_toc.cs b/docs/html/resources/resources_toc.cs index 54602bf..40ee818 100644 --- a/docs/html/resources/resources_toc.cs +++ b/docs/html/resources/resources_toc.cs @@ -20,6 +20,16 @@ </li> <li> + <h2><span class="en">Device Dashboard</span> + </h2> + <ul> + <li><a href="<?cs var:toroot ?>resources/dashboard/platform-versions.html"> + <span class="en">Platform Versions</span> + </a> <span class="new">new!</span></li> + </ul> + </li> + + <li> <h2><span class="en">Technical Articles</span> </h2> <ul> diff --git a/docs/html/sdk/android-2.1.jd b/docs/html/sdk/android-2.1.jd new file mode 100644 index 0000000..ef6a391 --- /dev/null +++ b/docs/html/sdk/android-2.1.jd @@ -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> + diff --git a/docs/html/sdk/sdk_toc.cs b/docs/html/sdk/sdk_toc.cs index 1690995..556f781 100644 --- a/docs/html/sdk/sdk_toc.cs +++ b/docs/html/sdk/sdk_toc.cs @@ -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> diff --git a/docs/html/sdk/win-usb.jd b/docs/html/sdk/win-usb.jd index 3a5a30f..e0c2431 100644 --- a/docs/html/sdk/win-usb.jd +++ b/docs/html/sdk/win-usb.jd @@ -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 diff --git a/telephony/java/android/telephony/PhoneStateListener.java b/telephony/java/android/telephony/PhoneStateListener.java index 9bfd900..4f9cb2e 100644 --- a/telephony/java/android/telephony/PhoneStateListener.java +++ b/telephony/java/android/telephony/PhoneStateListener.java @@ -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) { |
