diff --git a/Android.mk b/Android.mk index d153ce6ffce6f..b8ca23e9b5779 100644 --- a/Android.mk +++ b/Android.mk @@ -345,7 +345,7 @@ framework_docs_LOCAL_DROIDDOC_OPTIONS := \ -since ./frameworks/base/api/2.xml 2 \ -since ./frameworks/base/api/3.xml 3 \ -since ./frameworks/base/api/4.xml 4 \ - -since ./frameworks/base/api/current.xml Eclair \ + -since ./frameworks/base/api/5.xml 5 \ -error 1 -error 2 -warning 3 -error 4 -error 6 -error 8 \ -overview $(LOCAL_PATH)/core/java/overview.html @@ -382,10 +382,20 @@ framework_docs_SDK_CURRENT_DIR:=$(framework_docs_SDK_VERSION)_r$(framework_docs_ # flag to build offline docs for a preview release framework_docs_SDK_PREVIEW:=0 +## Latest ADT version identifiers, for reference from published docs +framework_docs_ADT_VERSION:=0.9.4 +framework_docs_ADT_DOWNLOAD:=ADT-0.9.4.zip +framework_docs_ADT_BYTES:=0 +framework_docs_ADT_CHECKSUM:=0 + framework_docs_LOCAL_DROIDDOC_OPTIONS += \ -hdf sdk.version $(framework_docs_SDK_VERSION) \ -hdf sdk.rel.id $(framework_docs_SDK_REL_ID) \ - -hdf sdk.current $(framework_docs_SDK_CURRENT_DIR) + -hdf sdk.current $(framework_docs_SDK_CURRENT_DIR) \ + -hdf adt.zip.version $(framework_docs_ADT_VERSION) \ + -hdf adt.zip.download $(framework_docs_ADT_DOWNLOAD) \ + -hdf adt.zip.bytes $(framework_docs_ADT_BYTES) \ + -hdf adt.zip.checksum $(framework_docs_ADT_CHECKSUM) # ==== the api stubs and current.xml =========================== include $(CLEAR_VARS) diff --git a/docs/html/guide/appendix/api-levels.jd b/docs/html/guide/appendix/api-levels.jd index 31581924c7443..3f3b6c6fb2331 100644 --- a/docs/html/guide/appendix/api-levels.jd +++ b/docs/html/guide/appendix/api-levels.jd @@ -83,6 +83,7 @@ Android platform.

+ @@ -115,6 +116,10 @@ they are designed to support. The element offers two key attributes:

@@ -146,7 +151,7 @@ element might look like this: 

<manifest>
   ...
-  <uses-sdk android:minSdkVersion="4" />
+  <uses-sdk android:minSdkVersion="5" />
   ...
 </manifest>
@@ -288,23 +293,26 @@ a list of platform versions and their API Levels.

Using a Provisional API Level

-

During an "Early Look" SDK release, the APIs may not be final, so the API Level integer -will not be specified. You must instead use a provisional API Level in your application -manifest in order to build applications against the Early Look platform. In this case, -the provisional API Level is not an integer, but a string matching the codename of the -unreleased platform version (for example, "Eclair"). The provisional API Level will be specified -in the Early Look SDK release notes and is case-sensitive.

+

In some cases, an "Early Look" Android SDK platform may be available. To let +you begin developing on the platform although the APIs may not be final, the +platform's API Level integer will not be specified. You must instead use the +platform's provisional API Level in your application manifest, in order +to build applications against the platform. A provisional API Level is not an +integer, but a string matching the codename of the unreleased platform version. +The provisional API Level will be specified in the release notes for the Early +Look SDK release notes and is case-sensitive.

-

The use of a provisional API Level is designed to protect developers -and device users from inadvertently publishing or installing applications based on the -Early Look framework API, which may not run properly on actual devices running the final -system image.

+

The use of a provisional API Level is designed to protect developers and +device users from inadvertently publishing or installing applications based on +the Early Look framework API, which may not run properly on actual devices +running the final system image.

-

The provisional API Level will only be valid while using the Early Look SDK to run -applications in the emulator. An application using the provisional API Level can never be -installed on an Android device. When the final SDK is released, you must replace any -instances of the provisional API Level in your application manifest with the final -API Level integer.

+

The provisional API Level will only be valid while using the Early Look SDK +and can only be used to run applications in the emulator. An application using +the provisional API Level can never be installed on an Android device. At the +final release of the platform, you must replace any instances of the provisional +API Level in your application manifest with the final platform's actual API +Level integer.

Filtering the Reference Documentation by API Level

diff --git a/docs/html/guide/developing/eclipse-adt.jd b/docs/html/guide/developing/eclipse-adt.jd index 4c794f8fcfe3b..c01745e67a2f2 100644 --- a/docs/html/guide/developing/eclipse-adt.jd +++ b/docs/html/guide/developing/eclipse-adt.jd @@ -38,12 +38,12 @@ manifest and resource files.

To begin developing Android applications in the Eclipse IDE with ADT, you first need to download the Eclipse IDE and then download and install the ADT plugin. To do so, follow the -steps given in Installing +steps given in Installing the ADT Plugin.

If you are already developing applications using a version of ADT earlier than 0.9, make sure to upgrade to the latest version before continuing. See the guide to -Updating Your Eclipse ADT Plugin.

+Updating Your ADT Plugin.

Note: This guide assumes you are using the latest version of the ADT plugin. While most of the information covered also applies to previous diff --git a/docs/html/guide/developing/tools/othertools.jd b/docs/html/guide/developing/tools/othertools.jd index b4c4cf32dd08a..00f0b8d665e2d 100644 --- a/docs/html/guide/developing/tools/othertools.jd +++ b/docs/html/guide/developing/tools/othertools.jd @@ -26,14 +26,14 @@ Android applications.

  • Create and update Android projects. See Developing in Other IDEs.
  • Update your Android SDK with new platforms, add-ons, and documentation. See - Updating Your SDK.
    • + Adding SDK Components.

    If you develop in Eclipse with the ADT plugin, you can perform these tasks directly from the IDE. To create Android projects and AVDs from Eclipse, see Developing In Eclipse. To update your SDK from Eclipse, see -Updating Your SDK. +Adding SDK Components.

    diff --git a/docs/html/guide/tutorials/hello-world.jd b/docs/html/guide/tutorials/hello-world.jd index 9be63bd1c4499..f6b54ff77603b 100644 --- a/docs/html/guide/tutorials/hello-world.jd +++ b/docs/html/guide/tutorials/hello-world.jd @@ -29,7 +29,7 @@ You can then return to this tutorial and ignore anything about Eclipse.

    Before you start, you should already have the very latest SDK installed, and if you're using Eclipse, you should have installed the ADT plugin as well. If you have not installed these, see -Installing the Android SDK and return +Installing the Android SDK and return here when you've completed the installation.

    Create an AVD

    diff --git a/docs/html/intl/ja/guide/developing/eclipse-adt.jd b/docs/html/intl/ja/guide/developing/eclipse-adt.jd index 26cae54264f4f..e7accd8d71de5 100644 --- a/docs/html/intl/ja/guide/developing/eclipse-adt.jd +++ b/docs/html/intl/ja/guide/developing/eclipse-adt.jd @@ -29,8 +29,8 @@ page.title=Eclipse 内で ADT を使用
  • プロジェクトを、ユーザーに配布可能な署名済みの APK 形式でエクスポートすることもできます。
    • -

    ADT を組み込んだ Eclipse 総合開発環境で Android アプリケーションの開発を始めるには、最初に Eclipse 総合開発環境をダウンロードしてから、ADT プラグインをダウンロードしてインストールする必要があります。そのためには、Eclipse 用 ADT プラグインのインストールに記載されている手順どおりに操作します。

    -

    バージョン 0.9 より前の ADT を使用してアプリケーションを既に開発中の場合は、必ず最新バージョンにアップグレードしてから続行してください。Eclipse ADT プラグインをアップデートするためのガイドをご覧ください。

    +

    ADT を組み込んだ Eclipse 総合開発環境で Android アプリケーションの開発を始めるには、最初に Eclipse 総合開発環境をダウンロードしてから、ADT プラグインをダウンロードしてインストールする必要があります。そのためには、Eclipse 用 ADT プラグインのインストールに記載されている手順どおりに操作します。

    +

    バージョン 0.9 より前の ADT を使用してアプリケーションを既に開発中の場合は、必ず最新バージョンにアップグレードしてから続行してください。Eclipse ADT プラグインをアップデートするためのガイドをご覧ください。

    注: このガイドでは、ADT プラグインの最新バージョンを使用していることを前提としています。説明の大半は、以前のバージョンにも当てはまりますが、以前のバージョンを使用している場合は、このドキュメントのオンライン版ではなく、SDK パッケージに付属された資料内の同ドキュメントをご覧ください。

    diff --git a/docs/html/intl/ja/guide/tutorials/hello-world.jd b/docs/html/intl/ja/guide/tutorials/hello-world.jd index 31857cee8c1f4..c12965cb0c388 100644 --- a/docs/html/intl/ja/guide/tutorials/hello-world.jd +++ b/docs/html/intl/ja/guide/tutorials/hello-world.jd @@ -20,7 +20,7 @@ page.title=Hello, World

    Eclipse を使用していない場合でも問題ありません。Developing in Other IDEsに慣れてから、このチュートリアルに戻り、Eclipse に関する部分以外を参考にしてください。

    -

    開始する前に、最新の SDK がインストールされている必要があります。また、Eclipse を使用する場合には、ADT プラグインもインストールされている必要があります。これらのプログラムがインストールされていない場合は、「Installing the Android SDK」を参考にインストールを実行して、完了後にこのチュートリアルに戻ってください。

    +

    開始する前に、最新の SDK がインストールされている必要があります。また、Eclipse を使用する場合には、ADT プラグインもインストールされている必要があります。これらのプログラムがインストールされていない場合は、「Installing the Android SDK」を参考にインストールを実行して、完了後にこのチュートリアルに戻ってください。

    AVD の作成

    diff --git a/docs/html/intl/ja/sdk/1.5_r2/installing.jd b/docs/html/intl/ja/sdk/1.5_r2/installing.jd index bcb1ffba6355a..a587b1a198c2b 100644 --- a/docs/html/intl/ja/sdk/1.5_r2/installing.jd +++ b/docs/html/intl/ja/sdk/1.5_r2/installing.jd @@ -2,7 +2,7 @@ page.title=Android SDK のインストール @jd:body -

    このページでは、Android SDK をインストールして、開発環境を設定する方法について説明します。SDK をまだダウンロードしていない場合は、[ダウンロード] ページからダウンロードしてください。SDK をダウンロードした後に、このページの手順を行ってください。

    +

    このページでは、Android SDK をインストールして、開発環境を設定する方法について説明します。SDK をまだダウンロードしていない場合は、[ダウンロード] ページからダウンロードしてください。SDK をダウンロードした後に、このページの手順を行ってください。

    インストール中に問題が発生した場合は、このページの下部にあるインストールに関する注意事項を参照してください。

    diff --git a/docs/html/intl/ja/sdk/1.5_r3/installing.jd b/docs/html/intl/ja/sdk/1.5_r3/installing.jd index bcb1ffba6355a..a587b1a198c2b 100644 --- a/docs/html/intl/ja/sdk/1.5_r3/installing.jd +++ b/docs/html/intl/ja/sdk/1.5_r3/installing.jd @@ -2,7 +2,7 @@ page.title=Android SDK のインストール @jd:body -

    このページでは、Android SDK をインストールして、開発環境を設定する方法について説明します。SDK をまだダウンロードしていない場合は、[ダウンロード] ページからダウンロードしてください。SDK をダウンロードした後に、このページの手順を行ってください。

    +

    このページでは、Android SDK をインストールして、開発環境を設定する方法について説明します。SDK をまだダウンロードしていない場合は、[ダウンロード] ページからダウンロードしてください。SDK をダウンロードした後に、このページの手順を行ってください。

    インストール中に問題が発生した場合は、このページの下部にあるインストールに関する注意事項を参照してください。

    diff --git a/docs/html/offline.jd b/docs/html/offline.jd index 78e2679a31e45..fe70d50323c3d 100644 --- a/docs/html/offline.jd +++ b/docs/html/offline.jd @@ -10,17 +10,17 @@ page.title=Welcome

    If you've downloaded the Android SDK for the first time...

    -

    Complete the online guide to -Installing +

    Follow the online guide to +Installing the Android SDK, which will help you setup your development environment (including the Android Development Tools plugin for Eclipse) so you can start developing Android apps.

    Once your environment is setup, look at the -Next -Steps for some pointers that will teach you about Android and get you started.

    +Next +Steps for some suggestions on how to begin learning about Android.

    -

    If you've updated an existing SDK using the SDK and AVD Manager...

    +

    If you've just installed new SDK components using the SDK and AVD Manager...

    There's no additional setup.

    @@ -37,10 +37,11 @@ directory; and new documentation is saved in the existing Android developer documentation. The offline documentation offers almost all the same content and features as the online documentation. Because some features such as search and videos are network-based, not everything will work if you -are not connected to the Internet.

    -For the most current documentation and fully-functional experience, please visit
    - -http://developer.android.com. +are not connected to the Internet.

    + +

    For the most current documentation and a fully-functional experience, please visit:

    +

    +http://developer.android.com.

    diff --git a/docs/html/sdk/1.5_r2/installing.jd b/docs/html/sdk/1.5_r2/installing.jd index 1530dc56e1db5..1e4e0f2479c87 100644 --- a/docs/html/sdk/1.5_r2/installing.jd +++ b/docs/html/sdk/1.5_r2/installing.jd @@ -323,7 +323,7 @@ begin developing applications. Here are a few ways you can get started:

    diff --git a/docs/html/sdk/1.5_r3/installing.jd b/docs/html/sdk/1.5_r3/installing.jd index c01dd36c6e638..c1530711f88d6 100644 --- a/docs/html/sdk/1.5_r3/installing.jd +++ b/docs/html/sdk/1.5_r3/installing.jd @@ -323,7 +323,7 @@ begin developing applications. Here are a few ways you can get started:

    diff --git a/docs/html/sdk/RELEASENOTES.jd b/docs/html/sdk/RELEASENOTES.jd index 2d3fdacd75075..d6e829eb06f23 100644 --- a/docs/html/sdk/RELEASENOTES.jd +++ b/docs/html/sdk/RELEASENOTES.jd @@ -3,7 +3,50 @@ page.title=SDK Release Notes

    This document provides version-specific information about Android SDK releases. For the latest known issues, please ensure that you're viewing this -page at http://developer.android.com/sdk/RELEASENOTES.html.

    +page at http://developer. +android.com/sdk/RELEASENOTES.html.

    + +

    Android SDK

    + +

    The Android SDK has changed! If you've worked with the Android SDK before, +you will notice several important differences:

    + + + +

    Note that if you are currently using the Android 1.6 SDK, you do not +necessarily need to install the new SDK, since your existing SDK incudes the +Android SDK and AVD Manager tool. To develop against Android 2.0, for example, +you could just download the Android 2.0 platform into your existing SDK.

    + +

    Release notes for Android platforms that are downloadable into the SDK are +now available from the "SDK" tab, under "Downloadable SDK Components."

    + + + +

    To get started with the SDK, review the Quick Start summary on the Android SDK download page or read Installing the SDK for more +information.

    +

    Android 1.6 SDK, Release 1

    diff --git a/docs/html/sdk/adding-components.jd b/docs/html/sdk/adding-components.jd new file mode 100644 index 0000000000000..d4152e1fd7a79 --- /dev/null +++ b/docs/html/sdk/adding-components.jd @@ -0,0 +1,138 @@ +page.title=Adding SDK Components +@jd:body + + +
    +
    +

    Quickview

    + + +

    In this document

    +
      +
    1. Installing SDK Components +
        +
      1. Adding New Sites
        2. +
      +
      2. +
    2. Component Dependencies
      3. +
    +
    +
    + +

    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.

    + +

    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.

    + +

    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.

    + + +

    Installing SDK Components

    + +

    Use the Android SDK and AVD Manager to install new SDK components. +To launch the SDK and AVD Manager in one of these ways:

    + + + + +

    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. Verify and accept the components you want and click Install + Accepted. The components will now be installed into your existing + Android SDK directories.
      4. +
    + +

    New platforms are automatically saved into the +<sdk>/platforms/ directory of your SDK; +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).

    + +

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

    + + +

    Adding New Sites

    + +

    By default, Available Components only shows +the default repository for platforms, the Google APIs +Add-On, and other SDK components. You can add additional sites that host +Android SDK add-ons, then download the SDK add-ons from them.

    + +

    For example, a mobile carrier or device manufacturer may offer additional +API libraries that are supported by their own Android-powered devices. In order +to develop using their libraries, you must install their Android SDK add-on.

    + +

    If a carrier or device manufacturer has hosted an SDK add-on repository file +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. Click Add Site and enter the URL of the +{@code repository.xml} file. Click OK.
      3. +
    +

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

    + + +

    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 new file mode 100644 index 0000000000000..18c144e294b65 --- /dev/null +++ b/docs/html/sdk/adt-notes.jd @@ -0,0 +1,59 @@ +page.title=ADT Plugin Notes +@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.4

    + +

    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 3 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/android-1.5.jd b/docs/html/sdk/android-1.5.jd index ac4890080cfda..ac37fe04c461d 100644 --- a/docs/html/sdk/android-1.5.jd +++ b/docs/html/sdk/android-1.5.jd @@ -1,118 +1,77 @@ -page.title=Android 1.5 Version Notes -sdk.version=1.5_r1 -sys.date=April 2009 -@jd:body +page.title=Android 1.5, Release 3 +sdk.platform.version=1.5 +sdk.platform.apiLevel=3 +sdk.platform.majorMinor=major +sdk.platform.releaseDate=April 2009 +sdk.platform.deployableDate=May 2009

    Date: April 2009
    API Level: 3

    +
    +
    -

    This document provides version notes for the Android 1.5 system image included in the SDK.

    +

    In this document

    +
      +
    1. Platform Highlights
      2. +
    2. Built-in Applications
      3. +
    3. Locales
      4. +
    4. Emulator Skins
      5. +
    5. Other Notes
      6. +
    6. Framework API +
        +
      1. API level
        2. +
      2. API changes summary
        3. +
      3. API differences report »
        4. +
      7. +
    - +

    See Also

    +
      +
    1. Adding SDK Components
      2. +
    -

    Overview

    +
    +
    -

    The Android 1.5 system delivered in the SDK (as library and system image) is -the development counterpart to the Android 1.5 production system image, -deployable to Android-powered handsets starting in May 2009. The system is fully -compliant and includes no external libraries. This is the first version of the -Android SDK that does not include the Maps external library.

    +

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

    -

    The Android 1.5 system delivers an updated version of the framework -API. As with previous versions, the Android 1.5 API -is assigned an integer identifier — 3 — 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.

    +

    Android {@sdkPlatformVersion} is a {@sdkPlatformMajorMinor} platform release +deployable to Android-powered handsets starting in {@sdkPlatformDeployableDate}. +The release includes new features for users and developers, as well as changes +in the Android framework API.

    -

    Applications can reference a specific API Level value in their -manifest files, to indicate the minimum version of the Android system -required to run the application. To reference a minimum API Level, applications -can add an android:minSdkVersion attribute in their manifest files. -The value of the attribute is an integer corresponding to an API Level -identifier. Prior to installing an application, the system then checks the value of -android:minSdkVersion and allows the install only -if the referenced integer is less than or equal to the API Level integer stored -in the system itself.

    +

    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 is fully +compliant and includes no external libraries.

    -

    When you migrate your application to the new SDK, you will need to choose -the platform version against which you will compile your application. In -general, you should compile your application against the lowest possible -version of the platform that your application can support. After you determine -the lowest version, you should ensure that your application's manifest file -defines the API Level of the lowest compatible platform version in the -android:minSdkVersion attribute. +

    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 1.6 or later SDK. For more information, +see Adding SDK +Components.

    -

    After compiling your application, you should make sure to test it on the -platform specified in the application's android:minSdkVersion attribute. To -ensure forward-compatibility, you should also run the application on platforms -using a higher API Level than that used by your application. To run your -application against different platform versions in the emulator, you create an -AVD for each platform version that you want to test. For more information about -AVDs, see Android Virtual -Devices. If you are using a physical device for testing, ensure that you -know the API Level of the Android platform it runs.

    -

    If you build an application using the Android 1.5 library and your -application makes use of any APIs introduced in API Level 3, you must set the -android:minSdkVersion attribute in the application's manifest to -"3".

    +

    Platform Highlights

    -

    Specifically, you define the android:minSdkVersion -attribute in a <uses-sdk> element as a child of -<manifest> in the manifest file. When set, the -attribute looks like this:

    +

    For a list of new user features and platform highlights, see the Android +{@sdkPlatformVersion} Platform Highlights document.

    -
    <manifest>
