From b149ee883502af8ae71757f9098c8e98c8548d25 Mon Sep 17 00:00:00 2001 From: Scott Main Date: Tue, 15 Dec 2009 10:47:31 -0800 Subject: [PATCH] docs: add 2.1 platform notes, win usb driver notes and fix some javadocs for PhonestateListener --- docs/html/sdk/android-2.1.jd | 281 ++++++++++++++++++ docs/html/sdk/sdk_toc.cs | 12 +- docs/html/sdk/win-usb.jd | 4 + .../android/telephony/PhoneStateListener.java | 2 +- 4 files changed, 293 insertions(+), 6 deletions(-) create mode 100644 docs/html/sdk/android-2.1.jd diff --git a/docs/html/sdk/android-2.1.jd b/docs/html/sdk/android-2.1.jd new file mode 100644 index 0000000000000..ef6a3913f1794 --- /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 + +
+ +
+ +

+Date: {@sdkPlatformReleaseDate}
+API Level: {@sdkPlatformApiLevel}

+ +

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 Framework API +section.

+ +

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.

+ +

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 Adding SDK +Components.

+ + +

Platform Highlights

+ +

Android {@sdkPlatformVersion} does not add significant user features, see the Android +2.0 Platform Highlights document for the latest user features.

+ +

Built-in Applications

+ +

The system image included in the downloadable platform provides these +built-in applications:

+ + + + + + +
+
    +
  • Alarm Clock
    • +
  • Browser
    • +
  • Calculator
    • +
  • Camcorder
    • +
  • Camera
    • +
  • Contacts
    • +
  • Custom Locale (developer app)
    • +
  • Dev Tools (developer app)
    • +
  • Dialer
    • +
+		 +
    +
  • Email
    • +
  • Gallery
    • +
  • Gestures Builder
    • +
  • IME for Japanese text input
    • +
  • Messaging
    • +
  • Music
    • +
  • Settings
    • +
  • Spare Parts (developer app)
    • +
+
+ +

Locales

+ +

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 language_country/region locale +descriptor).

+ + + + + + +
+
    +
  • Chinese, PRC (zh_CN)
    • +
  • Chinese, Taiwan (zh_TW)
    • +
  • Czech (cs_CZ)
    • +
  • Dutch, Netherlands (nl_NL)
    • +
  • Dutch, Belgium (nl_BE)
    • +
  • English, US (en_US)
    • +
  • English, Britain (en_GB)
    • +
  • English, Canada (en_CA)
    • +
  • English, Australia (en_AU)
    • +
  • English, New Zealand (en_NZ)
    • +
  • English, Singapore(en_SG)
    • +
  • French, France (fr_FR)
    • +
  • French, Belgium (fr_BE)
    • +
+		 +
  • French, Canada (fr_CA)
    • +
  • French, Switzerland (fr_CH)
    • +
  • German, Germany (de_DE)
    • +
  • German, Austria (de_AT)
    • +
  • German, Switzerland (de_CH)
    • +
  • German, Liechtenstein (de_LI)
    • +
  • Italian, Italy (it_IT)
    • +
  • Italian, Switzerland (it_CH)
    • +
  • Japanese (ja_JP)
    • +
  • Korean (ko_KR)
    • +
  • Polish (pl_PL)
    • +
  • Russian (ru_RU)
    • +
  • Spanish (es_ES)
    • +
    + +

    Localized UI strings match the locales that are accessible +through Settings.

    + +

    Emulator Skins

    + +

    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:

    + + + +

    For more information about how to develop an application that displays +and functions properly on all Android-powered devices, see Supporting Multiple +Screens.

    + +

    Framework API

    + +

    The sections below provide information about changes made to the application +framework API provided by the Android {@sdkPlatformVersion} platform.

    + + +

    API level

    + +

    The Android {@sdkPlatformVersion} platform delivers an updated version of +the framework API. The Android {@sdkPlatformVersion} API +is assigned an integer identifier — +{@sdkPlatformApiLevel} — 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.

    + +

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

    + +

    For more information about how to use API Level, see the API Levels document.

    + + +

    API changes summary

    + +

    The following is a summary of some notable changes to the framework APIs.

    + +

    Live Wallpapers

    + +

    The following additions provide APIs for you to develop active (and +interactive) wallpapers:

    + + +

    Telephony

    + + + +

    Views

    + + + +

    WebKit

    + + + + + + + +

    API differences report

    + +

    For a detailed view of all API changes in Android {@sdkPlatformVersion} (API +Level {@sdkPlatformApiLevel}), as compared to API Level 6, see the API +Differences Report.

    + diff --git a/docs/html/sdk/sdk_toc.cs b/docs/html/sdk/sdk_toc.cs index 1690995438c21..556f78164241b 100644 --- a/docs/html/sdk/sdk_toc.cs +++ b/docs/html/sdk/sdk_toc.cs @@ -61,15 +61,18 @@ diff --git a/docs/html/sdk/win-usb.jd b/docs/html/sdk/win-usb.jd index 3a5a30f2f2e2b..e0c2431d6c06e 100644 --- a/docs/html/sdk/win-usb.jd +++ b/docs/html/sdk/win-usb.jd @@ -36,6 +36,9 @@ Device to start development with a device.

    Revision Notes

    +

    Revision 3

    +

    Adds support for the Nexus One. Released January 2010.

    +

    Revision 2

    Adds support for the Verizon Droid (or similar hardware on other carriers). Released November 2009.

    @@ -55,6 +58,7 @@ devices:

  • T-Mobile G1* / ADP1
  • T-Mobile myTouch 3G* / Google Ion
  • Verizon Droid*
    • +
  • Nexus One

    • * Or similar hardware on other carriers

    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 9bfd900c6e59d..4f9cb2e4f732b 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) {