diff options
Diffstat (limited to 'docs/html/sdk/android-2.1.jd')
| -rw-r--r-- | docs/html/sdk/android-2.1.jd | 243 |
1 files changed, 121 insertions, 122 deletions
diff --git a/docs/html/sdk/android-2.1.jd b/docs/html/sdk/android-2.1.jd index db9c491..7490bae 100644 --- a/docs/html/sdk/android-2.1.jd +++ b/docs/html/sdk/android-2.1.jd @@ -13,20 +13,23 @@ sdk.platform.deployableDate=January 2010 <ol> <li><a href="#features">Platform Highlights</a></li> <li><a href="#relnotes">Revisions</a></li> + <li><a href="#api-level">API Level</a></li> + <li><a href="#api">Framework API Changes</a> <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>Reference</h2> +<ol> +<li><a +href="{@docRoot}sdk/api_diff/{@sdkPlatformApiLevel}/changes.html">API +Differences Report »</a> </li> +</ol> + <h2>See Also</h2> <ol> <li><a href="{@docRoot}sdk/adding-components.html">Adding SDK Components</a></li> @@ -90,7 +93,8 @@ function toggleDiv(link) { </script> <style> .toggleable { -padding: .25em 1em; + padding: .25em 1em 0em 1em; + margin-bottom: 0; } .toggleme { padding: 1em 1em 0 2em; @@ -147,6 +151,115 @@ padding: .25em 1em; </div> </div> + +<h2 id="api-level">API Level</h2> + +<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 +<code>android:minSdkVersion</code> 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> + + +<h2 id="api">Framework API Changes</h2> + +<p>The sections below provide information about changes made to the application +framework API provided by the Android {@sdkPlatformVersion} platform.</p> + +<h3>Live Wallpapers</h3> + +<p>The following additions provide APIs for you to develop animated 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> + +<p>Additionally, if your application uses or provides Live Wallpapers, you must +remember to add a <a +href="{@docRoot}guide/topics/manifest/uses-feature-element.html"><code><uses-feature></code></a> + element to the application's manifest, declaring the attribute +<code>android:name="android.software.live_wallpaper"</code>. For example:</p> + +<pre class="no-pretty-print"> +<uses-feature android:name="android.software.live_wallpaper" /> +</pre> + +<p>When you've published your application, Android Market checks for the +presence of this element and uses it as a filter, ensuring that your application +is not made available to users whose devices do not support Live Wallpapers. +</p> + +<h3>Telephony</h3> + +<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> + +<h3>Views</h3> + +<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> + +<h3>WebKit</h3> + +<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> + <h2 id="apps">Built-in Applications</h2> <p>The system image included in the downloadable platform provides these @@ -262,117 +375,3 @@ emulator skins are:</p> 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 animated 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> - -<p>Additionally, if your application uses or provides Live Wallpapers, you must -remember to add a <a -href="{@docRoot}guide/topics/manifest/uses-feature-element.html"><code><uses-feature></code></a> - element to the application's manifest, declaring the attribute -<code>android:name="android.software.live_wallpaper"</code>. For example:</p> - -<pre class="no-pretty-print"> -<uses-feature android:name="android.software.live_wallpaper" /> -</pre> - -<p>When you've published your application, Android Market checks for the -presence of this element and uses it as a filter, ensuring that your application -is not made available to users whose devices do not support Live Wallpapers. -</p> - -<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> - |