-  ...
-  <uses-sdk android:minSdkVersion="3" />
-  ...
-</manifest>
    - -

    By setting android:minSdkVersion in this way, you ensure that -users will only be able to install your application if their devices are running -a compatible version of the Android platform. In turn, this ensures that your -application will function properly on their devices. This is especially -important if your application uses APIs or system features -introduced in Android 1.5.

    - -

    If your application uses APIs introduced in Android 1.5 but does not -declare <uses-sdk android:minSdkVersion="3" />, then it will -run properly on Android 1.5 devices but not on Android 1.0 -devices. In the latter case, the application will crash at runtime when -it tries to use the Android 1.5 APIs.

    - -

    Conversely, if your application does not use any new APIs introduced in -Android 1.5, the application will in most cases function normally on devices -running a later version of the platform. However, if you have published -the application, you are strongly encouraged to install and test your -application on the Android 1.5 system image included in the SDK. This will -ensure a smooth transition for users, as they upgrade their devices to -the new version of the Android platform.

    - -

    Finally, if your application does not use any new APIs introduced since -Android 1.1, you can indicate general Android 1.1 compatibility by -setting the attribute to "2". If your application does not use any -new APIs introduced since Android 1.0, you can remove the attribute or -set it to "1". However, -before publishing your application, you must make sure to compile your -application against the Android library that corresponds to the application's -android:minSdkVersion value.

    Built-in Applications

    -

    The system image includes these built-in applications:

    +

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

    + +
    Platform VersionAPI Level
    Android 2.05
    Android 1.64
    Android 1.53
    Android 1.12
    + + + + +
    • Alarm Clock
    • Browser
      • @@ -122,6 +81,10 @@ application against the Android library that corresponds to the application's
    • Contacts
    • Custom Locale (developer app)
    • Dev Tools (developer app)
      • +
    +    		 +
    • Dialer
    • Email
    • Gallery
      • @@ -131,18 +94,21 @@ application against the Android library that corresponds to the application's
    • Settings
    • Spare Parts (developer app)
    +
    -

    Locales

    +

    Locales

    -

    The system image 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 will be -available in the Android 1.5 system image are listed below (with -language_country/region locale descriptor).

    +

    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 will be available in the Android {@sdkPlatformVersion} system image are listed +below (with language_country/region locale descriptor).

    - +
    - -
    +
    • Chinese, PRC (zh_CN)
    • Chinese, Taiwan (zh_TW)
      • @@ -151,7 +117,7 @@ available in the Android 1.5 system image are listed below (with
    • Dutch, Belgium (nl_BE)
    • English, US (en_US)
    • English, Britain (en_GB)
      • -
    • English, Canada(en_CA)
      • +
    • English, Canada (en_CA)
    • English, Australia (en_AU)
    • English, New Zealand (en_NZ)
    • English, Singapore(en_SG)
      • @@ -159,11 +125,11 @@ available in the Android 1.5 system image are listed below (with
    • French, Belgium (fr_BE)
    		 +
  • French, Canada (fr_CA)
  • French, Switzerland (fr_CH)
  • German, Germany (de_DE)
    • -
  • German, Austria(de_AT)
    • +
  • German, Austria (de_AT)
  • German, Switzerland (de_CH)
  • German, Liechtenstein (de_LI)
  • Italian, Italy (it_IT)
    • @@ -177,29 +143,65 @@ available in the Android 1.5 system image are listed below (with
    -

    Localized UI strings match the locales that are displayable in -the emulator, accessible through the device Settings application.

    +

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

    -

    New Features

    +

    Emulator Skins

    -

    For a list of new system features, see the Android 1.5 Platform -Highlights document.

    - -

    API Changes

    - -

    Overview

    +

    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 the application framework API provided by the Android {@sdkPlatformVersion} platform.

    + + +

    API level

    + +

    The Android {@sdkPlatformVersion} platform delivers an updated version of the framework +API. As with previous versions, 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 <uses-sdk> attributes in your +application's manifest.

    + +

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

    + +

    API changes summary

    + +

    UI framework

    - -
  • AppWidget framework +

    AppWidget framework

    -
    • -
  • Media framework
    • +

    Media framework

    - -
  • Input Method framework +

    Input Method framework

    -
    • -
  • Application-defined hardware requirements +

    Application-defined hardware requirements

    Applications can now use a new element in their manifest files, <uses- -configuration> to indicate to the Android system what hardware features +href="{@docRoot}guide/topics/manifest/uses-configuration-element.html"><uses-configuration> + to indicate to the Android system what hardware features they require in order to function properly. For example, an application might use the element to specify that it requires a physical keyboard or a particular navigation device, such as a trackball. Prior to installing the application, the Android system checks the attributes defined for the <uses-configuration> element and allows the installation to continue only if the required hardware is present.

    -
    • -
  • Speech recognition framework +

    Speech recognition framework

    -
    • -
  • Miscellaneous API additions +

    Miscellaneous API additions

    -
    • - - - -

    API Change Details

    - -

    For a detailed view of API changes in this platform (API Level 3), see the API Differences Report.

    - - - +

    API differences report

    +

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

    diff --git a/docs/html/sdk/android-1.6.jd b/docs/html/sdk/android-1.6.jd index 5dd2d953cc907..0f8a4b6250be4 100644 --- a/docs/html/sdk/android-1.6.jd +++ b/docs/html/sdk/android-1.6.jd @@ -1,48 +1,75 @@ -page.title=Android 1.6 Version Notes +page.title=Android 1.6, Release 1 +sdk.platform.version=1.6 +sdk.platform.apiLevel=4 +sdk.platform.majorMinor=minor +sdk.platform.releaseDate=September 2009 +sdk.platform.deployableDate=October 2009 @jd:body +
    +
    + +

    In this document

    +
      +
    1. Platform Highlights
      2. +
    2. Built-in Applications
      3. +
    3. Locales
      4. +
    4. Emulator Skins
      5. +
    5. Other Notes
      6. +
    6. Framework API +
        +
      1. API level
        2. +
      2. API changes summary
        3. +
      3. API differences report »
        4. +
      7. +
    + +

    See Also

    +
      +
    1. Adding SDK Components
      2. +
    + +
    +
    +

    -Date: September 2009
    -API Level: 4

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

    + +

    Android {@sdkPlatformVersion} is a {@sdkPlatformMajorMinor} platform release +deployable to Android-powered handsets starting in {@sdkPlatformDeployableDate}. +The release includes new features for users and developers, as well as changes +in the Android framework API.

    + +

    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 is fully +compliant and 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 1.6 or later SDK. For more information, +see Adding SDK +Components.

    -

    This document provides version notes for the Android 1.6 system image included in the SDK.

    - - - -

    Overview

    - -

    The Android 1.6 system delivered in the SDK (as library and system image) is -the development counterpart to the Android 1.6 production system image, which is -deployable to Android-powered handsets starting October 2009. The system is -fully compliant and includes no external libraries.

    - -

    The Android 1.6 system delivers an updated version of the framework -API. As with previous versions, the Android 1.6 API -is assigned an integer identifier — 4 — 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.

    - -

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

    - -

    Highlights

    +

    Platform Highlights

    For a list of new user features and platform highlights, see the Android 1.6 Platform -Highlights document.

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

    +

    Built-in Applications

    -

    The system image includes these built-in applications:

    +

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

    + + + + + + +
    • Alarm Clock
    • Browser
      • @@ -53,6 +80,10 @@ Highlights document.

    • Custom Locale (developer app)
    • Dev Tools (developer app)
    • Dialer
      • +
    +    		 +
    • Email
    • Gallery
    • Gestures Builder
      • @@ -62,79 +93,51 @@ Highlights document.

    • Settings
    • Spare Parts (developer app)
    +
    -

    Locales

    +

    Locales

    -

    The system image 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 will be -available in the Android 1.6 system image are listed below (with -language_country/region locale descriptor).

    +

    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 will be available in the Android {@sdkPlatformVersion} system image are listed +below (with language_country/region locale descriptor).

    - +
    - + -
    -
      -
    • Arabic, Egypt (ar_EG)
      • -
    • Arabic, Israel (ar_IL)
      • -
    • Bulgarian, Bulgaria (bg_BG)
      • +
    		 +
    • Chinese, PRC (zh_CN)
    • Chinese, Taiwan (zh_TW)
      • -
    • Croatian, Croatia (hr_HR)
      • -
    • Czech, Czech Republic (cs_CZ)
      • -
    • Danish, Denmark (da_DK)
      • +
    • 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, India (en_IN)
      • -
    • English, Ireland (en_IE)
    • English, New Zealand (en_NZ)
      • -
    • English, Singapore (en_SG)
      • -
    • English, South Africa (en_ZA)
      • -
    • Finnish, Finland (fi_FI)
      • +
    • 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)
    • - -    		 -
      -
    • Greek, Greece (el_GR)
      • -
    • Hindi, India (hi_IN)
      • -
    • Hungarian, Hungary (hu_HU)
      • -
    • Indonesian, Indonesia (id_ID)
    • Italian, Italy (it_IT)
    • Italian, Switzerland (it_CH)
      • -
    • Japanese, Japan (ja_JP)
      • -
    • Korean, Korea (ko_KR)
      • -
    • Latvian, Latvia (lv_LV)
      • -
    • Lithuanian, Lithuania (lt_LT)
      • -
    • Norwegian Bokmål, Norway (nb_NO)
      • -
    • Polish, Poland (pl_PL)
      • -
    • Portuguese, Brazil (pt_BR)
      • -
    • Portuguese, Portugal (pt_PT)
      • -
    • Romanian, Romania (ro_RO)
      • -
    • Russian, Russia (ru_RU)
      • -
    • Serbian, Serbia (sr_RS)
      • -
    • Slovak, Slovakia (sk_SK)
      • -
    • Slovenian, Slovenia (sl_SI)
      • -
    • Spanish, Spain (es_ES)
      • -
    • Spanish, US (es_US)
      • -
    • Swedish, Sweden (sv_SE)
      • -
    • Thai, Thailand (th_TH)
      • -
    • Tagalog, Philippines (tl_PH)
      • -
    • Turkish, Turkey (tr_TR)
      • -
    • Ukranian, Ukrania (uk_UA)
      • -
    • Vietnamese, Vietnam (vi_VN)
      • -
    +
  • Japanese (ja_JP)
    • +
  • Korean (ko_KR)
    • +
  • Polish (pl_PL)
    • +
  • Russian (ru_RU)
    • +
  • Spanish (es_ES)
    		•
    @@ -142,7 +145,50 @@ available in the Android 1.6 system image are listed below (with

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

    -

    API Changes

    +

    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 the application framework API provided by the Android {@sdkPlatformVersion} platform.

    + + +

    API level

    + +

    The Android {@sdkPlatformVersion} platform delivers an updated version of the framework +API. As with previous versions, 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 <uses-sdk> attributes in your +application's manifest.

    + +

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

    + +

    API changes summary

    UI framework

    -

    API Change Details

    +

    API differences report

    -

    For a detailed view of API changes in Android 1.6 (API Level 4), see the API Differences Report.

    +

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

    diff --git a/docs/html/sdk/android-2.0.jd b/docs/html/sdk/android-2.0.jd new file mode 100644 index 0000000000000..5660844c9b7e9 --- /dev/null +++ b/docs/html/sdk/android-2.0.jd @@ -0,0 +1,285 @@ +page.title=Android 2.0, Release 1 +sdk.platform.version=2.0 +sdk.platform.apiLevel=5 +sdk.platform.majorMinor=major +sdk.platform.releaseDate=October 2009 +sdk.platform.deployableDate=November 2009 + +@jd:body + +
    +
    + +

    In this document

    +
      +
    1. Platform Highlights
      2. +
    2. Built-in Applications
      3. +
    3. Locales
      4. +
    4. Emulator Skins
      5. +
    5. Developer Features
      6. +
    6. Framework API +
        +
      1. API level
        2. +
      2. API changes summary
        3. +
      3. API differences report »
        4. +
      7. +
    + +

    See Also

    +
      +
    1. Adding SDK Components
      2. +
    + +
    +
    + +

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

    + +

    Android {@sdkPlatformVersion} is a {@sdkPlatformMajorMinor} platform release +deployable to Android-powered handsets starting in {@sdkPlatformDeployableDate}. +The release includes new features for users and developers, as well as changes +in the Android framework API.

    + +

    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 is fully +compliant and 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 1.6 or later SDK. For more information, +see Adding SDK +Components.

    + + +

    Platform Highlights

    + +

    For a list of new user features and platform highlights, see the Android +{@sdkPlatformVersion} Platform Highlights document.

    + +

    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 will be available in the Android 1.6 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.

    + +

    Developer Features

    + +

    The sections below provide information about new developer features offered by the downloadable Android 2.0 platform component.

    + +

    Ant Support

    + + + +

    Framework API

    + +

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

    + + +

    API level

    + +

    The Android {@sdkPlatformVersion} platform delivers an updated version of the framework +API. As with previous versions, 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 <uses-sdk> attributes in your +application's manifest.

    + +

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

    + +

    API changes summary

    + +

    Bluetooth

    + + +

    Sync adapters

    + + +

    Account Manager

    + + +

    Contacts

    + + +

    WebView

    + + +

    Camera

    + + +

    Media

    + + +

    Other Framework

    + + +

    API differences report

    + +

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

    + diff --git a/docs/html/sdk/eclipse-adt.jd b/docs/html/sdk/eclipse-adt.jd new file mode 100644 index 0000000000000..ba095e0299c4c --- /dev/null +++ b/docs/html/sdk/eclipse-adt.jd @@ -0,0 +1,316 @@ +page.title=Installing and Updating the ADT Plugin +sdk.preview=0 + +@jd:body + +
    +
    + +

    In this document

    +
      +
    1. Prepare for Installation
      2. +
    2. Installing the ADT Plugin +
        +
      1. Troubleshooting
        2. +
      +
      3. +
    3. Updating the ADT Plugin
      4. +
    4. Uninstalling the ADT Plugin
      5. +
    + +
    +
    + +

    Android offers a custom plugin for the Eclipse IDE, called Android +Development Tools (ADT), that is designed to give you a powerful, +integrated environment in which to build Android applications. 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.

    + +

    In general, using Eclipse with ADT is a highly recommended approach to +Android development and is the fastest way to get started. + +

    To install and update the ADT Plugin, you can take advantage of the Eclipse +remote update feature. By setting up a remote update site, you can +easily download, install, and check for ADT updates. Alternatively, you +can download the latest ADT to your development +computer as a local site archive. The sections below provide nstructions +for both methods.

    + + +

    Prepare for Installation

    + +

    Before you begin, take a moment to confirm that your development machine +meets the System Requirements.

    + +

    If you will be developing in Eclipse with the Android Development +Tools (ADT) Plugin — the recommended path if you are new to +Android — make sure that you have a suitable version of Eclipse +installed on your computer (3.4 or newer is recommended). If you need +to install Eclipse, you can download it from this location:

    + + +

    Installing the ADT Plugin

    + +

    Once you have the Eclipse IDE installed, as described in Preparing for Installation, above, follow these steps to +download the ADT plugin and install it in your respective Eclipse environment. +

    + + + + + + + +
    Eclipse 3.4 (Ganymede)Eclipse 3.5 (Galileo)
    + +
      +
    1. Start Eclipse, then select Help > Software Updates.... + In the dialog that appears, click the Available Software tab.
      2. +
    2. Click Add Site...
      3. +
    3. In the Add Site dialog that appears, enter this URL in the "Location" field: + 
      https://dl-ssl.google.com/android/eclipse/
      +

      Note: If you have trouble aqcuiring the plugin, try using "http" in the Location URL, + instead of "https" (https is preferred for security reasons).

      +

      Click OK.

      4. +
    4. Back in the Available Software view, you should see the plugin listed by the URL, + with "Developer Tools" nested within it. Select the checkbox next to + Developer Tools and click Install...
      5. +
    5. On the subsequent Install window, "Android DDMS" and "Android Development Tools" + should both be checked. Click Next.
      6. +
    6. Read and accept the license agreement, then click Finish.
      7. +
    7. Restart Eclipse.
      8. +
    + +    		 + +
      +
    1. Start Eclipse, then select Help > Install + New Softare.
      2. +
    2. In the Available Software dialog, click Add....
      3. +
    3. In the Add Site dialog that appears, enter a name for the remote site + (for example, "Android Plugin") in the "Name" field. +

      In the "Location" field, enter this URL:

      + 
      https://dl-ssl.google.com/android/eclipse/
      +

      Note: If you have trouble aqcuiring the plugin, you can try + using "http" in the URL, instead of "https" (https is preferred for + security reasons).

      +

      Click OK.

      +
      4. +
    4. Back in the Available Software view, you should now see "Developer + Tools" added to the list. Select the checkbox next to Developer Tools, + which will automatically select the nested tools Android DDMS and Android + Development Tools. + Click Next.
      5. +
    5. In the resulting Install Details dialog, the Android DDMS and Android + Development Tools features are listed. Click Next to + read and accept the license agreement and install any dependencies, + then click Finish.
      6. +
    6. Restart Eclipse.
      7. + +
    +
    + +

    Now modify your Eclipse preferences to point to the Android SDK directory:

    +
      +
    1. Select Window > Preferences... to open the Preferences + panel (Mac OS X: Eclipse > Preferences).
      2. +
    2. Select Android from the left panel.
      3. +
    3. For the SDK Location in the main panel, click Browse... and + locate your downloaded SDK directory.
      4. +
    4. Click Apply, then OK.
      5. +
    + +

    Done! If you haven't encountered any problems, then you're ready to +begin developing Android applications.

    + + +

    Troubleshooting ADT Installation

    + +

    If you are having trouble downloading the ADT plugin after following the +steps above, here are some suggestions:

    + + + +

    If you are still unable to use Eclipse to download the ADT plugin as a +remote update site, you can download the ADT zip file to your local machine and +manually install it:

    + +
      +
    1. Download the current ADT Plugin zip file from the table below (do not unpack it). + + + + + + + + + + + + + + +
      NamePackageSizeMD5 Checksum
      ADT {@adtZipVersion} + {@adtZipDownload} + {@adtZipBytes} bytes{@adtZipChecksum}
      +
      2. + + +
    2. Follow steps 1 and 2 in the default install + instructions (above).
      3. +
    3. In the Add Site dialog, click Archive.
      4. +
    4. Browse and select the downloaded zip file.
      5. +
    5. In Eclipse 3.5 only, enter a name for the local update site (e.g., + "Android Plugin") in the "Name" field.
      6. +
    6. Click OK. +
    7. Follow the remaining procedures as listed for + default installation above, + starting from step 4.
      8. +
    + +

    To update your plugin once you've installed using the zip file, you will have +to follow these steps again instead of the default update instructions.

    + +

    Other install errors

    + +

    Note that there are features of ADT that require some optional +Eclipse components (for example, WST). If you encounter an error when +installing ADT, your Eclipse installion might not include these components. +For information about how to quickly add the necessary components to your +Eclipse installation, see the troubleshooting topic +ADT +Installation Error: "requires plug-in org.eclipse.wst.sse.ui".

    + +

    For Linux users

    +

    If you encounter this error when installing the ADT Plugin for Eclipse: +

    +An error occurred during provisioning.
+Cannot connect to keystore.
+JKS
    +

    +...then your development machine lacks a suitable Java VM. Installing Sun +Java 6 will resolve this issue and you can then reinstall the ADT +Plugin.

    + + +

    Updating Your Eclipse ADT Plugin

    + +

    From time to time, a new version of the ADT Plugin becomes available. Follow +the steps below to check whether an update is available and, if so, to install it. +For +information about new features in ADT, see the ADT Plugin Notes document.

    + + + + + + + +
    Eclipse 3.4 (Ganymede)Eclipse 3.5 (Galileo)
    + +
      +
    1. Select Help > Software Updates.
      2. +
    2. Select the Available Software tab.
      3. +
    3. Select the checkboxes next to Android DDMS and Android Developer Tools, + then click Update.
      4. +
    4. In the resulting Available Updates dialog, ensure that both Android DDMS + and Android Development Tools are selected, then click + Next.
      5. +
    5. Read and accept the license agreement and then click Finish. + This will download and install the latest version of Android DDMS and + Android Development Tools.
      6. +
    6. Restart Eclipse.
      7. +
    +    		 + +
      +
    1. Select Help > Check for Updates.
      2. +
    2. In the resulting Available Updates dialog, locate the Android DDMS and + Android Development Tools features in the list and ensure that the checkboxes + next to them are selected. Click Next. +

      If the Available Updates dialog does not list Android DDMS and Android + Development tools, make sure that you have set up a remote update site + for them, as described in + Installing the ADT Plugin. +

      3. +
    3. In the Update Details dialog, click Next.
      4. +
    4. Read and accept the license agreement and then click Finish. + This will download and install the latest version of Android DDMS and + Android Development Tools.
      5. +
    5. Restart Eclipse.
      6. +
    +
    + + +

    If you encounter problems during the update of ADT, you +can try removing the existing ADT plugin and then performing a fresh +installation. Fully remove your existing ADT Plugin as described in Uninstalling the ADT Plugin, below, and then follow the guide to Installing the ADT Plugin.

    + +

    Update your Eclipse SDK Preferences

    + +

    The last step is to update your Eclipse preferences to point to the new +SDK directory:

    +
      +
    1. Select Window > Preferences to open + the Preferences panel (Mac: Eclipse > Preferences + ).
      2. +
    2. Select Android from the left panel.
      3. +
    3. For the SDK Location, click Browse + and locate your SDK directory.
      4. +
    4. Click Apply, then OK.
      5. +
    + + +

    Uninstalling the ADT plugin

    + +

    If you encounter problems when installing or updating ADT, you +can try removing the existing ADT plugin and then performing a fresh +installation. To remove ADT, follow these steps:

    + + + + + + + +
    Eclipse 3.4 (Ganymede)Eclipse 3.5 (Galileo)
    + +
      +
    1. Select Help > Software Updates > + Manage Configuration.
      2. +
    2. Expand the list in the left panel to reveal the installed tools.
      3. +
    3. Right-click "Android Editors" and click Uninstall. Click OK + to confirm.
      4. +
    4. Restart Eclipse. +

      (Do not uninstall "Android Development Tools".)

      5. +
    +    		 + +
      +
    1. Select Help > Install New Software.
      2. +
    2. In the "Details" panel, click the "What is already installed?" link.
      3. +
    3. In the Eclipse Installation Details dialog, select "Android DDMS" and "Android Development Tools" and then click Uninstall.
      4. +
    4. In the next window, confirm that the ADT features are selected for uninstall and then click Finish to uninstall.
      5. +
    5. Restart Eclipse.
      6. +
    +
    + diff --git a/docs/html/sdk/index.jd b/docs/html/sdk/index.jd index e82ed3447116f..1db075caea6b6 100644 --- a/docs/html/sdk/index.jd +++ b/docs/html/sdk/index.jd @@ -1,104 +1,80 @@ -page.title=Android 2.0 SDK, Release 1 +page.title=Android SDK sdk.redirect=0 sdk.version=2.0 - sdk.date=October 2009 -sdk.win_download=android-sdk-windows-2.0_r1.zip +sdk.win_download=android-sdk-windows_r1.zip sdk.win_bytes= sdk.win_checksum= -sdk.mac_download=android-sdk-mac_x86-2.0_r1.zip +sdk.mac_download=android-sdk-mac_x86_r1.zip sdk.mac_bytes= sdk.mac_checksum= -sdk.linux_download=android-sdk-linux_x86-2.0_r1.tgz +sdk.linux_download=android-sdk-linux_x86_r1.tgz sdk.linux_bytes= sdk.linux_checksum= -adt.zip_download=ADT-0.9.4.zip -adt.zip_version=0.9.4 -adt.zip_bytes= -adt.zip_checksum= - @jd:body -

    For more information on this SDK release, read the +

    For important information about this SDK release, please review the Release Notes.

    -

    For setup procedures, read the -Installing guide.

    +
    +

    The Android SDK has changed! If you've worked with the Android SDK before, you will notice several important differences:

    -

    SDK Contents

    + -

    Development tools

    +

    If you are currently using the Android 1.6 SDK, you do not need to install the new SDK, since your existing SDK incudes the Android SDK and AVD Manager tool. To develop against Android 2.0, for example, you could just download the updated SDK Tools (Revision 3) and the Android 2.0 platform into your existing SDK.

    +
    -

    The SDK includes a full set of tools for developing and debugging application -code and designing an application UI. You can read about the tools in the Dev Guide and access them -in the <sdk>/tools/ directory.

    +

    Quick Start

    -

    Android Platforms

    +

    The steps below provide an overview of how to get started with the Android SDK. For detailed instructions, start with the Installing guide.

    -

    This SDK includes only the Android {@sdkCurrentVersion} platform version for developing Android -applications. With this platform, both the fully compliant Android {@sdkCurrentVersion} library -and system image are provided. For more information about this platform version — -features, applications included, localizations, API changes, and so on — -see the Android {@sdkCurrentVersion} -Version Notes.

    +

    0. Prepare your development computer

    -

    Although only one platform version is included in the SDK, you do not need to -install a separate Android SDK for each platform version on which would like to develop -applications. Once you install the SDK from this page, you can easily install -additional Android platform versions using the Android SDK and AVD Manager. -For more information about adding platform versions to your SDK, -read Updating Your SDK.

    +

    Read the System Requirements document and make sure that your development computer meets the hardware and software requirements for the Android SDK. Install any additional software needed before downloading the Android SDK. In particular, if you plan to develop Android applications in the Eclipse IDE using the ADT Plugin (see below), make sure that you have the correct version of Eclipse installed. + +

    1. Download and install the SDK starter package

    + +

    Select a starter package from the table at the top of this page and download it to your development computer. To install the SDK, simply unpack the starter package to a safe location and then add the location to your PATH.

    + +

    2. Install the ADT Plugin for Eclipse

    + +

    If you are developing in Eclipse, set up a remote update site and install the Android Development Tools (ADT) plugin. The ADT plugin adds powerful extensions to the Eclipse IDE that help you to create and debug Android applications more easily and faster. If you use Eclipse, ADT gives you an incredible boost in developing Android +applications.

    + +

    For detailed instructions, see Installing and Updating ADT.

    + +

    3. Download one or more Android platforms

    + +

    To develop an application, you need to download at least one Android platform component and install it into your SDK. + +

    Each downloadable platform includes an Android library and system image, as well as emulator skins, sample code and applications, and more. In most cases, you will want to download multiple platforms into your SDK, so that you can build your application on the minimum version you want to support, but test it against higher versions that you intend the application to run on.

    + +

    While you are downloading platforms, make sure to download the latest documentation package. The documentation covers all versions of the API and lets you filter out those versions that your application won't support.

    + +

    To download platforms or any other SDK component, use the Android SDK and AVD Manager tool, included in the SDK starter package. For more information, see Adding SDK Components. Detailed information about individual platforms and other components are provided in the navigation bar at left, under "Downloadable SDK Components."

    -

    SDK Add-Ons

    + +

    4. Download other SDK components

    + +

    In addition to Android platforms, you can also download SDK add-ons and a local version of the Android developer documentation to your SDK environment.

    An SDK add-on provides a development environment for an Android external -library or a customized (but fully compliant) Android system image. This SDK -includes the SDK add-ons listed below. The Android system API Level required by -each add-on is noted.

    +library or a customized (but fully compliant) Android system image. You can install an add-on if you want to make use of its external library in your application. For example, the Google APIs Add-On lets you develop an application that takes advantage of the Google Maps external library.

    - - - - - - - - - - - -
    Add-OnAPI LevelNotesDescription
    Google APIs5 Includes the com.google.android.maps external library, a compliant -Android 2.0 system image, a {@link android.location.Geocoder Geocoder} -backend service implementation, documentation, and sample code.
    +

    Use the Android SDK and AVD Manager tool to download add-ons and other components into your SDK.

    +

    5. Get started with an application project

    -

    Sample Code and Applications

    - -

    You can look at a variety of sample applications in the Dev Guide and access the sample -code itself in the <sdk>/platforms/<platform>/samples/ -directory of the SDK package. Note that each platform version includes its own set of -sample applications.

    - - -

    Documentation

    - -

    The SDK package includes a full set of local documentation. To view it, open -the <sdk>/documentation.html file in a web browser. If you -are developing in an IDE such as Eclipse, you can also view the reference -documentation directly in the IDE by hovering over methods and class names.

    - -

    The most current documentation is always available on the Android Developers -site:

    - -

    http://developer.android.com/ -

    - +

    Once you've set up your SDK, the next step is to start a new application project or move existing applications into the new SDK.

    +

    If you are new to Android, you can use the Hello World tutorial to get started quickly. Welcome!

    \ No newline at end of file diff --git a/docs/html/sdk/2.0_r1/installing.jd b/docs/html/sdk/installing.jd similarity index 51% rename from docs/html/sdk/2.0_r1/installing.jd rename to docs/html/sdk/installing.jd index fd269dc624125..e4fbfa0e84084 100644 --- a/docs/html/sdk/2.0_r1/installing.jd +++ b/docs/html/sdk/installing.jd @@ -1,4 +1,4 @@ -page.title=Installing the Android 2.0 SDK +page.title=Installing the Android SDK sdk.preview=0 @jd:body @@ -11,10 +11,16 @@ sdk.preview=0
  • Prepare for Installation
  • Install the SDK
  • Install the ADT Plugin for Eclipse
    • +
  • Add Platforms and Other SDK Components
  • SDK Contents
  • Next Steps
    • -
  • Installation Notes
    • -
  • Troubleshooting ADT Installation
    • +
  • Troubleshooting
    • + + +

    See also

    +
      +
    1. Installing ADT
      2. +
    2. Adding SDK Components
    @@ -28,10 +34,16 @@ development environment for the first time.

    this page.

    Updating?

    -

    If you have already installed an earlier version -of the Android SDK, please instead read Updating Your SDK. -

    +

    If you are currently using the Android 1.6 SDK, you do not necessarily need +to install the new SDK, since your existing SDK incudes the Android SDK and AVD +Manager tool. To develop against the new Android 2.0 platform, for example, you +could just download the updated SDK Tools (Revision 3) and the Android 2.0 +platform into your existing SDK.

    + +

    If you are using Android 1.5 SDK or older, you should install the new SDK as +described in this document and move your application projects to the new +environment.

    Prepare for Installation

    @@ -47,23 +59,28 @@ to install Eclipse, you can download it from this location:

    http://www.eclipse.org/downloads/

    -

    A Java or RCP version of Eclipse is recommended.

    +

    A Java or RCP version of Eclipse is recommended. For Eclipse 3.5, the +"Eclipse Classic" version is recommended.

    -

    Install the SDK

    +

    Download and Install the SDK

    -

    After downloading the Android SDK, unpack the Android SDK .zip archive -to a suitable location on your machine. By default, the SDK files are unpacked -into a directory named android_sdk_<platform>_<release>.

    +

    Download the SDK package that is appropriate for your development computer. +Unpack the Android SDK .zip archive to a suitable location on your machine. By +default, the SDK files are unpacked into a directory named +android_sdk.

    -

    Make a note of the name and location of the unpacked SDK directory on your system — you -will need to refer to the SDK directory later, when setting up the Android plugin or when -using the SDK tools.

    +

    Make a note of the name and location of the unpacked SDK directory on your +system — you will need to refer to the SDK directory later, when setting +up the ADT plugin or when using the SDK tools.

    + +

    Optionally, you may want to add the location of the SDK's primary +tools directory to your system PATH. The primary +tools/ directory is located at the root of the SDK folder. Adding +tools to your path lets you run Android Debug Bridge (adb) and the +other command line tools without needing to +supply the full path to the tools directory.

    -

    Optionally, you may want to add the location of the SDK's primary tools directory -to your system PATH. The primary tools/ directory is located at the root of the -SDK folder. Adding tools to your path lets you run Android Debug Bridge (adb) and -the other command line tools without -needing to supply the full path to the tools directory.

    - - -

    Troubleshooting ADT Installation

    - -

    If you are having trouble downloading the ADT plugin after following the -steps above, here are some suggestions:

    - - - -

    If you are still unable to use Eclipse to download the ADT plugin as a -remote update site, you can download the ADT zip file to your local machine and -manually install it:

    - -
      -
    1. Download the - ADT Plugin zip file (do not unpack it).
      2. -
    2. Follow steps 1 and 2 in the default install - instructions (above).
      3. -
    3. In the Add Site dialog, click Archive.
      4. -
    4. Browse and select the downloaded zip file.
      5. -
    5. In Eclipse 3.5 only, enter a name for the local update site (e.g., - "Android Plugin") in the "Name" field.
      6. -
    6. Click OK. -
    7. Follow the remaining procedures as listed for - default installation above, - starting from step 4.
      8. -
    - -

    To update your plugin once you've installed using the zip file, you will have -to follow these steps again instead of the default update instructions.

    - -

    Other install errors

    - -

    Note that there are features of ADT that require some optional -Eclipse components (for example, WST). If you encounter an error when -installing ADT, your Eclipse installion might not include these components. -For information about how to quickly add the necessary components to your -Eclipse installation, see the troubleshooting topic -ADT -Installation Error: "requires plug-in org.eclipse.wst.sse.ui".

    - -

    For Linux users

    -

    If you encounter this error when installing the ADT Plugin for Eclipse: -

    -An error occurred during provisioning.
-Cannot connect to keystore.
-JKS
    -

    -...then your development machine lacks a suitable Java VM. Installing Sun -Java 6 will resolve this issue and you can then reinstall the ADT -Plugin.

    - - + \ No newline at end of file diff --git a/docs/html/sdk/older_releases.jd b/docs/html/sdk/older_releases.jd index febccd04d0465..0ecee3c14ef7e 100644 --- a/docs/html/sdk/older_releases.jd +++ b/docs/html/sdk/older_releases.jd @@ -7,7 +7,7 @@ released before Android 1.0. The list is provided for informational purposes only.

    If you are just getting started developing on Android, make sure that you -are using the most current SDK available, +are using the most current SDK available, to ensure that your applications will be compatible with the latest Android-powered devices.

    diff --git a/docs/html/sdk/sdk_toc.cs b/docs/html/sdk/sdk_toc.cs index b75fe9b987482..8b55aad1baf53 100644 --- a/docs/html/sdk/sdk_toc.cs +++ b/docs/html/sdk/sdk_toc.cs @@ -1,9 +1,9 @@ -