diff --git a/Android.mk b/Android.mk index 95f38c5ac17f5..5a4c547345b63 100644 --- a/Android.mk +++ b/Android.mk @@ -425,10 +425,10 @@ framework_docs_SDK_CURRENT_DIR:=$(framework_docs_SDK_VERSION)_r$(framework_docs_ framework_docs_SDK_PREVIEW:=0 ## Latest ADT version identifiers, for reference from published docs -framework_docs_ADT_VERSION:=0.9.5 -framework_docs_ADT_DOWNLOAD:=ADT-0.9.5.zip -framework_docs_ADT_BYTES:=3372982 -framework_docs_ADT_CHECKSUM:=227ec538359fbe417ccde7f0ad614a96 +framework_docs_ADT_VERSION:=0.9.6 +framework_docs_ADT_DOWNLOAD:=ADT-0.9.6.zip +framework_docs_ADT_BYTES:=7456339 +framework_docs_ADT_CHECKSUM:=ea45d271be52b87b5dd1c9fb17536223 framework_docs_LOCAL_DROIDDOC_OPTIONS += \ -hdf sdk.version $(framework_docs_SDK_VERSION) \ diff --git a/docs/html/guide/appendix/media-formats.jd b/docs/html/guide/appendix/media-formats.jd index db5a15e10126a..94a6471c9b872 100644 --- a/docs/html/guide/appendix/media-formats.jd +++ b/docs/html/guide/appendix/media-formats.jd @@ -2,7 +2,6 @@ page.title=Android Supported Media Formats @jd:body

The Core Media Formats table below describes the media format support built into the Android platform. Note that any given mobile device may provide support for additional formats or file types not listed in the table.

-

For your convenience, the table T-Mobile G1 Media Formats describes additional media formats and characteristics provided by the T-Mobile G1 device. Other devices may support additional formats not listed on this page.

As an application developer, you are free to make use of any media codec that is available on any Android-powered device, including those provided by the Android platform and those that are device-specific.

@@ -152,56 +151,6 @@ page.title=Android Supported Media Formats -

T-Mobile G1 Media Formats and Characteristics

- -

The table below lists media formats supported by the T-Mobile G1 in addition to those provided as part of the Android platform. This table also details G1-specific performance characteristics of some Android core media formats.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
TypeFormatEncoderDecoderCommentFile Type(s) Supported
AudioWMA XSupports WMA standard L1-L3: -
    -
  • L1: 64 kbps - 161 kbps @ 44.1kHz
    • -
  • L2: <=161 kbps <=48 kHz
    • -
  • L3: <385 kbps <=48 kHz
    • -
-Mono and stereo profiles with 16-bits per sample. Decoder does not support WMA Pro, Lossless, or Speech codecs. -		Windows Media Audio (.wma)
VideoWMV XVersions 7, 8 and 9. Simple profile onlyWindows Media Video (.wmv)
H.264 AVC XOn the G1, this decoder is limited to baseline profile up to 480x320, and 600 kbps average bitrate for the video stream.3GPP (.3gp) and MPEG-4 (.mp4)
diff --git a/docs/html/index.jd b/docs/html/index.jd index e3bf685df530f..913f83d9311eb 100644 --- a/docs/html/index.jd +++ b/docs/html/index.jd @@ -2,7 +2,7 @@ home=true @jd:body -
+
@@ -11,10 +11,10 @@ home=true
- Android developer labs + Android at GDC 2010
-

We're hosting the next Android Developer Lab in Barcelona at Mobile World Congress » on Wednesday February 17th at App Planet », located in Hall 7. Come visit us to attend a technical presentation, talk to our Android developer relations team, and meet other members of the developer community.

Learn more »

- +

Android will be at the 2010 Game Developers Conference in San Francisco, from March 9th to 11th. We're looking forward to seeing you there!

+

Learn more »

diff --git a/docs/html/resources/community-groups.jd b/docs/html/resources/community-groups.jd index a36a425dae0f4..72bdf7aa4f7cd 100644 --- a/docs/html/resources/community-groups.jd +++ b/docs/html/resources/community-groups.jd @@ -2,21 +2,27 @@ community=true page.title=Developer Forums @jd:body -

Welcome to the Android developers community! We're glad you're here and invite you to participate in discussions with other Android application developers on topics that interest you.

+
+
-

The lists on this page are primarily for discussion about Android application development. If you are seeking discussion about Android source code (not application development), then please refer to the Open Source Project Mailing lists.

- -

Contents

-
    -
  1. Stack Overflow new!
    2. -
  2. Mailing lists
      +

      In this document

      +
        +
      1. Android on Stack Overflow
        2. +
      2. Mailing lists +
        1. Before you post
        2. Using email with the mailing lists
        3. Application developer mailing lists
      3. Android Market Help Forum
        4. -
      +
    +
+
+ +

Welcome to the Android developers community! We're glad you're here and invite you to participate in discussions with other Android application developers on topics that interest you.

+ +

The lists on this page are primarily for discussion about Android application development. If you are seeking discussion about Android source code (not application development), then please refer to the Open Source Project Mailing lists.

Stack Overflow

diff --git a/docs/html/resources/community-more.jd b/docs/html/resources/community-more.jd index 2be015a94676a..9f16feaffbf2f 100644 --- a/docs/html/resources/community-more.jd +++ b/docs/html/resources/community-more.jd @@ -2,7 +2,7 @@ community=true page.title=IRC and Twitter @jd:body -

In addition to the Android developer groups, you can also participate in the Android developer community through IRC, and you can also follow us on Twitter.

+

In addition to the Android developer forums, you can participate in the Android developer community through IRC and you can follow us on Twitter.

IRC

@@ -31,10 +31,10 @@ page.title=IRC and Twitter
  • Set your nickname before you join the channel.
  • Registering your nickname prevents others from using your nickname or impersonating you later: -
    /nick <yournickname>
-/msg nickserv register <password> <email>
    +
    /nick <yournickname>
+/msg nickserv register <password> <email>

    Afterwards, when you connect, you'll need to supply a password:

    -
    /connect irc.freenode.net
+
    /connect irc.freenode.net
 /nick <yournickname>
 /msg nickserv identify <password>
 /join #android-dev
    
diff --git a/docs/html/resources/resources_toc.cs b/docs/html/resources/resources_toc.cs
index 097202924d35f..659e08eba20ca 100644
--- a/docs/html/resources/resources_toc.cs
+++ b/docs/html/resources/resources_toc.cs
@@ -171,9 +171,12 @@
@@ -30,58 +25,102 @@ page.title=Adding SDK Components

Adding and updating components in your Android SDK is fast and easy. To perform an update, use the Android SDK and AVD Manager to install or update the individual SDK components that you need. The Android SDK -and AVD Manager tool is included in Android 1.6 and later SDK packages.

+and AVD Manager tool is included in the Android SDK +download.

-

It only takes a couple of clicks to install -individual versions of the Android platform, new development tools, new documentation, and -SDK add-ons. The new SDK components are automatically installed into your existing SDK -directory, so you don't need to update your development environment to specify a -new SDK location.

+

It only takes a couple of clicks to install individual versions of the +Android platform, new development tools, new documentation, and SDK add-ons. The +new SDK components are automatically installed into your existing SDK directory, +so you don't need to update your development environment to specify a new SDK +location.

-

Because each version of the Android platform can be installed as an individual component -of your SDK, you can customize your development environment to the Android platforms -you are targetting. Testing your app on multiple versions of -the platform is very important in order to successfully operate on as many devices as possible. -Be sure to install each version of the Android platform with which your app is compatible, then test -your apps on AVDs that run each platform.

+

Because each version of the Android platform can be installed as an +individual component of your SDK, you can customize your development environment +to the Android platforms you are targetting. Testing your app on multiple +versions of the platform is very important in order to successfully operate on +as many devices as possible. Be sure to install each version of the Android +platform with which your app is compatible, then test your apps on AVDs that run each +platform.

+ +

If you are just getting started and you are not sure what components to install, +see Adding Platforms and Other +Components for information.

If you develop applications using Eclipse, you may also need to update your -ADT plugin when you update your development tools or in order to compile against -a new version of the platform. See the SDK Tools Notes document for ADT -compatibility.

+ADT plugin when you update your development tools, in order to compile against +a new version of the platform. See the revisions listed in the SDK Tools document for ADT +Plugin compatibility.

+ +
+ +

Figure 1. The Android SDK and AVD Manager's +Available Packages +panel, which shows the SDK components that are +available for you to download into your environment.

+
+ +

Launching the Android SDK and AVD Manager

+ +

The Android SDK and AVD Manager is the tool that you use to install and +upgrade SDK components in your development environment.

+ +

You can access the tool in any of three ways:

+ + +

Launching from Eclipse/ADT

+ +

If you are developing in Eclipse and have already installed the ADT Plugin, +follow these steps to access the Android SDK and AVD Manager tool:

+ +
    +
  1. Open Eclipse
    2. +
  2. Select Window > Android SDK and AVD +Manager.
    3. +
+ +

Launching from the setup script (Windows only)

+ +

For Windows only, the SDK includes a script that invokes the Android SDK and +AVD Manager. To launch the tool using the script, double-click "SDK +Setup.exe" at the root of the the SDK directory.

+ +

Launching from a command line

+ +

In all development environments, follow these steps to access the Android SDK +and AVD Manager tool from the command line:

+ +
    +
  1. Navigate to the <sdk>/tools/ directory.
    2. +
  2. Execute the {@code android} tool command with no options. + 
    $ android
    3. +

Installing SDK Components

-

Use the Android SDK and AVD Manager to install new SDK components.

-

Important: Before you install SDK components, we recommend that you disable any antivirus programs that may be running on your computer.

-

You can launch the SDK and AVD Manager in one of these ways:

- +

Follow these steps to install new SDK components in your environment:

- - -

When a new platform version, add-on, set of development tools or -documentation becomes available, you can quickly install them into your existing -Android SDK:

    -
  1. Select Available Components in the left panel. - This will reveal all components currently available for download.
    2. -
  2. Select the components you'd like to install and click Install - Selected.
    3. +
  3. Launch the Android SDK and AVD Manager as described in the section above.
    4. +
  4. Select Available Packages in the left panel. + This will reveal all of the components that are currently available for download + from the SDK repository.
    5. +
  5. Select the component(s) you'd like to install and click Install + Selected. If you aren't sure which packages to select, read Which components do I need?.
  6. Verify and accept the components you want and click Install Accepted. The components will now be installed into your existing Android SDK directories.
    7. @@ -93,14 +132,56 @@ new add-ons are saved in the <sdk>/add-ons/ directory; and new documentation is saved in the existing <sdk>/docs/ directory (old docs are replaced).

    + +

    Updating SDK Components

    + +

    From time to time, new revisions of existing SDK components are released and +made available to you through the SDK repository. In most cases, if you have those +components installed in your environment, you will want +to download the new revisions as soon as possible.

    + +

    You can learn about the release of new revisions in two ways:

    + + + +

    When you see that a new revision is available, you can use the Android SDK +and AVD Manager to quickly download it to your environment. Follow the same +procedure as given in Installing SDK Components, above. The new +component is installed in place of the old, but without impacting your +applications.

    +

    Tip: Use the "Display updates only" checkbox to show only the components you do not have.

    -

    Adding New Sites

    +

    SDK Component Dependencies

    -

    By default, Available Components only shows the default +

    In some cases, an SDK component may require a specific minimum revision of +another component or SDK tool. Where such dependencies exist, they are +documented in the revision notes for each component, available from the links in +the "Downloadable SDK Components" section at left.

    + +

    For example, there may be a dependency between the ADT Plugin for Eclipse and +the SDK Tools component. When you install the SDK Tools +component, you would then need to upgrade to the required version of ADT (if you +are developing in Eclipse). In this case, you would find dependencies listed in +"Revisions" section of the ADT +Plugin Notes and SDK Tools +Notes documents.

    + +

    Additionally, the development tools will notify you with debug warnings +if there is dependency that you need to address.

    + + +

    Adding New Sites

    + +

    By default, Available Packages only shows the default repository site, which offers platforms, SDK tools, documentation, the Google APIs Add-on, and other components. You can add other sites that host their own Android SDK add-ons, then download the SDK add-ons @@ -115,14 +196,14 @@ on their web site, follow these steps to add their site to the SDK and AVD Manager:

      -
    1. Select Available Components in the left panel.
      2. +
    2. Select Available Packages in the left panel.
    3. Click Add Site and enter the URL of the {@code repository.xml} file. Click OK.

    Any SDK components available from the site will now be listed under -Available Components.

    +Available Packages.

    -

    Troubleshooting

    +

    Troubleshooting

    Problems connecting to the SDK repository

    @@ -138,18 +219,4 @@ protocol used by the SDK and AVD Manager, follow these steps:

  7. Click Save & Apply.
-

SDK Component Dependencies

-

In some cases, a specific SDK component may require a specific minimum -version of another component or SDK tool. Such dependencies are documented -in the release notes for each component.

- -

For example, there may be a dependency between the ADT plugin for Eclipse and -a specific version of the SDK Tools component. When you install the SDK Tools -component, you would then need to upgrade to the required version of ADT (if you -are developing in Eclipse). In this case, you would find dependencies listed in -the ADT Plugin Notes and SDK Tools Notes documents.

- -

Additionally, the development tools will notify you with debug warnings -if there is dependency that you need to address.

diff --git a/docs/html/sdk/adt-notes.jd b/docs/html/sdk/adt-notes.jd index 361d99aea3fc3..291b543f13fb4 100644 --- a/docs/html/sdk/adt-notes.jd +++ b/docs/html/sdk/adt-notes.jd @@ -1,83 +1,5 @@ -page.title=ADT Plugin Notes +page.title=ADT Plugin for Eclipse +sdk.redirect=true +sdk.redirect.path=eclipse-adt.html + @jd:body - -

Android Development Tools (ADT) is a development plugin for the Eclipse IDE. It -extends the capabilites of Eclipse to let you quickly set up new Android -projects, create an application UI, add components based on the Android -Framework API, debug your applications using the Android SDK tools, and even export -signed (or unsigned) APKs in order to distribute your application.

- -

This document provides version-specific information about ADT releases. To -keep up-to-date on new releases, make sure that you view this page at http://developer. -android.com/sdk/adt-notes.html.

- -

To install ADT in your Eclipse IDE environment, use the Eclipse Update Site -feature. For more information, see Installing and Updating ADT.

- - -

ADT 0.9.5

- -

December 2009. ADT 0.9.5 provides several bug fixes for developers, -as described below. -

- -

Dependencies

- -

ADT 0.9.5 requires features provided in SDK Tools r4. If you install -ADT 0.9.5, which is highly recommended, you should use the Android SDK and AVD -Manager to download SDK Tools r4 or higher into your SDK. For more information, -see Adding SDK Components. -

- -

General Notes

- - - -

ADT 0.9.4

- -

October 2009. ADT 0.9.4 provides several new features for developers, as described below. -

- -

Dependencies

- -

ADT 0.9.4 requires features provided in SDK Tools, revision 3. If you install -ADT 0.9.4, which is highly recommended, you should use the Android SDK and AVD -Manager to download SDK Tools r3 or higher into your SDK. For more information, -see Adding SDK Components. -

- -

Project Creation Wizard

- - -

Layout Editor

- - -

DDMS Integration

- - -

Android SDK and AVD Manager integration

- \ No newline at end of file diff --git a/docs/html/sdk/adt_download.jd b/docs/html/sdk/adt_download.jd index 6dbca482369d3..96896c7d63ed2 100644 --- a/docs/html/sdk/adt_download.jd +++ b/docs/html/sdk/adt_download.jd @@ -22,10 +22,17 @@ ADT Installation.

Notes - 0.9.5 - ADT-0.9.5.zip + 0.9.6 + ADT-0.9.6.zip {@adtZipBytes} bytes {@adtZipChecksum} + Requires SDK Tools, Revision 5 March 2009 + + + 0.9.5 + ADT-0.9.5.zip + 3372982 bytes + 227ec538359fbe417ccde7f0ad614a96 Requires SDK Tools, Revision 4 December 2009 diff --git a/docs/html/sdk/android-1.5.jd b/docs/html/sdk/android-1.5.jd index 46126820410e2..b3eea773e649a 100644 --- a/docs/html/sdk/android-1.5.jd +++ b/docs/html/sdk/android-1.5.jd @@ -1,4 +1,4 @@ -page.title=Android 1.5, Release 3 +page.title=Android 1.5 Platform sdk.platform.version=1.5 sdk.platform.apiLevel=3 sdk.platform.majorMinor=major @@ -13,6 +13,7 @@ sdk.platform.deployableDate=May 2009

In this document

  1. Platform Highlights
    2. +
  2. Revisions
  3. Built-in Applications
  4. Locales
  5. Emulator Skins
    6. @@ -33,7 +34,6 @@ sdk.platform.deployableDate=May 2009

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

Android {@sdkPlatformVersion} is a {@sdkPlatformMajorMinor} platform release @@ -60,6 +60,81 @@ Components.

href="http://developer.android.com/sdk/android-{@sdkPlatformVersion}-highlights.html">Android {@sdkPlatformVersion} Platform Highlights document.

+

Revisions

+ +

The sections below provide notes about successive releases of +the Android {@sdkPlatformVersion} platform component for the Android SDK, as denoted by +revision number. To determine what revision(s) of the Android +{@sdkPlatformVersion} platforms are installed in your SDK environment, refer to +the "Installed Packages" listing in the Android SDK and AVD Manager.

+ + + + +
+ + + Android 1.5, Revision 3 (July 2009) +
+
+
Dependencies:
+
+

Requires SDK Tools r3 or higher.

+
+
+
+
+ +
+ + + Android 1.5, Revision 2 (May 2009) +
+

Not available as an SDK component — please use Android 1.5, r3 instead.

+
+
+ +
+ + + Android 1.5, Revision 1 (April 2009) +
+

Not available as an SDK component — please use Android 1.5, r3 instead.

+
+

Built-in Applications

diff --git a/docs/html/sdk/android-1.6.jd b/docs/html/sdk/android-1.6.jd index 7151325626b92..e0bac41c3089a 100644 --- a/docs/html/sdk/android-1.6.jd +++ b/docs/html/sdk/android-1.6.jd @@ -1,4 +1,4 @@ -page.title=Android 1.6, Release 2 +page.title=Android 1.6 Platform sdk.platform.version=1.6 sdk.platform.apiLevel=4 sdk.platform.majorMinor=minor @@ -13,7 +13,7 @@ sdk.platform.deployableDate=October 2009

In this document

  1. Platform Highlights
    2. -
  2. Release Notes
    3. +
  3. Revisions
  4. Built-in Applications
  5. Locales
  6. Emulator Skins
    7. @@ -34,7 +34,6 @@ sdk.platform.deployableDate=October 2009

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

    Android {@sdkPlatformVersion} is a {@sdkPlatformMajorMinor} platform release @@ -63,44 +62,106 @@ href="http://developer.android.com/sdk/android-{@sdkPlatformVersion}-highlights. {@sdkPlatformVersion} Platform Highlights document.

    -

    Release Notes

    +

    Revisions

    -

    The sections below provide information about the available releases of the -Android 1.6 platform.

    +

    The sections below provide notes about successive releases of +the Android {@sdkPlatformVersion} platform component for the Android SDK, as denoted by +revision number. To determine what revision(s) of the Android +{@sdkPlatformVersion} platforms are installed in your SDK environment, refer to +the "Installed Packages" listing in the Android SDK and AVD Manager.

    -

    Android 1.6, Release 2

    + + -

    December 2009. Requires SDK Tools r4 or higher.

    +
    + + + Android 1.6, Revision 2 (December 2009) +
    +
    +
    Dependencies:
    +
    +

    Requires SDK Tools r4 or higher.

    +
    -

    API related:

    -
      -
    • Properly exposes CDMA-related constants in {@link android.telephony.TelephonyManager android.telephony.TelephonyManager}: DATA_ACTIVITY_DORMANT, +
      API related:
      +
      +
        +
      • Properly exposes CDMA-related constants in android.telephony.TelephonyManager: DATA_ACTIVITY_DORMANT, PHONE_TYPE_CDMA, NETWORK_TYPE_CDMA, NETWORK_TYPE_EVDO_0, NETWORK_TYPE_EVDO_A, and -NETWORK_TYPE_1xRTT.
        • -
      -

      System image:

      -
        -
      • Fixes bug so that Bitmap's density is now propagated through Parcelable.
        • -
      • Fixes NinePatchDrawable to properly scale its reported padding for compatibility mode.
        • -
      • Fixes TextView to properly compute styled font metrics based on the screen density.
        • +NETWORK_TYPE_1xRTT. +
      +
      +
      System image:
      +
      +
        +
      • Fixes bug so that Bitmap's density is now propagated through Parcelable.
        • +
      • Fixes NinePatchDrawable to properly scale its reported padding for compatibility mode.
        • +
      • Fixes TextView to properly compute styled font metrics based on the screen density.
      • Updates kernel to 2.6.29, to match kernel on commercially -available Android-powered devices.
        • -
      -

      Tools:

      -
        +available Android-powered devices. +
      +
      +
      Tools:
      +
      +
      • Adds new Ant build system with support for Emma instrumentation projects -(code coverage).
        • -
      • Fixes emulator skins to properly emulate d-pad in landscape mode.
        • -
      • Fixes density rendering in the layout editor in ADT.
        • -
      - - - -

      Android 1.6, Release 1

      - -

      September 2009. Initial release. Requires SDK Tools r3 or higher.

      +(code coverage).
      • +
    • Fixes emulator skins to properly emulate d-pad in landscape mode.
      • +
    • Fixes density rendering in the layout editor in ADT.
      • +
    + +
    +
    +
    +
    + + + Android 1.6, Revision 1 (September 2009) +
    +
    +
    Dependencies
    +
    +

    Requires SDK Tools r3 or higher.

    +
    +
    +
    +

    Built-in Applications

    @@ -188,7 +249,9 @@ 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:

    +

    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: