diff --git a/Android.mk b/Android.mk index 4c135daf0c2a9..0fe11645fd191 100644 --- a/Android.mk +++ b/Android.mk @@ -449,12 +449,12 @@ web_docs_sample_code_flags := \ framework_docs_SDK_VERSION:=2.3 # release version (ie "Release x") (full releases only) framework_docs_SDK_REL_ID:=1 - # flag to build offline docs for a preview release -framework_docs_SDK_PREVIEW:=0 framework_docs_LOCAL_DROIDDOC_OPTIONS += \ -hdf sdk.version $(framework_docs_SDK_VERSION) \ - -hdf sdk.rel.id $(framework_docs_SDK_REL_ID) + -hdf sdk.rel.id $(framework_docs_SDK_REL_ID) \ + -hdf sdk.preview true \ + -hdf sdk.preview.version Honeycomb # ==== the api stubs and current.xml =========================== include $(CLEAR_VARS) @@ -540,9 +540,6 @@ LOCAL_DROIDDOC_OPTIONS:=\ -sdkvalues $(OUT_DOCS) \ -hdf android.whichdoc offline -ifeq ($(framework_docs_SDK_PREVIEW),true) - LOCAL_DROIDDOC_OPTIONS += -hdf sdk.preview true -endif LOCAL_DROIDDOC_CUSTOM_TEMPLATE_DIR:=build/tools/droiddoc/templates-sdk diff --git a/docs/html/images/preview_hc/actionbar.png b/docs/html/images/preview_hc/actionbar.png new file mode 100644 index 0000000000000..31df2b206aa4f Binary files /dev/null and b/docs/html/images/preview_hc/actionbar.png differ diff --git a/docs/html/images/preview_hc/fragments_layout.png b/docs/html/images/preview_hc/fragments_layout.png new file mode 100644 index 0000000000000..91c892956faee Binary files /dev/null and b/docs/html/images/preview_hc/fragments_layout.png differ diff --git a/docs/html/sdk/index.jd b/docs/html/sdk/index.jd index 8b77303ecf4fb..4153951f68c93 100644 --- a/docs/html/sdk/index.jd +++ b/docs/html/sdk/index.jd @@ -19,6 +19,7 @@ sdk.linux_checksum=TODO @jd:body +

Here's an overview of the steps you must follow to set up the Android SDK:

    @@ -32,3 +33,4 @@ installer for help with the initial setup.)

    To get started, download the appropriate package from the table above, then read the guide to Installing the SDK.

    +
diff --git a/docs/html/sdk/preview/features.jd b/docs/html/sdk/preview/features.jd index 81b4ff63cb1f9..55d0f8d1c972d 100644 --- a/docs/html/sdk/preview/features.jd +++ b/docs/html/sdk/preview/features.jd @@ -1,4 +1,185 @@ -sdk.redirect=true - +page.title=Introduction to Honeycomb @jd:body +

Welcome to the Honeycomb preview SDK. Honeycomb is the next major release of the Android +platform and is optimized for tablet devices. This document provides an introduction to the new +platform features and APIs available in Honeycomb.

+ + +

Fragments

+ +
+ +

Fragment Layout. An activity with two +fragments: one with a list view, on the left, and one that displays selected content on the +right. This demo is available in the samples package.

+
+ + +

A new framework component that allows you to separate distinct elements of an activity into +self-contained modules that define their own UI and lifecycle—defining what may be +considered "sub-activities".

+ + +

For more information, see the Fragments developer guide.

+ + +

Action Bar

+ +

A replacement for the traditional title bar, which provides users quick access to global +actions and different navigation modes.

+ + + +

Action Bar. An action bar with a custom logo, +tabs, and Options Menu. This demo is available in the samples package.

+ +

For more information, see the Action Bar developer guide.

+ + +

System Clipboard

+ +

Applications can copy and paste data (beyond mere text) to and from the system-wide +clipboard.

+ + + +

See {@link android.content.ClipData} and {@link android.content.ClipboardManager} +for more information. You can also see an example implementation of copy/paste in an updated +version of the NotePad application (available in the samples package).

+ + +

Drag and Drop

+ +

New APIs to perform drag and drop operations, leveraging the system clipboard APIs to +transport data.

+ + + +

See {@link android.view.DragEvent} and {@link android.view.View.OnDragListener} for more +information.

+ + +

New Animations

+ +

An all new animation framework.

+ + + +

See the {@link android.animation} package.

+ + +

Extended App Widgets

+ +

App widgets can now be more interactive and accept finger gestures.

+ + + + +

Extended Status Bar Notifications

+ +

The {@link android.app.Notification} class has been extended to support more content-rich +status bar notifications when on xlarge screens.

+ + + + +

Plus Android 2.3

+ +

Honeycomb includes all platform changes introduced for Android 2.3.

+ +

To take full advantage of Honeycomb, you should also be aware of the new features +and APIs introduced for Android 2.3. To learn more, read the Android 2.3 release notes.

+ +
+

To set up your preview SDK and start developing apps for Honeycomb, see the Getting Started guide.

+
+ + + + + + + + + + + + + + + + + + + diff --git a/docs/html/sdk/preview/installing.jd b/docs/html/sdk/preview/installing.jd index 1e6b26b9077ab..c835c49cac1a3 100644 --- a/docs/html/sdk/preview/installing.jd +++ b/docs/html/sdk/preview/installing.jd @@ -1,5 +1,62 @@ -sdk.redirect=true - +page.title=Getting Started with Honeycomb @jd:body +

First, you need to set up your development environment with the new SDK Tools and preview +platform:

+
    +
  1. Unpack the SDK Tools r8 package you've received. +

    If you have an existing Android SDK directory, simply replace your existing {@code +tools/} directory with the one from the new package and add the {@code platform-tools/} +directory along side it (at the root of the SDK directory).

    2. +
  2. Unpack the platform package ({@code android-Froyo}) and place it in your SDK's {@code +platforms/} directory.
    3. +
  3. If you're using Eclipse, also update your Eclipse plugin using the provided archive file. +
      +
    1. Select Help > Install new software.
      2. +
    2. Click Add.
      3. +
    3. Click Archive.
      4. +
    4. Locate and select the archive file. Click OK. +

      Developer Tools now appear in the Available Software window and you can proceed +to install the plugin.

      +
      5. +
    +
    4. +
+ +

Note: Beginning with SDK Tools r8 (the version you've received), +the {@code adb} tool is now located in the {@code <sdk>/platform-tools/} directory (instead +of in {@code <sdk>/tools/}). Be sure to update your {@code PATH} environment variable and any +build/debugging scripts you have.

+ + + +

Set Up Your AVD and Application

+ +

With your SDK now set up, follow these steps to start developing an application for +Honeycomb.

+ +
    + +
  1. Create a new AVD targeted to "Android Froyo (Preview)" and with a custom skin resolution of +1280 x 800.
    2. + +
  2. Set the build target of your application to "Android Froyo (Preview)".
    3. +
  3. Set your manifest file's {@code <uses-sdk>} element to use {@code +android:minSdkVersion="Froyo"}. For example: +
    +<manifest>
+    <uses-sdk android:minSdkVersion="Froyo" />
+    ...
+</manifest>
+
    +

    "Froyo" is a provisional API Level for the Honeycomb release, used only during the preview +period. When the APIs are +finalized and the SDK is released publicly, you must update this with the appropriate API Level +integer.

    +

    Note: By providing your {@code <uses-sdk>} element in the +manifest file before the {@code <application>} element, your application will +automatically apply the new Holographic theme.

    +
    4. + +
diff --git a/docs/html/sdk/sdk_toc.cs b/docs/html/sdk/sdk_toc.cs index 057d9e0f2dec5..0b74bd6d26b24 100644 --- a/docs/html/sdk/sdk_toc.cs +++ b/docs/html/sdk/sdk_toc.cs @@ -37,6 +37,17 @@ + +

  • Android Preview SDK

    • + +

  • Downloadable SDK Components